Phobos
Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 12 day(s) ago
  • 1348 daily downloads
  • 899232 total downloads
  • Latest version: 2.4.2

Phobos.Actor 2.1.0

Automatic Akka.NET tracing and monitoring integration as part of the Phobos Enterprise Framework.

Install-Package Phobos.Actor -Version 2.1.0
dotnet add package Phobos.Actor --version 2.1.0
<PackageReference Include="Phobos.Actor" Version="2.1.0"/>
paket add Phobos.Actor --version 2.1.0

Release Notes

Phobos 2.1 Minor Release** Phobos 2.1 is a minor release that has been in the works for a long time and introduces several major features and improvements to the existing Phobos 2.0 experience. Akka.Cluster.Sharding Metrics and Dashboards** Issue: https://github.com/petabridge/phobos-issues/issues/72 One of the things we added support for in Phobos 2.1 is automatically tracking Akka.Cluster.Sharding metrics for each `ShardRegion` for each node capable of hosting any shards - these numbers can be aggregated together to form a complete picture of total shard allocation by type and node throughout your cluster. The new built-in metrics are: `akka.cluster.sharding.shards` - keeps track of the number of shards per node per entity type. `akka.cluster.sharding.entities` - keeps track of the number of entities per node per entity type. More Accurate "Live Actor" Counts** Phobos 2.1 takes advantage of a new actor telemetry feature introduced in [Akka.NET v1.4.47](https://github.com/akkadotnet/akka.net/releases/tag/1.4.47), whihc allows us to use an OpenTelemetry `ObservableGauge` to accurately track the total number of live actors by type and node throughout each of your `ActorSystem`s. > [!IMPORTANT] > In order to use this feature, you will need to set `akka.actor.telemetry.enabled = on` (it's `off` by default.) > > If you use Phobos.Hosting to configure Phobos, this setting will be automatically enabled for you. This value is now tracked via the `akka.actor.live` metric and will show up alongside the normal `akka.actor.created|stopped|restarted` counters. We've already incorporated `akka.actor.live` into our Phobos dashboards. Updated All Phobos Dashboards** We've incorporated all Phobos dashboards to incorporate the following new metric types: `akka.cluster.sharding.shards` - keeps track of the number of shards per node per entity type. `akka.cluster.sharding.entities` - keeps track of the number of entities per node per entity type. `akka.actor.live` - keeps more accurate track of the number of live actors per node by type. Please see "[Phobos Dashboards](https://phobos.petabridge.com/articles/dashboards/index.html)" for the most recent versions of each of these. Akka.Cluster.Sharding Trace Compression** One of the largest feature areas we've worked on for Phobos 2.1 is curtailing the amount of noise produced by Phobos tracing, especially in regards to features like Akka.Cluster.Sharding - where each message to one of your actors produces 2-3 spans recorded by built-in system actors. For starters, we now have the ability to compress Cluster.Sharding traces via an [OpenTelemetry `BaseProcessor<Activity>`](https://github.com/open-telemetry/opentelemetry-dotnet/blob/main/docs/trace/extending-the-sdk/README.md#processor) - and this can be enabled when you're subscribing to Phobos telemetry in your OTel pipeline: ```csharp services.AddOpenTelemetryTracing(builder => { builder .SetResourceBuilder(resource) .AddPhobosInstrumentation(compressShardTraces:true) // eliminate sharding infrastructure from traces .AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation(options => { options.Filter = context => !context. Request.Path.StartsWithSegments("/metrics"); }) .SetSampler(new TraceIdRatioBasedSampler(1.0d)) .AddJaegerExporter(opt => { opt.AgentHost = Environment.GetEnvironmentVariable(JaegerAgentHostEnvironmentVar) ?? "localhost"; }); }); ``` Calling `.AddPhobosInstrumentation(compressShardTraces:true)` will enable trace compression for sharding. This value is set to `false` by default. In addition to these changes, we've also filtered out all internal messages and Akka.DistributedData messages by default. `Ask<T>` Tracing Improvements** We've made many significant improvements to `Ask<T>` tracing in Phobos 2.1: `Ask<T>` tracing can now be disabled via the fluent C# APIs or via `phobos.tracing.trace-ask = off`; `Ask<T>` tracing can now be filtered using the same `ITraceFilter` and other filter rules as regular `akka.actor.recv` statements; `Ask<T>` tracing has been restructured such that we now accurately capture both the input and output types separately - additionally, we are much more accurate in tracking start and stop times than we were previously. [Fixed: `Ask<T>` tracing does not properly follow `Tracer.ActiveSpan`](https://github.com/petabridge/phobos-issues/issues/74) To disable `Ask<T>` tracing via Phobos.Hosting, use the following: ```csharp collection.AddAkka("LocalSys", (builder, sp) => { builder.WithPhobos(AkkaRunMode.Local, configBuilder => configBuilder.WithTracing(t => t.SetTraceAsk(false))); AddTestActors(builder); }); ``` Other General Improvements** [Fixed: Phobos `DeadLetter` logging](https://github.com/petabridge/phobos-issues/issues/73). [Fixed: `Tracer.CurrentSpan` and `PhobosActorContext.ActiveSpan` should be the same when actor is processing message, but currently are not](https://github.com/petabridge/phobos-issues/issues/71). All `IWithTimers` messages are filtered out by default.

Dependencies

.NETStandard

Versions

Version
Downloads
Last Updated
81
12 day(s) ago
2894
72 day(s) ago
276
75 day(s) ago
2093
130 day(s) ago
2764
156 day(s) ago
215
159 day(s) ago
2019
159 day(s) ago
38
164 day(s) ago
1409
212 day(s) ago
1
214 day(s) ago
1328
257 day(s) ago
254
346 day(s) ago
141
419 day(s) ago
44745
478 day(s) ago
71
482 day(s) ago
36
486 day(s) ago
50
493 day(s) ago
13
506 day(s) ago
4188
530 day(s) ago
142
536 day(s) ago
48
537 day(s) ago
13546
537 day(s) ago
2
537 day(s) ago
436
562 day(s) ago
1
562 day(s) ago
10307
572 day(s) ago
453
606 day(s) ago
12
607 day(s) ago
2001
607 day(s) ago
98
613 day(s) ago
51
620 day(s) ago
6939
636 day(s) ago
437
649 day(s) ago
493
660 day(s) ago
7128
681 day(s) ago
1168
718 day(s) ago
704
720 day(s) ago
3254
753 day(s) ago
2312
774 day(s) ago
678
782 day(s) ago
1780
836 day(s) ago
1449
852 day(s) ago
243
858 day(s) ago
3402
878 day(s) ago
5793
921 day(s) ago
11051
979 day(s) ago
92
983 day(s) ago
83
983 day(s) ago
83
983 day(s) ago
83
983 day(s) ago
556
1013 day(s) ago
207
1028 day(s) ago
1603
1049 day(s) ago
838
1083 day(s) ago
1245
1096 day(s) ago
73
1096 day(s) ago

Info

Statistics

  • 141407 total downloads
  • 1328 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2023 Petabridge

Petabridge