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

Phobos.Actor 2.0.0-beta1

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

Install-Package Phobos.Actor -Version 2.0.0-beta1
dotnet add package Phobos.Actor --version 2.0.0-beta1
<PackageReference Include="Phobos.Actor" Version="2.0.0-beta1"/>
paket add Phobos.Actor --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
1325
37 day(s) ago
3989
85 day(s) ago
2234
119 day(s) ago
673
120 day(s) ago
1424
126 day(s) ago
834
133 day(s) ago
1241
153 day(s) ago
182
160 day(s) ago
1221
168 day(s) ago
55547
329 day(s) ago
774
339 day(s) ago
653
345 day(s) ago
16527
428 day(s) ago
9295
464 day(s) ago
2547
498 day(s) ago
631
532 day(s) ago
5912
539 day(s) ago
136
588 day(s) ago
6864
611 day(s) ago
11577
671 day(s) ago
400
674 day(s) ago
8358
729 day(s) ago
8647
755 day(s) ago
798
758 day(s) ago
4209
758 day(s) ago
84
763 day(s) ago
1870
811 day(s) ago
4
813 day(s) ago
1818
856 day(s) ago
257
945 day(s) ago
144
1018 day(s) ago
65449
1077 day(s) ago
117
1081 day(s) ago
82
1085 day(s) ago
95
1092 day(s) ago
16
1105 day(s) ago
4246
1129 day(s) ago
188
1135 day(s) ago
94
1136 day(s) ago
13635
1136 day(s) ago
47
1136 day(s) ago
439
1161 day(s) ago
4
1161 day(s) ago
12438
1171 day(s) ago
456
1205 day(s) ago
15
1206 day(s) ago
2051
1206 day(s) ago
101
1212 day(s) ago
97
1219 day(s) ago
6996
1235 day(s) ago
484
1248 day(s) ago
539
1259 day(s) ago
7173
1280 day(s) ago
1213
1317 day(s) ago
749
1319 day(s) ago
3299
1352 day(s) ago
2360
1373 day(s) ago
723
1381 day(s) ago
2010
1435 day(s) ago
1498
1451 day(s) ago
288
1457 day(s) ago
3448
1477 day(s) ago
5839
1520 day(s) ago
11097
1578 day(s) ago
154
1582 day(s) ago
129
1582 day(s) ago
129
1582 day(s) ago
129
1582 day(s) ago
602
1612 day(s) ago
253
1627 day(s) ago
1651
1648 day(s) ago
887
1682 day(s) ago
1296
1695 day(s) ago
124
1695 day(s) ago

Info

Statistics

  • 302815 total downloads
  • 101 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge