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

Phobos.Hosting 2.0.3-beta1

Akka.Hosting prototype support for Phobos.

Install-Package Phobos.Hosting -Version 2.0.3-beta1
dotnet add package Phobos.Hosting --version 2.0.3-beta1
<PackageReference Include="Phobos.Hosting" Version="2.0.3-beta1"/>
paket add Phobos.Hosting --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
262
14 day(s) ago
2718
61 day(s) ago
2164
95 day(s) ago
393
96 day(s) ago
1314
103 day(s) ago
748
110 day(s) ago
1160
129 day(s) ago
166
136 day(s) ago
1171
144 day(s) ago
51481
305 day(s) ago
803
315 day(s) ago
610
322 day(s) ago
15393
404 day(s) ago
4254
440 day(s) ago
2123
474 day(s) ago
320
509 day(s) ago
779
516 day(s) ago
18
565 day(s) ago
1204
587 day(s) ago
7160
648 day(s) ago
364
650 day(s) ago
6046
706 day(s) ago
2698
731 day(s) ago
734
734 day(s) ago
40
734 day(s) ago
16
740 day(s) ago
1140
788 day(s) ago
1
789 day(s) ago
566
833 day(s) ago
192
921 day(s) ago
2
995 day(s) ago
52785
1053 day(s) ago
50
1057 day(s) ago
33
1061 day(s) ago
37
1069 day(s) ago
2
1082 day(s) ago
195
1105 day(s) ago
133
1111 day(s) ago
25
1112 day(s) ago
149
1112 day(s) ago
1
1112 day(s) ago

Info

Statistics

  • 159450 total downloads
  • 2 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge