Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 34 day(s) ago
  • 4108 daily downloads
  • 1791456 total downloads
  • Latest version: 2.8.3

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
1708
34 day(s) ago
1965
68 day(s) ago
331
69 day(s) ago
1206
76 day(s) ago
714
83 day(s) ago
1126
102 day(s) ago
133
109 day(s) ago
1137
117 day(s) ago
47925
278 day(s) ago
790
288 day(s) ago
585
294 day(s) ago
15025
377 day(s) ago
4118
413 day(s) ago
2110
447 day(s) ago
307
482 day(s) ago
759
489 day(s) ago
5
537 day(s) ago
1191
560 day(s) ago
7140
620 day(s) ago
351
623 day(s) ago
6033
678 day(s) ago
2685
704 day(s) ago
721
707 day(s) ago
27
707 day(s) ago
3
712 day(s) ago
1127
761 day(s) ago
1
762 day(s) ago
553
806 day(s) ago
192
894 day(s) ago
2
967 day(s) ago
52771
1026 day(s) ago
37
1030 day(s) ago
20
1034 day(s) ago
24
1041 day(s) ago
2
1055 day(s) ago
182
1078 day(s) ago
120
1084 day(s) ago
12
1085 day(s) ago
135
1085 day(s) ago
1
1085 day(s) ago

Info

Statistics

  • 153274 total downloads
  • 2 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge