Phobos.Tracing 2.11.0
Distributed tracing support for Akka.NET ActorSystems.
Install-Package Phobos.Tracing -Version 2.11.0
dotnet add package Phobos.Tracing --version 2.11.0
<PackageReference Include="Phobos.Tracing" Version="2.11.0" />
paket add Phobos.Tracing --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)
- Google.Protobuf (>=3.26.1)
- OpenTelemetry (>=1.11.2)
- Phobos.Actor.Common (>=1.1.2)
netstandard2.0
- Akka (>=1.5.61)
- Google.Protobuf (>=3.26.1)
- OpenTelemetry (>=1.11.2)
- Phobos.Actor.Common (>=1.1.2)
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 2.11.3 | 820 | 13 day(s) ago | |
| 2.11.2 | 203 | 19 day(s) ago | |
| 2.11.1 | 52 | 20 day(s) ago | |
| 2.11.0 Current | 1,370 | 48 day(s) ago | |
| 2.10.5 | 6,242 | 73 day(s) ago | |
| 2.10.4 | 4,837 | 123 day(s) ago | |
| 2.10.3 | 125 | 123 day(s) ago | |
| 2.10.2 | 14,224 | 193 day(s) ago | |
| 2.10.1 | 2,426 | 210 day(s) ago | |
| 2.10.0 | 1,541 | 229 day(s) ago | |
| 2.9.1 | 584 | 236 day(s) ago | |
| 2.9.0 | 1,320 | 251 day(s) ago | |
| 2.8.5 | 11,346 | 325 day(s) ago | |
| 2.8.4 | 4,086 | 371 day(s) ago | |
| 2.8.3 | 8,154 | 418 day(s) ago | |
| 2.8.2 | 3,124 | 452 day(s) ago | |
| 2.8.1 | 1,007 | 453 day(s) ago | |
| 2.8.0 | 1,903 | 460 day(s) ago | |
| 2.7.0 | 1,165 | 467 day(s) ago | |
| 2.6.2 | 1,575 | 486 day(s) ago | |
| 2.6.1 | 517 | 493 day(s) ago | |
| 2.6.0 | 1,541 | 501 day(s) ago | |
| 2.5.4 | 96,561 | 662 day(s) ago | |
| 2.5.3 | 1,112 | 672 day(s) ago | |
| 2.5.2 | 971 | 678 day(s) ago | |
| 2.5.1 | 18,310 | 761 day(s) ago | |
| 2.5.0 | 17,064 | 797 day(s) ago | |
| 2.4.5 | 2,884 | 831 day(s) ago | |
| 2.4.4 | 967 | 866 day(s) ago | |
| 2.4.3 | 9,620 | 873 day(s) ago | |
| 2.4.2 | 10,240 | 944 day(s) ago | |
| 2.4.1 | 11,930 | 1004 day(s) ago | |
| 2.4.0 | 731 | 1007 day(s) ago | |
| 2.3.1 | 8,576 | 1062 day(s) ago | |
| 2.3.0 | 12,259 | 1088 day(s) ago | |
| 2.2.1 | 1,187 | 1091 day(s) ago | |
| 2.2.0 | 2,207 | 1144 day(s) ago | |
| 2.2.0-beta2 | 310 | 1146 day(s) ago | |
| 2.1.1 | 550 | 921 day(s) ago | |
| 2.1.0 | 2,150 | 1190 day(s) ago | |
| 2.1.0-beta2 | 564 | 1278 day(s) ago | |
| 2.1.0-beta1 | 450 | 1351 day(s) ago | |
| 2.0.6 | 65,911 | 1410 day(s) ago | |
| 2.0.5 | 447 | 1414 day(s) ago | |
| 2.0.4 | 414 | 1418 day(s) ago | |
| 2.0.3 | 429 | 1425 day(s) ago | |
| 2.0.3-beta1 | 321 | 1439 day(s) ago | |
| 2.0.2 | 4,576 | 1462 day(s) ago | |
| 2.0.1 | 521 | 1468 day(s) ago | |
| 2.0.0 | 411 | 1469 day(s) ago | |
| 2.0.0-beta4 | 747 | 1495 day(s) ago | |
| 2.0.0-beta3 | 764 | 1538 day(s) ago | |
| 2.0.0-beta2 | 321 | 1539 day(s) ago | |
| 2.0.0-beta1 | 409 | 1545 day(s) ago | |
| 1.6.1 | 4,584 | 1091 day(s) ago | |
| 1.6.0 | 469 | 1096 day(s) ago | |
| 1.5.1 | 14,027 | 1469 day(s) ago | |
| 1.5.0 | 380 | 1469 day(s) ago | |
| 1.5.0-beta1 | 310 | 1495 day(s) ago | |
| 1.4.2 | 12,935 | 1504 day(s) ago | |
| 1.4.1 | 2,383 | 1539 day(s) ago | |
| 1.4.0 | 430 | 1552 day(s) ago | |
| 1.3.3 | 7,331 | 1568 day(s) ago | |
| 1.3.2 | 815 | 1581 day(s) ago | |
| 1.3.1 | 872 | 1592 day(s) ago | |
| 1.3.0 | 7,499 | 1613 day(s) ago | |
| 1.2.5 | 1,540 | 1650 day(s) ago | |
| 1.2.4 | 1,076 | 1652 day(s) ago | |
| 1.2.3 | 3,626 | 1685 day(s) ago | |
| 1.2.2 | 2,694 | 1706 day(s) ago | |
| 1.2.1 | 1,055 | 1714 day(s) ago | |
| 1.2.0 | 2,342 | 1768 day(s) ago | |
| 1.1.4 | 1,833 | 1784 day(s) ago | |
| 1.1.3 | 617 | 1790 day(s) ago | |
| 1.1.2 | 3,776 | 1810 day(s) ago | |
| 1.1.1 | 6,169 | 1854 day(s) ago | |
| 1.1.0 | 11,430 | 1911 day(s) ago | |
| 1.0.6 | 931 | 1945 day(s) ago | |
| 1.0.5 | 584 | 1960 day(s) ago | |
| 1.0.4 | 1,981 | 1981 day(s) ago | |
| 1.0.3 | 1,226 | 2016 day(s) ago | |
| 1.0.2 | 1,610 | 2028 day(s) ago | |
| 1.0.1 | 463 | 2028 day(s) ago | |
| 0.7.0 | 36,511 | 1915 day(s) ago | |
| 0.6.1 | 461 | 1915 day(s) ago | |
| 0.6.0 | 538 | 1915 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 48 day(s) ago
- Project Site
- License Info
Statistics
- 474574 total downloads
- 1370 downloads of current version
- 68.7 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge