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

Phobos.Actor.Cluster 2.0.0-beta4

Akka.Cluster support for Phobos Enterprise framework.

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

Release Notes

Major Update to Phobos 2.x** This release contains some **breaking changes** which we've introduced intentionally in order to get users concerned about noise control from the Phobos tracing system to migrate over to a new set of APIs that perform the job in a much more coherent fashion that what we have currently in Phobos 1.4 / 2.0.0-beta3 and newer. You can see some examples of end-user negative experience reports with the current v1.x and 2.x trace filtering implementations here: https://github.com/petabridge/phobos-issues/issues/46 https://github.com/petabridge/phobos-issues/issues/49 There have been many more like these over the past couple of years - separating noise from useful signals has been a persistent challenge with Phobos tracing and the changes we're introducing in Phobos v1.5 and 2.0-beta4 address this with a small new API: ```csharp /// <summary> /// Each <see cref="ActorSystem"/> can implement exactly one of these to control /// the decision-making around which traces to include and which ones to exclude. /// /// When this type is configured, it will replace all of the <see cref="IFilterRule"/>s /// that have been previously defined. /// </summary> /// <seealso cref="FilterDecision"/> public interface ITraceFilter { /// <summary> /// Evaluates a message processed by an actor and determines whether or not to include it in the current /// or a new trace. /// </summary> /// <param name="message">The message currently being processed by an actor.</param> /// <param name="alreadyInTrace">Whether or not this message is already part of an active trace.</param> /// <returns><c>true</c> if we are going to trace the message, <c>false</c> otherwise.</returns> /// <remarks> /// Should return <c>true</c> unless you are explicitly trying to filter a given message out of your trace. /// </remarks> bool ShouldTraceMessage(object message, bool alreadyInTrace); } ``` This is the `ITraceFilter` - and there is _exactly one of these_ for your entire `ActorSystem`. It allows you to decide whether or not to trace an actor's message processing activity based on: Message type; Message content; and Whether or not we are inside an active trace or not. This API is astonishingly succinct, much clearer than the previous `TracingConfigBuilder` API from before, extremely performant, and very effective at limiting noise inside your Phobos-enabled Akka.NET applications. An example from one of our own stress testing applications: ```csharp public sealed class ScenarioTraceFilter : ITraceFilter { public bool ShouldTraceMessage(object message, bool alreadyInTrace) { switch (message) { /* Only start new traces for these commands / case IScenarioProtocolMessage _: case Petabridge.Cmd.Command _: case Petabridge.Cmd.CommandResponse _: return true; default: // otherwise, only allow messages already in trace to be included return alreadyInTrace; } } } ``` This class allows new traces to only be started handful of [Petabridge.Cmd](https://cmd.petabridge.com/) types and any messages and our custom `IScenarioProtocol` messages. Any additional messages _will not_ be included in a trace unless there is already an active trace present. You can add this `ITraceFilter` to your applications like so: ```csharp var phobosSetup = PhobosSetup.Create(new PhobosConfigBuilder() .WithMetrics(m => m.SetMetricsRoot(metrics)) // binds Phobos to same IMetricsRoot as ASP.NET Core .WithTracing(t => t.SetTracer(tracer) .SetTraceFilter(new ScenarioTraceFilter()) )) // binds Phobos to same tracer as ASP.NET Core .WithSetup(BootstrapSetup.Create() .WithActorRefProvider(PhobosProviderSelection .Local)); // last line activates Phobos inside Akka.NET ``` Phobos still supports the old `TracingConfigBuilder` pattern and the `WithIncludeMessage<T>` rules - however, all of those rules will be overidden and replaced when the `ITraceFilter` is used instead. We have broken the old `TracingConfigBuilder` method signatures in order to alert users to this important change - however, we are going to keep these changes in a beta state for a short period in order to gather feedback from affected users. If you are concerned about trace noise inside your application, _please try this beta_ and report on your experience on the [Phobos Issue Tracker](https://github.com/petabridge/phobos-issues).

Dependencies

.NETStandard

Versions

Version
Downloads
Last Updated
294
11 day(s) ago
2889
58 day(s) ago
2019
92 day(s) ago
642
93 day(s) ago
1293
100 day(s) ago
781
107 day(s) ago
1211
126 day(s) ago
151
133 day(s) ago
1191
141 day(s) ago
51283
302 day(s) ago
742
312 day(s) ago
600
318 day(s) ago
15712
401 day(s) ago
8944
437 day(s) ago
2517
471 day(s) ago
601
506 day(s) ago
5771
513 day(s) ago
186
561 day(s) ago
3916
584 day(s) ago
11499
644 day(s) ago
365
647 day(s) ago
8317
702 day(s) ago
2787
728 day(s) ago
737
731 day(s) ago
4175
731 day(s) ago
50
736 day(s) ago
1803
785 day(s) ago
1
786 day(s) ago
961
830 day(s) ago
254
918 day(s) ago
141
991 day(s) ago
57432
1050 day(s) ago
78
1054 day(s) ago
48
1058 day(s) ago
61
1065 day(s) ago
12
1079 day(s) ago
4208
1102 day(s) ago
152
1108 day(s) ago
27
1109 day(s) ago
13504
1109 day(s) ago
12
1109 day(s) ago
436
1135 day(s) ago
1
1135 day(s) ago
12162
1144 day(s) ago
453
1178 day(s) ago
11
1179 day(s) ago
1914
1179 day(s) ago
98
1185 day(s) ago
51
1192 day(s) ago
6965
1208 day(s) ago
446
1221 day(s) ago
505
1233 day(s) ago
7131
1254 day(s) ago
1077
1290 day(s) ago
713
1292 day(s) ago
3246
1325 day(s) ago
2324
1346 day(s) ago
680
1354 day(s) ago
1969
1408 day(s) ago
1462
1424 day(s) ago
253
1430 day(s) ago
349
1450 day(s) ago
5802
1494 day(s) ago
9394
1551 day(s) ago
110
1555 day(s) ago
94
1555 day(s) ago
94
1555 day(s) ago
94
1555 day(s) ago
547
1585 day(s) ago
218
1600 day(s) ago
1614
1621 day(s) ago
860
1656 day(s) ago
865
1668 day(s) ago
97
1668 day(s) ago

Info

Statistics

  • 269402 total downloads
  • 436 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge