Phobos.Monitoring 2.12.0

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

Install-Package Phobos.Monitoring -Version 2.12.0
dotnet add package Phobos.Monitoring --version 2.12.0
<PackageReference Include="Phobos.Monitoring" Version="2.12.0" />
paket add Phobos.Monitoring --version 2.12.0
# Phobos ![Phobos logo](https://raw.githubusercontent.com/petabridge/phobos-issues/refs/heads/master/phobos_logo_small.png) [Phobos](https://phobos.petabridge.com/)™ is an observability plugin for [Akka.NET](https://getakka.net/) that provides [OpenTelemetry](https://opentelemetry.io/)-based tracing, metrics, and log aggregation. [Phobos is available for purchase on Sdkbin](https://sdkbin.com/publisher/petabridge/product/phobos) ## Installation Phobos plugs directly into your Akka.NET `ActorSystem` and immediately starts providing automatic tracing, metrics, and log correlation without you having to write any instrumentation code yourself. ### 1 - Add the `Phobos.Hosting` NuGet Package ```shell dotnet add package Phobos.Hosting ``` ### 2 - Configure OpenTelemetry to Use Phobos Metrics and Tracing ```csharp services // IServiceCollection .AddOpenTelemetry() .ConfigureResource(builder => { builder .AddEnvironmentVariableDetector() .AddTelemetrySdk() .AddServiceVersionDetector(); }) .UseOtlpExporter(OtlpExportProtocol.Grpc, new Uri(otlpEndpoint)) .WithMetrics(c => { c.AddRuntimeInstrumentation() .AddAspNetCoreInstrumentation() .AddHttpClientInstrumentation() .AddPhobosInstrumentation(); // Phobos metrics }) .WithTracing(c => { c.AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation() .AddEntityFrameworkCoreInstrumentation() .AddSqlClientInstrumentation() .AddPhobosInstrumentation(); // Phobos traces }); ``` ### 3 - Add Phobos to Your `ActorSystem` ```csharp public static IServiceCollection AddUserServiceAkka(this IServiceCollection services, Action<AkkaConfigurationBuilder, IServiceProvider> additionalConfig) { return services.AddAkka(ActorSystemName, (builder, sp) => { builder.AddUserServiceActors() WithPhobos(AkkaRunMode.Local, configOptions => {}); additionalConfig.Invoke(builder, sp); }); } ``` And you're done! Akka.NET traces / metrics / logs will now be automatically exported along with your ASP.NET Core, Entity Framework, SqlClient, HttpClient, and other .NET OpenTelemetry data! For more detailed instructions, please see the [Phobos QuickStart Tutorial](https://phobos.petabridge.com/articles/quickstart.html) ## What Data Does Phobos Capture? You can see our full list of automatically collected traces, metrics, and log events here: [https://phobos.petabridge.com/articles/captured-data.html](https://phobos.petabridge.com/articles/captured-data.html) ### Can I Configure What Phobos Collects? Absolutely - [Phobos has finely tuneable noise control capabilities](https://phobos.petabridge.com/articles/trace-filtering.html) that allow you to configure what types of data Phobos collects fronm your application. ### What's the Performance Impact of Phobos on Akka.NET? Tracing and metrics collection always have an amount of instrumentation overhead - you can [view our latest Phobos performance figures and best practices here](https://phobos.petabridge.com/articles/performance.html). Copyright 2018-2025 [Petabridge](https://petabridge.com/), LLC
Loading README...
net8.0
netstandard2.0
Version Downloads Last Updated
2.12.0 Current 13,135 118 day(s) ago
2.11.3 2,464 139 day(s) ago
2.11.2 329 146 day(s) ago
2.11.1 276 147 day(s) ago
2.11.0 1,817 175 day(s) ago
2.10.5 14,690 200 day(s) ago
2.10.4 6,366 250 day(s) ago
2.10.3 250 250 day(s) ago
2.10.2 27,969 319 day(s) ago
2.10.1 2,578 337 day(s) ago
2.10.0 1,967 356 day(s) ago
2.9.1 721 363 day(s) ago
2.9.0 1,452 378 day(s) ago
2.8.5 11,560 452 day(s) ago
2.8.4 4,498 497 day(s) ago
2.8.3 8,427 545 day(s) ago
2.8.2 3,425 579 day(s) ago
2.8.1 1,132 580 day(s) ago
2.8.0 2,028 586 day(s) ago
2.7.0 1,304 593 day(s) ago
2.6.2 1,703 613 day(s) ago
2.6.1 645 620 day(s) ago
2.6.0 1,691 628 day(s) ago
2.5.4 98,081 789 day(s) ago
2.5.3 1,231 799 day(s) ago
2.5.2 1,093 805 day(s) ago
2.5.1 18,906 888 day(s) ago
2.5.0 22,729 924 day(s) ago
2.4.5 3,010 958 day(s) ago
2.4.4 1,090 992 day(s) ago
2.4.3 9,879 999 day(s) ago
2.4.2 11,781 1071 day(s) ago
2.4.1 12,151 1131 day(s) ago
2.4.0 880 1134 day(s) ago
2.3.1 8,897 1189 day(s) ago
2.3.0 13,109 1215 day(s) ago
2.2.1 1,250 1218 day(s) ago
2.2.0 2,327 1271 day(s) ago
2.2.0-beta2 435 1273 day(s) ago
2.1.1 681 1048 day(s) ago
2.1.0 2,276 1316 day(s) ago
2.1.0-beta2 688 1405 day(s) ago
2.1.0-beta1 574 1478 day(s) ago
2.0.6 65,851 1537 day(s) ago
2.0.5 570 1541 day(s) ago
2.0.4 541 1545 day(s) ago
2.0.3 552 1552 day(s) ago
2.0.3-beta1 448 1565 day(s) ago
2.0.2 4,703 1589 day(s) ago
2.0.1 643 1595 day(s) ago
2.0.0 520 1596 day(s) ago
2.0.0-beta4 868 1621 day(s) ago
2.0.0-beta3 888 1665 day(s) ago
2.0.0-beta2 445 1666 day(s) ago
2.0.0-beta1 530 1672 day(s) ago
1.6.1 4,661 1218 day(s) ago
1.6.0 534 1223 day(s) ago
1.5.1 14,176 1596 day(s) ago
1.5.0 504 1596 day(s) ago
1.5.0-beta1 433 1621 day(s) ago
1.4.2 13,143 1631 day(s) ago
1.4.1 2,507 1666 day(s) ago
1.4.0 552 1679 day(s) ago
1.3.3 7,457 1695 day(s) ago
1.3.2 938 1708 day(s) ago
1.3.1 993 1719 day(s) ago
1.3.0 7,632 1740 day(s) ago
1.2.5 1,664 1777 day(s) ago
1.2.4 1,204 1779 day(s) ago
1.2.3 3,740 1812 day(s) ago
1.2.2 2,817 1833 day(s) ago
1.2.1 1,180 1841 day(s) ago
1.2.0 2,467 1895 day(s) ago
1.1.4 1,955 1911 day(s) ago
1.1.3 742 1917 day(s) ago
1.1.2 3,902 1937 day(s) ago
1.1.1 6,286 1980 day(s) ago
1.1.0 11,549 2038 day(s) ago
1.0.6 1,056 2072 day(s) ago
1.0.5 709 2087 day(s) ago
1.0.4 2,109 2108 day(s) ago
1.0.3 1,350 2142 day(s) ago
1.0.2 1,734 2155 day(s) ago
1.0.1 591 2155 day(s) ago
0.9.0 66,124 2042 day(s) ago
0.8.1 586 2042 day(s) ago
0.8.0 689 2042 day(s) ago
**Phobos 2.x Release** **New Feature: Akka.Streams Trace Continuity** Phobos 2.12.0 adds automatic trace-context propagation through Akka.Streams graphs. With Akka.NET 1.5.66+, which ships the framework-owned `"Akka.Streams"` `ActivitySource`, every element flowing through a stream stage carries its parent trace context forward — connecting your actor message handler, the stream graph stages, and any user spans created inside lambdas (e.g. `SqlClient`, `HttpClient` instrumentation) into one unbroken distributed trace. The resulting trace shape looks like this: ``` [actor] akka.msg.recv RecordOrder [stream] akka.stream.ingress QueueSource [stream] akka.stream.stage SelectAsync [user] db.INSERT (SqlClient / HttpClient / etc.) ``` **Akka.Streams tracing is on by default.** No code changes are required if you already call `AddPhobosInstrumentation()` — it registers the `"Akka.Streams"` `ActivitySource` automatically: ```csharp services.AddOpenTelemetry() .WithTracing(tracing => tracing .AddPhobosInstrumentation() // traceAkkaStreams: true by default .AddOtlpExporter()); ``` To opt out of stream-stage spans: ```csharp services.AddOpenTelemetry() .WithTracing(tracing => tracing .AddPhobosInstrumentation(traceAkkaStreams: false) .AddOtlpExporter()); ``` For details on the underlying Akka.NET `"Akka.Streams"` `ActivitySource`, see: [Akka.Streams OpenTelemetry Tracing](https://getakka.net/articles/streams/stream-tracing.html) in the Akka.NET documentation. See [#1506](https://github.com/petabridge/phobos/pull/1506). **Bug Fixes** - Fixed `ReceiveAsync`/`CommandAsync` message-receive spans closing prematurely before the async handler completed. The `akka.msg.recv` span now stays open for the full duration of the async handler, accurately capturing duration and faults across `await` points. Also un-skips the long-standing `AsyncAwaitRequestResponseWithFiltering` trace-continuity test that was suppressed since Phobos 1.3.0. See [#1528](https://github.com/petabridge/phobos/pull/1528). **Improvements** - Upgraded to [Akka.NET v1.5.67](https://github.com/akkadotnet/akka.net/releases/tag/1.5.67) and [Akka.Hosting v1.5.67](https://github.com/akkadotnet/Akka.Hosting/releases/tag/1.5.67) for latest stability and performance improvements.

Info

Statistics

  • 564038 total downloads
  • 13135 downloads of current version
  • 46.9 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge