Phobos
Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 10 day(s) ago
  • 3502 daily downloads
  • 560205 total downloads
  • Latest version: 2.1.0-beta2

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
145
10 day(s) ago
254
98 day(s) ago
141
172 day(s) ago
13851
230 day(s) ago
71
234 day(s) ago
36
238 day(s) ago
50
245 day(s) ago
13
259 day(s) ago
2286
282 day(s) ago
142
288 day(s) ago
46
289 day(s) ago
9044
289 day(s) ago
2
289 day(s) ago
436
315 day(s) ago
1
315 day(s) ago
5686
324 day(s) ago
453
359 day(s) ago
12
359 day(s) ago
1988
359 day(s) ago
98
365 day(s) ago
51
372 day(s) ago
6920
388 day(s) ago
437
401 day(s) ago
415
413 day(s) ago
7113
434 day(s) ago
1168
470 day(s) ago
704
472 day(s) ago
3248
505 day(s) ago
2266
527 day(s) ago
678
534 day(s) ago
1395
588 day(s) ago
1448
604 day(s) ago
243
610 day(s) ago
3402
630 day(s) ago
5790
674 day(s) ago
11024
731 day(s) ago
92
735 day(s) ago
83
735 day(s) ago
83
735 day(s) ago
83
735 day(s) ago
556
765 day(s) ago
207
780 day(s) ago
1603
801 day(s) ago
838
836 day(s) ago
1245
848 day(s) ago
73
848 day(s) ago

Info

Statistics

  • 85920 total downloads
  • 13 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge