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.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
1753
34 day(s) ago
1877
68 day(s) ago
632
69 day(s) ago
1219
76 day(s) ago
770
83 day(s) ago
1200
102 day(s) ago
141
109 day(s) ago
1180
117 day(s) ago
48018
278 day(s) ago
732
288 day(s) ago
581
294 day(s) ago
15396
377 day(s) ago
8719
413 day(s) ago
2507
447 day(s) ago
591
482 day(s) ago
5503
489 day(s) ago
171
537 day(s) ago
3906
560 day(s) ago
11482
620 day(s) ago
355
623 day(s) ago
8307
678 day(s) ago
2777
704 day(s) ago
727
707 day(s) ago
4165
707 day(s) ago
40
712 day(s) ago
1793
761 day(s) ago
1
762 day(s) ago
951
806 day(s) ago
254
894 day(s) ago
141
967 day(s) ago
57393
1026 day(s) ago
68
1030 day(s) ago
38
1034 day(s) ago
51
1041 day(s) ago
12
1055 day(s) ago
4198
1078 day(s) ago
142
1084 day(s) ago
17
1085 day(s) ago
13493
1085 day(s) ago
2
1085 day(s) ago
436
1111 day(s) ago
1
1111 day(s) ago
12152
1120 day(s) ago
453
1154 day(s) ago
11
1155 day(s) ago
1904
1155 day(s) ago
98
1161 day(s) ago
41
1168 day(s) ago
6955
1184 day(s) ago
436
1197 day(s) ago
495
1208 day(s) ago
7121
1229 day(s) ago
1067
1266 day(s) ago
703
1268 day(s) ago
3236
1301 day(s) ago
2314
1322 day(s) ago
670
1330 day(s) ago
1959
1384 day(s) ago
1452
1400 day(s) ago
243
1406 day(s) ago
339
1426 day(s) ago
5792
1470 day(s) ago
9384
1527 day(s) ago
100
1531 day(s) ago
84
1531 day(s) ago
84
1531 day(s) ago
84
1531 day(s) ago
537
1561 day(s) ago
208
1576 day(s) ago
1604
1597 day(s) ago
850
1632 day(s) ago
855
1644 day(s) ago
87
1644 day(s) ago

Info

Statistics

  • 263058 total downloads
  • 98 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge