Phobos
Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 14 day(s) ago
  • 2477 daily downloads
  • 740917 total downloads
  • Latest version: 2.3.1

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
154
14 day(s) ago
846
39 day(s) ago
37
42 day(s) ago
726
42 day(s) ago
36
47 day(s) ago
981
96 day(s) ago
1
97 day(s) ago
1088
141 day(s) ago
254
229 day(s) ago
141
303 day(s) ago
32169
361 day(s) ago
71
365 day(s) ago
36
369 day(s) ago
50
377 day(s) ago
13
390 day(s) ago
3569
413 day(s) ago
142
419 day(s) ago
48
420 day(s) ago
12746
420 day(s) ago
2
420 day(s) ago
436
446 day(s) ago
1
446 day(s) ago
8043
455 day(s) ago
453
490 day(s) ago
12
490 day(s) ago
2001
490 day(s) ago
98
496 day(s) ago
51
504 day(s) ago
6925
519 day(s) ago
437
533 day(s) ago
493
544 day(s) ago
7128
565 day(s) ago
1168
602 day(s) ago
704
603 day(s) ago
3253
636 day(s) ago
2310
658 day(s) ago
678
666 day(s) ago
1544
719 day(s) ago
1448
735 day(s) ago
243
741 day(s) ago
3402
761 day(s) ago
5792
805 day(s) ago
11051
862 day(s) ago
92
866 day(s) ago
83
866 day(s) ago
83
866 day(s) ago
83
866 day(s) ago
556
896 day(s) ago
207
911 day(s) ago
1603
932 day(s) ago
838
967 day(s) ago
1245
979 day(s) ago
73
979 day(s) ago

Info

Statistics

  • 115644 total downloads
  • 13 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge