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

Phobos.Monitoring 2.0.0-beta1

High-performance monitoring and instrumentation library for .NET and .NET Core applications.

Install-Package Phobos.Monitoring -Version 2.0.0-beta1
dotnet add package Phobos.Monitoring --version 2.0.0-beta1
<PackageReference Include="Phobos.Monitoring" Version="2.0.0-beta1"/>
paket add Phobos.Monitoring --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
855
24 day(s) ago
3304
71 day(s) ago
2113
105 day(s) ago
656
106 day(s) ago
1379
113 day(s) ago
799
120 day(s) ago
1227
139 day(s) ago
166
146 day(s) ago
1191
154 day(s) ago
53082
315 day(s) ago
756
325 day(s) ago
616
331 day(s) ago
15822
414 day(s) ago
9167
450 day(s) ago
2533
484 day(s) ago
616
519 day(s) ago
5822
526 day(s) ago
121
574 day(s) ago
6784
597 day(s) ago
11518
657 day(s) ago
406
660 day(s) ago
8422
715 day(s) ago
8731
741 day(s) ago
775
744 day(s) ago
4187
744 day(s) ago
61
749 day(s) ago
1854
798 day(s) ago
2
799 day(s) ago
1803
843 day(s) ago
256
931 day(s) ago
142
1004 day(s) ago
65270
1063 day(s) ago
97
1067 day(s) ago
64
1071 day(s) ago
78
1078 day(s) ago
14
1092 day(s) ago
4227
1115 day(s) ago
169
1121 day(s) ago
45
1122 day(s) ago
13615
1122 day(s) ago
29
1122 day(s) ago
437
1148 day(s) ago
2
1148 day(s) ago
12412
1157 day(s) ago
454
1191 day(s) ago
13
1192 day(s) ago
2034
1192 day(s) ago
99
1198 day(s) ago
79
1205 day(s) ago
6983
1221 day(s) ago
465
1234 day(s) ago
518
1245 day(s) ago
7158
1266 day(s) ago
1191
1303 day(s) ago
730
1305 day(s) ago
3267
1338 day(s) ago
2341
1359 day(s) ago
705
1367 day(s) ago
1992
1421 day(s) ago
1480
1437 day(s) ago
268
1443 day(s) ago
3427
1463 day(s) ago
5812
1507 day(s) ago
11076
1564 day(s) ago
134
1568 day(s) ago
113
1568 day(s) ago
54835
1568 day(s) ago
582
1598 day(s) ago
234
1613 day(s) ago
1634
1634 day(s) ago
877
1669 day(s) ago
1261
1681 day(s) ago
114
1681 day(s) ago

Info

Statistics

  • 351501 total downloads
  • 99 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge