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

Phobos.Monitoring 2.0.3-beta1

High-performance monitoring and instrumentation library for .NET and .NET Core applications.

Install-Package Phobos.Monitoring -Version 2.0.3-beta1
dotnet add package Phobos.Monitoring --version 2.0.3-beta1
<PackageReference Include="Phobos.Monitoring" Version="2.0.3-beta1"/>
paket add Phobos.Monitoring --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
147
10 day(s) ago
255
98 day(s) ago
141
172 day(s) ago
13847
230 day(s) ago
69
234 day(s) ago
36
238 day(s) ago
51
245 day(s) ago
13
259 day(s) ago
2285
282 day(s) ago
141
288 day(s) ago
15
289 day(s) ago
9044
289 day(s) ago
2
289 day(s) ago
436
315 day(s) ago
1
315 day(s) ago
5684
324 day(s) ago
453
359 day(s) ago
12
359 day(s) ago
1989
359 day(s) ago
98
365 day(s) ago
51
372 day(s) ago
6925
388 day(s) ago
438
401 day(s) ago
413
413 day(s) ago
7116
434 day(s) ago
1164
471 day(s) ago
703
472 day(s) ago
3234
505 day(s) ago
2265
527 day(s) ago
677
535 day(s) ago
1395
588 day(s) ago
1448
604 day(s) ago
241
610 day(s) ago
3399
630 day(s) ago
5782
674 day(s) ago
11021
731 day(s) ago
91
735 day(s) ago
84
735 day(s) ago
24083
735 day(s) ago
554
765 day(s) ago
207
780 day(s) ago
1606
801 day(s) ago
850
836 day(s) ago
1233
848 day(s) ago
87
848 day(s) ago

Info

Statistics

  • 109786 total downloads
  • 13 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge