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.11.0 Current | 3 | 5 hour(s) ago | |
| 2.10.5 | 2,600 | 25 day(s) ago | |
| 2.10.4 | 3,998 | 75 day(s) ago | |
| 2.10.3 | 75 | 75 day(s) ago | |
| 2.10.2 | 8,387 | 144 day(s) ago | |
| 2.10.1 | 2,367 | 162 day(s) ago | |
| 2.10.0 | 1,423 | 181 day(s) ago | |
| 2.9.1 | 536 | 188 day(s) ago | |
| 2.9.0 | 1,136 | 203 day(s) ago | |
| 2.8.5 | 11,270 | 277 day(s) ago | |
| 2.8.4 | 3,937 | 322 day(s) ago | |
| 2.8.3 | 8,047 | 370 day(s) ago | |
| 2.8.2 | 3,029 | 404 day(s) ago | |
| 2.8.1 | 957 | 405 day(s) ago | |
| 2.8.0 | 1,852 | 411 day(s) ago | |
| 2.7.0 | 1,125 | 418 day(s) ago | |
| 2.6.2 | 1,528 | 438 day(s) ago | |
| 2.6.1 | 468 | 445 day(s) ago | |
| 2.6.0 | 1,516 | 453 day(s) ago | |
| 2.5.4 | 89,480 | 614 day(s) ago | |
| 2.5.3 | 1,057 | 624 day(s) ago | |
| 2.5.2 | 918 | 630 day(s) ago | |
| 2.5.1 | 18,103 | 713 day(s) ago | |
| 2.5.0 | 14,761 | 749 day(s) ago | |
| 2.4.5 | 2,834 | 783 day(s) ago | |
| 2.4.4 | 917 | 817 day(s) ago | |
| 2.4.3 | 9,183 | 824 day(s) ago | |
| 2.4.2 | 9,465 | 896 day(s) ago | |
| 2.4.1 | 11,978 | 956 day(s) ago | |
| 2.4.0 | 707 | 959 day(s) ago | |
| 2.3.1 | 8,724 | 1014 day(s) ago | |
| 2.3.0 | 11,423 | 1040 day(s) ago | |
| 2.2.1 | 1,077 | 1043 day(s) ago | |
| 2.2.0 | 2,155 | 1096 day(s) ago | |
| 2.2.0-beta2 | 261 | 1098 day(s) ago | |
| 2.1.1 | 499 | 873 day(s) ago | |
| 2.1.0 | 2,104 | 1141 day(s) ago | |
| 2.1.0-beta2 | 515 | 1230 day(s) ago | |
| 2.1.0-beta1 | 401 | 1303 day(s) ago | |
| 2.0.6 | 65,664 | 1362 day(s) ago | |
| 2.0.5 | 398 | 1366 day(s) ago | |
| 2.0.4 | 366 | 1370 day(s) ago | |
| 2.0.3 | 379 | 1377 day(s) ago | |
| 2.0.3-beta1 | 273 | 1390 day(s) ago | |
| 2.0.2 | 4,528 | 1414 day(s) ago | |
| 2.0.1 | 471 | 1420 day(s) ago | |
| 2.0.0 | 347 | 1421 day(s) ago | |
| 2.0.0-beta4 | 696 | 1446 day(s) ago | |
| 2.0.0-beta3 | 713 | 1490 day(s) ago | |
| 2.0.0-beta2 | 272 | 1491 day(s) ago | |
| 2.0.0-beta1 | 358 | 1497 day(s) ago | |
| 1.6.1 | 4,488 | 1043 day(s) ago | |
| 1.6.0 | 362 | 1048 day(s) ago | |
| 1.5.1 | 13,946 | 1421 day(s) ago | |
| 1.5.0 | 331 | 1421 day(s) ago | |
| 1.5.0-beta1 | 261 | 1446 day(s) ago | |
| 1.4.2 | 12,875 | 1456 day(s) ago | |
| 1.4.1 | 2,335 | 1491 day(s) ago | |
| 1.4.0 | 380 | 1504 day(s) ago | |
| 1.3.3 | 7,284 | 1520 day(s) ago | |
| 1.3.2 | 766 | 1533 day(s) ago | |
| 1.3.1 | 819 | 1544 day(s) ago | |
| 1.3.0 | 7,459 | 1565 day(s) ago | |
| 1.2.5 | 1,492 | 1602 day(s) ago | |
| 1.2.4 | 1,031 | 1604 day(s) ago | |
| 1.2.3 | 3,568 | 1637 day(s) ago | |
| 1.2.2 | 2,643 | 1658 day(s) ago | |
| 1.2.1 | 1,006 | 1666 day(s) ago | |
| 1.2.0 | 2,293 | 1720 day(s) ago | |
| 1.1.4 | 1,783 | 1736 day(s) ago | |
| 1.1.3 | 569 | 1742 day(s) ago | |
| 1.1.2 | 3,728 | 1762 day(s) ago | |
| 1.1.1 | 6,113 | 1805 day(s) ago | |
| 1.1.0 | 11,377 | 1863 day(s) ago | |
| 1.0.6 | 883 | 1897 day(s) ago | |
| 1.0.5 | 535 | 1912 day(s) ago | |
| 1.0.4 | 1,935 | 1933 day(s) ago | |
| 1.0.3 | 1,178 | 1967 day(s) ago | |
| 1.0.2 | 1,562 | 1980 day(s) ago | |
| 1.0.1 | 415 | 1980 day(s) ago | |
| 0.9.0 | 60,571 | 1867 day(s) ago | |
| 0.8.1 | 414 | 1867 day(s) ago | |
| 0.8.0 | 457 | 1867 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 5 hour(s) ago
- Project Site
- License Info
Statistics
- 470140 total downloads
- 3 downloads of current version
- 46.6 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge