Phobos.Monitoring 2.11.0
High-performance monitoring and instrumentation library for .NET and .NET Core applications.
Install-Package Phobos.Monitoring -Version 2.11.0
dotnet add package Phobos.Monitoring --version 2.11.0
<PackageReference Include="Phobos.Monitoring" Version="2.11.0" />
paket add Phobos.Monitoring --version 2.11.0
Paket is a third-party, open source alternative to the NuGet client.
# Phobos

[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
- Akka (>=1.5.61)
- OpenTelemetry (>=1.11.2)
- Phobos.Actor.Common (>=1.1.2)
netstandard2.0
- Akka (>=1.5.61)
- OpenTelemetry (>=1.11.2)
- Phobos.Actor.Common (>=1.1.2)
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 2.12.0 | 7,430 | 73 day(s) ago | |
| 2.11.3 | 2,272 | 94 day(s) ago | |
| 2.11.2 | 284 | 100 day(s) ago | |
| 2.11.1 | 196 | 101 day(s) ago | |
| 2.11.0 Current | 1,755 | 129 day(s) ago | |
| 2.10.5 | 11,496 | 154 day(s) ago | |
| 2.10.4 | 5,981 | 204 day(s) ago | |
| 2.10.3 | 205 | 204 day(s) ago | |
| 2.10.2 | 25,498 | 274 day(s) ago | |
| 2.10.1 | 2,533 | 291 day(s) ago | |
| 2.10.0 | 1,831 | 310 day(s) ago | |
| 2.9.1 | 675 | 317 day(s) ago | |
| 2.9.0 | 1,405 | 332 day(s) ago | |
| 2.8.5 | 11,486 | 406 day(s) ago | |
| 2.8.4 | 4,396 | 452 day(s) ago | |
| 2.8.3 | 8,362 | 499 day(s) ago | |
| 2.8.2 | 3,265 | 533 day(s) ago | |
| 2.8.1 | 1,087 | 534 day(s) ago | |
| 2.8.0 | 1,983 | 541 day(s) ago | |
| 2.7.0 | 1,259 | 548 day(s) ago | |
| 2.6.2 | 1,658 | 567 day(s) ago | |
| 2.6.1 | 599 | 574 day(s) ago | |
| 2.6.0 | 1,646 | 582 day(s) ago | |
| 2.5.4 | 95,954 | 743 day(s) ago | |
| 2.5.3 | 1,186 | 753 day(s) ago | |
| 2.5.2 | 1,048 | 759 day(s) ago | |
| 2.5.1 | 18,607 | 842 day(s) ago | |
| 2.5.0 | 20,396 | 878 day(s) ago | |
| 2.4.5 | 2,965 | 912 day(s) ago | |
| 2.4.4 | 1,046 | 947 day(s) ago | |
| 2.4.3 | 9,745 | 954 day(s) ago | |
| 2.4.2 | 10,938 | 1025 day(s) ago | |
| 2.4.1 | 12,107 | 1085 day(s) ago | |
| 2.4.0 | 836 | 1088 day(s) ago | |
| 2.3.1 | 8,853 | 1143 day(s) ago | |
| 2.3.0 | 12,899 | 1169 day(s) ago | |
| 2.2.1 | 1,206 | 1172 day(s) ago | |
| 2.2.0 | 2,283 | 1226 day(s) ago | |
| 2.2.0-beta2 | 391 | 1227 day(s) ago | |
| 2.1.1 | 637 | 1002 day(s) ago | |
| 2.1.0 | 2,232 | 1271 day(s) ago | |
| 2.1.0-beta2 | 644 | 1359 day(s) ago | |
| 2.1.0-beta1 | 530 | 1432 day(s) ago | |
| 2.0.6 | 65,807 | 1491 day(s) ago | |
| 2.0.5 | 526 | 1495 day(s) ago | |
| 2.0.4 | 497 | 1499 day(s) ago | |
| 2.0.3 | 508 | 1506 day(s) ago | |
| 2.0.3-beta1 | 404 | 1520 day(s) ago | |
| 2.0.2 | 4,658 | 1543 day(s) ago | |
| 2.0.1 | 599 | 1549 day(s) ago | |
| 2.0.0 | 476 | 1550 day(s) ago | |
| 2.0.0-beta4 | 824 | 1576 day(s) ago | |
| 2.0.0-beta3 | 844 | 1620 day(s) ago | |
| 2.0.0-beta2 | 401 | 1620 day(s) ago | |
| 2.0.0-beta1 | 486 | 1626 day(s) ago | |
| 1.6.1 | 4,617 | 1172 day(s) ago | |
| 1.6.0 | 490 | 1177 day(s) ago | |
| 1.5.1 | 14,131 | 1550 day(s) ago | |
| 1.5.0 | 460 | 1550 day(s) ago | |
| 1.5.0-beta1 | 389 | 1576 day(s) ago | |
| 1.4.2 | 13,079 | 1585 day(s) ago | |
| 1.4.1 | 2,463 | 1620 day(s) ago | |
| 1.4.0 | 508 | 1633 day(s) ago | |
| 1.3.3 | 7,413 | 1649 day(s) ago | |
| 1.3.2 | 894 | 1662 day(s) ago | |
| 1.3.1 | 949 | 1674 day(s) ago | |
| 1.3.0 | 7,588 | 1695 day(s) ago | |
| 1.2.5 | 1,620 | 1731 day(s) ago | |
| 1.2.4 | 1,160 | 1733 day(s) ago | |
| 1.2.3 | 3,696 | 1766 day(s) ago | |
| 1.2.2 | 2,773 | 1787 day(s) ago | |
| 1.2.1 | 1,136 | 1795 day(s) ago | |
| 1.2.0 | 2,422 | 1849 day(s) ago | |
| 1.1.4 | 1,911 | 1865 day(s) ago | |
| 1.1.3 | 698 | 1871 day(s) ago | |
| 1.1.2 | 3,858 | 1891 day(s) ago | |
| 1.1.1 | 6,242 | 1935 day(s) ago | |
| 1.1.0 | 11,505 | 1992 day(s) ago | |
| 1.0.6 | 1,012 | 2026 day(s) ago | |
| 1.0.5 | 665 | 2041 day(s) ago | |
| 1.0.4 | 2,065 | 2062 day(s) ago | |
| 1.0.3 | 1,306 | 2097 day(s) ago | |
| 1.0.2 | 1,690 | 2109 day(s) ago | |
| 1.0.1 | 546 | 2109 day(s) ago | |
| 0.9.0 | 64,978 | 1996 day(s) ago | |
| 0.8.1 | 542 | 1996 day(s) ago | |
| 0.8.0 | 644 | 1996 day(s) ago |
**Phobos 2.x Release**
**New Feature: Log-Trace Correlation**
Phobos 2.11.0 introduces first-class log-trace correlation, enabling automatic synchronization between actor logs and distributed traces. This allows you to navigate seamlessly between logs and traces in observability platforms like Seq, Grafana Loki, and Datadog.
See the full documentation: [Log-Trace Correlation](https://phobos.petabridge.com/articles/log-trace-correlation.html)
Setup requires one step: add `AddAkkaTraceCorrelation()` to your OpenTelemetry logging pipeline (before your exporters).
**Deprecation: AppendLogsToTrace Default Changed to Off**
The `phobos.tracing.append-logs-to-trace` setting now defaults to `off`. This feature, which appended actor log messages as events to active trace spans, has been deprecated in favor of OpenTelemetry trace correlation via [`AddAkkaTraceCorrelation()`](https://phobos.petabridge.com/articles/log-trace-correlation-migration.html).
The new approach provides:
- Proper first-class log records instead of span events
- Full structured/semantic logging support
- Better querying and filtering in observability platforms
- No more `FormatException` issues with semantic log templates
For migration instructions, see: [Log-Trace Correlation Migration Guide](https://phobos.petabridge.com/articles/log-trace-correlation-migration.html)
Users who depend on the old behavior can re-enable it with `phobos.tracing.append-logs-to-trace = on` in HOCON or `.SetAppendLogsToTrace(true)` in the `PhobosConfigBuilder`, but this is not recommended.
**Improvements**
- Upgraded to [Akka.NET v1.5.61](https://github.com/akkadotnet/akka.net/releases/tag/1.5.61) and [Akka.Hosting v1.5.61](https://github.com/akkadotnet/Akka.Hosting/releases/tag/1.5.61)
Info
- last updated 129 day(s) ago
- Project Site
- License Info
Statistics
- 541285 total downloads
- 1755 downloads of current version
- 46.6 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge