Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 2 day(s) ago
  • 1726 daily downloads
  • 1918593 total downloads
  • Latest version: 2.8.5

Phobos.Tracing 2.0.3-beta1

Distributed tracing support for Akka.NET ActorSystems.

Install-Package Phobos.Tracing -Version 2.0.3-beta1
dotnet add package Phobos.Tracing --version 2.0.3-beta1
<PackageReference Include="Phobos.Tracing" Version="2.0.3-beta1"/>
paket add Phobos.Tracing --version 2.0.3-beta1

Release Notes

Phobos 2.x BETA Release** This is a BETA release of a new propsoed feature for Phobos 2.0 - "macro" tracing: the ability to disable automatic `akka.msg.recv` span creation but still receive the `SpanContext` from incoming messages and still propagate `SpanContext` to other actors via `TelemetrySpan` / `System.Diagnostic.Activity` instances you create yourself. Disabling Automatic Span Creation** You can disable automatic span creation for the entire `ActorSystem` via the following HOCON: ```hocon phobos.tracing.create-trace-upon-receive = off ``` We don't recommend doing this** as it's a potentially destructive action. Instead, it's better to disable automatic span creation in areas where you _know_ the system is busy. ```hocon akka.actor.deployment{ /manual1{ phobos.tracing.create-trace-upon-receive = off phobos.tracing.propagate-settings-to-children = on } } ``` This will allow you to disable automatic span creation for the entire hierarchy of actors beneath `/user/manual1`. You can also accomplish the same thing via C# or F# via the `Props` extension methods introduced by Phobos: ```csharp var myManualSpanActor = Sys.ActorOf(Props.Create(() => new ManualTraceCreator()) .WithInstrumentation( PhobosSettings.For(Sys).DefaultUserActorSettings .WithCreateTraceUponReceive(false) .WithPropagateToChildren(true)), "manual2"); ``` This will work identically to the HOCON above. When these settings are enabled, the affected actors will still have tracing enabled and will propagate any active trace data to other actors via `IActorRef.Tell` but _will not automatically create any additional `akka.msg.recv` spans on their own any longer_. Manually Creating Spans** So in order to create useful traces inside these areas, you can now access the `IPhobosActorContext.UsableContext` property - which contains a `SpanContext?` that can be used in the manual creation of OpenTelemetry spans: ```csharp public ManualTraceCreator() { Receive<GetActiveSpan>(_ => { // should be default(TelemetrySpan) when running with // phobos.tracing.create-trace-upon-receive = off Sender.Tell(new SpanResponse(Context.GetInstrumentation().ActiveSpan)); }); Receive<MyMsg>(m => { using (var mySpan = Context.GetInstrumentation().Tracer.StartActiveSpan("MyMsg", SpanKind.Consumer, Context.GetInstrumentation().UsableContext ?? default)) { _logging.Info("My event"); Sender.Tell(new MyReply("reply")); } }); } ``` This will allow the Phobos user full control over what appears in their spans and which actors / messages can produce spans. Span propagation still works automatically inside Phobos with automatic span creation disabled - but now you're responsible for creating your own spans. This should significantly reduce the amount of noise produced by the tracing system - we're going to experiment using this feature inside our [planned Akka.Streams support](https://github.com/petabridge/phobos-issues/issues/42).

Dependencies

.NETStandard

Versions

Version
Downloads
Last Updated
9
2 day(s) ago
1586
48 day(s) ago
4483
95 day(s) ago
2291
129 day(s) ago
684
130 day(s) ago
1436
137 day(s) ago
818
144 day(s) ago
1252
163 day(s) ago
193
170 day(s) ago
1217
178 day(s) ago
56840
339 day(s) ago
787
349 day(s) ago
647
355 day(s) ago
16382
438 day(s) ago
9357
474 day(s) ago
2559
508 day(s) ago
643
543 day(s) ago
5971
550 day(s) ago
147
598 day(s) ago
6889
621 day(s) ago
11478
681 day(s) ago
406
684 day(s) ago
8252
739 day(s) ago
8889
765 day(s) ago
863
768 day(s) ago
4261
768 day(s) ago
146
773 day(s) ago
1884
822 day(s) ago
3
823 day(s) ago
1827
867 day(s) ago
257
955 day(s) ago
143
1028 day(s) ago
65497
1087 day(s) ago
124
1091 day(s) ago
91
1095 day(s) ago
105
1102 day(s) ago
14
1116 day(s) ago
4253
1139 day(s) ago
197
1145 day(s) ago
87
1146 day(s) ago
13647
1146 day(s) ago
57
1146 day(s) ago
438
1172 day(s) ago
3
1172 day(s) ago
12439
1181 day(s) ago
455
1215 day(s) ago
14
1216 day(s) ago
2060
1216 day(s) ago
100
1222 day(s) ago
107
1229 day(s) ago
7008
1245 day(s) ago
492
1258 day(s) ago
549
1270 day(s) ago
7176
1291 day(s) ago
1217
1327 day(s) ago
752
1329 day(s) ago
3301
1362 day(s) ago
2369
1383 day(s) ago
732
1391 day(s) ago
2019
1445 day(s) ago
1508
1461 day(s) ago
294
1467 day(s) ago
3453
1487 day(s) ago
5846
1531 day(s) ago
11105
1588 day(s) ago
161
1592 day(s) ago
138
1592 day(s) ago
36182
1592 day(s) ago
608
1622 day(s) ago
259
1637 day(s) ago
1658
1658 day(s) ago
903
1693 day(s) ago
1284
1705 day(s) ago
140
1705 day(s) ago

Info

Statistics

  • 341442 total downloads
  • 14 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge