Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 71 day(s) ago
  • 2999 daily downloads
  • 1369582 total downloads
  • Latest version: 2.5.4

Phobos.Actor 2.0.3-beta1

Automatic Akka.NET tracing and monitoring integration as part of the Phobos Enterprise Framework.

Install-Package Phobos.Actor -Version 2.0.3-beta1
dotnet add package Phobos.Actor --version 2.0.3-beta1
<PackageReference Include="Phobos.Actor" Version="2.0.3-beta1"/>
paket add Phobos.Actor --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
7121
71 day(s) ago
734
81 day(s) ago
95
87 day(s) ago
12013
170 day(s) ago
5779
206 day(s) ago
2142
240 day(s) ago
591
275 day(s) ago
3398
282 day(s) ago
80
330 day(s) ago
5462
353 day(s) ago
10814
413 day(s) ago
360
416 day(s) ago
8039
471 day(s) ago
6789
497 day(s) ago
758
500 day(s) ago
4082
500 day(s) ago
44
505 day(s) ago
1830
554 day(s) ago
4
555 day(s) ago
1777
599 day(s) ago
257
687 day(s) ago
144
760 day(s) ago
63477
819 day(s) ago
77
823 day(s) ago
42
827 day(s) ago
55
834 day(s) ago
16
848 day(s) ago
4203
871 day(s) ago
148
877 day(s) ago
54
878 day(s) ago
13583
878 day(s) ago
7
878 day(s) ago
439
904 day(s) ago
4
904 day(s) ago
12298
913 day(s) ago
456
947 day(s) ago
15
948 day(s) ago
2010
948 day(s) ago
101
954 day(s) ago
57
961 day(s) ago
6955
977 day(s) ago
444
990 day(s) ago
499
1002 day(s) ago
7133
1023 day(s) ago
1173
1059 day(s) ago
709
1061 day(s) ago
3259
1094 day(s) ago
2319
1115 day(s) ago
683
1123 day(s) ago
1810
1177 day(s) ago
1455
1193 day(s) ago
248
1199 day(s) ago
3407
1219 day(s) ago
5798
1263 day(s) ago
11056
1320 day(s) ago
99
1324 day(s) ago
88
1324 day(s) ago
88
1324 day(s) ago
88
1324 day(s) ago
561
1354 day(s) ago
212
1369 day(s) ago
1609
1390 day(s) ago
844
1425 day(s) ago
1252
1437 day(s) ago
80
1437 day(s) ago

Info

Statistics

  • 221224 total downloads
  • 16 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge