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.0 Current | 5 | 1 day(s) ago | |
| 2.10.5 | 2,733 | 26 day(s) ago | |
| 2.10.4 | 4,017 | 76 day(s) ago | |
| 2.10.3 | 77 | 76 day(s) ago | |
| 2.10.2 | 8,539 | 145 day(s) ago | |
| 2.10.1 | 2,368 | 163 day(s) ago | |
| 2.10.0 | 1,433 | 182 day(s) ago | |
| 2.9.1 | 536 | 189 day(s) ago | |
| 2.9.0 | 1,141 | 204 day(s) ago | |
| 2.8.5 | 11,272 | 278 day(s) ago | |
| 2.8.4 | 3,940 | 323 day(s) ago | |
| 2.8.3 | 8,051 | 371 day(s) ago | |
| 2.8.2 | 3,033 | 405 day(s) ago | |
| 2.8.1 | 960 | 406 day(s) ago | |
| 2.8.0 | 1,856 | 412 day(s) ago | |
| 2.7.0 | 1,117 | 419 day(s) ago | |
| 2.6.2 | 1,528 | 439 day(s) ago | |
| 2.6.1 | 470 | 446 day(s) ago | |
| 2.6.0 | 1,494 | 454 day(s) ago | |
| 2.5.4 | 92,743 | 615 day(s) ago | |
| 2.5.3 | 1,065 | 625 day(s) ago | |
| 2.5.2 | 924 | 631 day(s) ago | |
| 2.5.1 | 18,132 | 714 day(s) ago | |
| 2.5.0 | 14,757 | 750 day(s) ago | |
| 2.4.5 | 2,837 | 784 day(s) ago | |
| 2.4.4 | 920 | 818 day(s) ago | |
| 2.4.3 | 9,201 | 825 day(s) ago | |
| 2.4.2 | 9,469 | 897 day(s) ago | |
| 2.4.1 | 11,883 | 957 day(s) ago | |
| 2.4.0 | 684 | 960 day(s) ago | |
| 2.3.1 | 8,529 | 1015 day(s) ago | |
| 2.3.0 | 11,482 | 1041 day(s) ago | |
| 2.2.1 | 1,140 | 1044 day(s) ago | |
| 2.2.0 | 2,160 | 1097 day(s) ago | |
| 2.2.0-beta2 | 263 | 1099 day(s) ago | |
| 2.1.1 | 500 | 874 day(s) ago | |
| 2.1.0 | 2,103 | 1142 day(s) ago | |
| 2.1.0-beta2 | 517 | 1231 day(s) ago | |
| 2.1.0-beta1 | 403 | 1304 day(s) ago | |
| 2.0.6 | 65,860 | 1363 day(s) ago | |
| 2.0.5 | 400 | 1367 day(s) ago | |
| 2.0.4 | 367 | 1371 day(s) ago | |
| 2.0.3 | 382 | 1378 day(s) ago | |
| 2.0.3-beta1 | 274 | 1391 day(s) ago | |
| 2.0.2 | 4,529 | 1415 day(s) ago | |
| 2.0.1 | 474 | 1421 day(s) ago | |
| 2.0.0 | 364 | 1422 day(s) ago | |
| 2.0.0-beta4 | 699 | 1447 day(s) ago | |
| 2.0.0-beta3 | 716 | 1491 day(s) ago | |
| 2.0.0-beta2 | 274 | 1492 day(s) ago | |
| 2.0.0-beta1 | 361 | 1498 day(s) ago | |
| 1.6.1 | 4,537 | 1044 day(s) ago | |
| 1.6.0 | 422 | 1049 day(s) ago | |
| 1.5.1 | 13,949 | 1422 day(s) ago | |
| 1.5.0 | 333 | 1422 day(s) ago | |
| 1.5.0-beta1 | 263 | 1447 day(s) ago | |
| 1.4.2 | 12,868 | 1457 day(s) ago | |
| 1.4.1 | 2,336 | 1492 day(s) ago | |
| 1.4.0 | 383 | 1505 day(s) ago | |
| 1.3.3 | 7,284 | 1521 day(s) ago | |
| 1.3.2 | 768 | 1534 day(s) ago | |
| 1.3.1 | 825 | 1545 day(s) ago | |
| 1.3.0 | 7,452 | 1566 day(s) ago | |
| 1.2.5 | 1,493 | 1603 day(s) ago | |
| 1.2.4 | 1,029 | 1605 day(s) ago | |
| 1.2.3 | 3,579 | 1638 day(s) ago | |
| 1.2.2 | 2,647 | 1659 day(s) ago | |
| 1.2.1 | 1,008 | 1667 day(s) ago | |
| 1.2.0 | 2,295 | 1721 day(s) ago | |
| 1.1.4 | 1,786 | 1737 day(s) ago | |
| 1.1.3 | 570 | 1743 day(s) ago | |
| 1.1.2 | 3,729 | 1763 day(s) ago | |
| 1.1.1 | 6,122 | 1806 day(s) ago | |
| 1.1.0 | 11,383 | 1864 day(s) ago | |
| 1.0.6 | 884 | 1898 day(s) ago | |
| 1.0.5 | 536 | 1913 day(s) ago | |
| 1.0.4 | 1,934 | 1934 day(s) ago | |
| 1.0.3 | 1,179 | 1968 day(s) ago | |
| 1.0.2 | 1,563 | 1981 day(s) ago | |
| 1.0.1 | 416 | 1981 day(s) ago | |
| 0.7.0 | 36,464 | 1868 day(s) ago | |
| 0.6.1 | 414 | 1868 day(s) ago | |
| 0.6.0 | 460 | 1868 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 1 day(s) ago
- Project Site
- License Info
Statistics
- 449893 total downloads
- 5 downloads of current version
- 68.7 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge