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-beta1

Akka.Cluster support for Phobos Enterprise framework.

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

Release Notes

MAJOR RELEASE OF PHOBOS** In Phobos 2.0 we have migrated all of our tracing and monitoring capabilities to use [OpenTelemetry](https://opentelemetry.io/). As we mentioned in our recent blog post about Phobos 2.0 and its relationship with OpenTelemetry, we did this for the following reasons: OpenTelemetry is now the official APM solution for the entire .NET platform, including other popular frameworks such as ASP.NET and Entity Framework; All major APM vendors and OSS project such as Prometheus, Jaeger, DataDog, AWS, GCP, Azure, Elastic, and so on are all committed to supporting OpenTelemetry going forward and they implement their own first-party exporters that transmit data to those platforms; The performance of the `OpenTelemetry.Trace` and `OpenTelemetry.Metrics` implementations, which Phobos uses, are identical no matter which combination of exporters you adopt; and OpenTelemetry is much more decoupled and extensible than any of the previous solutions in market. We have replaced all of our OpenTracing and App.Metrics dependencies with 2.x going forward. Installation and Configuration** To use Phobos 2.0.0-beta* in your solution, all you need to do is: 1. Install [the appropriate `Phobos.Actor.*` package](https://phobos.petabridge.com/articles/setup/index.html#nuget-packages) into your application using the 2.0.0-beta* version; 2. Install the appropriate [`OpenTelemetry.Exporter.*` packages](https://www.nuget.org/packages?q=OpenTelemetry.Exporter) you want to use in combination with your preferred APM tools; and 3. Configure your `IServiceCollection` with the following (adjust as needed): ```csharp // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { // Prometheus exporter won't work without this services.AddControllers(); var resource = ResourceBuilder.CreateDefault() .AddService(Assembly.GetEntryAssembly().GetName().Name, serviceInstanceId: $"{Dns.GetHostName()}"); // enables OpenTelemetry for ASP.NET / .NET Core services.AddOpenTelemetryTracing(builder => { builder .SetResourceBuilder(resource) .AddPhobosInstrumentation() .AddSource("Petabridge.Phobos.Web") .AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation() .AddJaegerExporter(opt => { opt.AgentHost = Environment.GetEnvironmentVariable(JaegerAgentHostEnvironmentVar); }); }); services.AddOpenTelemetryMetrics(builder => { builder .SetResourceBuilder(resource) .AddPhobosInstrumentation() .AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation() .AddPrometheusExporter(opt => { }); }); // sets up Akka.NET ConfigureAkka(services); } ``` The `.AddPhobosInstrumentation()` line will ensure that OTel picks up all of the signals produced by Phobos - and you need to call this line for *both* metrics and tracing! Finally, you need to configure your `ActorSystem` to use Phobos and to leverage the `TracerProvider` and `MeterProvider`s from OpenTelemetry: ```csharp public static void ConfigureAkka(IServiceCollection services) { services.AddSingleton(sp => { var metrics = sp.GetRequiredService<MeterProvider>(); var tracer = sp.GetRequiredService<TracerProvider>(); var config = ConfigurationFactory.ParseString(File.ReadAllText("app.conf")) .BootstrapFromDocker() .UseSerilog(); 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))) // binds Phobos to same tracer as ASP.NET Core .WithSetup(BootstrapSetup.Create() .WithConfig(config) // passes in the HOCON for Akka.NET to the ActorSystem .WithActorRefProvider(PhobosProviderSelection .Cluster)); // last line activates Phobos inside Akka.NET var sys = ActorSystem.Create("ClusterSys", phobosSetup); // create actor "container" and bind it to DI, so it can be used by ASP.NET Core return new AkkaActors(sys); }); // this will manage Akka.NET lifecycle services.AddHostedService<AkkaService>(); } ``` This is fundamentally not all that different from how Phobos 1.x works. We will update our official documentation and website with more Phobos 2.0-specific instructions as our releases mature, but for the time being please don't hesitate to submit an issue on the [Phobos Issue Tracker](https://github.com/petabridge/phobos-issues) if you run into trouble! Phobos 1.x Support Lifetime** Per our recent announcement, we will continue to support Phobos 1.x and 2.x concurrently. Phobos 1.x will exit support on December 31st, 2023.

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
  • 98 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge