Phobos.Actor 2.11.0
Automatic Akka.NET tracing and monitoring integration as part of the Phobos Enterprise Framework.
Install-Package Phobos.Actor -Version 2.11.0
dotnet add package Phobos.Actor --version 2.11.0
<PackageReference Include="Phobos.Actor" Version="2.11.0" />
paket add Phobos.Actor --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
- Phobos.Monitoring (>=2.11.0)
- Phobos.Tracing (>=2.11.0)
- Akka.Cluster (>=1.5.61)
- Akka.Persistence (>=1.5.61)
- Phobos.Actor.Common (>=1.1.2)
netstandard2.0
- Phobos.Monitoring (>=2.11.0)
- Phobos.Tracing (>=2.11.0)
- Akka.Cluster (>=1.5.61)
- Akka.Persistence (>=1.5.61)
- Phobos.Actor.Common (>=1.1.2)
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 2.12.0 | 966 | 10 day(s) ago | |
| 2.11.3 | 1,691 | 31 day(s) ago | |
| 2.11.2 | 220 | 38 day(s) ago | |
| 2.11.1 | 85 | 39 day(s) ago | |
| 2.11.0 Current | 1,598 | 67 day(s) ago | |
| 2.10.5 | 7,225 | 92 day(s) ago | |
| 2.10.4 | 5,196 | 142 day(s) ago | |
| 2.10.3 | 142 | 142 day(s) ago | |
| 2.10.2 | 18,161 | 211 day(s) ago | |
| 2.10.1 | 2,452 | 229 day(s) ago | |
| 2.10.0 | 1,598 | 248 day(s) ago | |
| 2.9.1 | 601 | 255 day(s) ago | |
| 2.9.0 | 1,338 | 270 day(s) ago | |
| 2.8.5 | 11,425 | 344 day(s) ago | |
| 2.8.4 | 4,200 | 389 day(s) ago | |
| 2.8.3 | 8,220 | 437 day(s) ago | |
| 2.8.2 | 3,154 | 471 day(s) ago | |
| 2.8.1 | 1,026 | 472 day(s) ago | |
| 2.8.0 | 1,921 | 478 day(s) ago | |
| 2.7.0 | 1,216 | 485 day(s) ago | |
| 2.6.2 | 1,594 | 505 day(s) ago | |
| 2.6.1 | 536 | 511 day(s) ago | |
| 2.6.0 | 1,575 | 519 day(s) ago | |
| 2.5.4 | 93,323 | 681 day(s) ago | |
| 2.5.3 | 1,127 | 691 day(s) ago | |
| 2.5.2 | 1,007 | 697 day(s) ago | |
| 2.5.1 | 18,614 | 780 day(s) ago | |
| 2.5.0 | 17,931 | 815 day(s) ago | |
| 2.4.5 | 2,901 | 849 day(s) ago | |
| 2.4.4 | 984 | 884 day(s) ago | |
| 2.4.3 | 9,683 | 891 day(s) ago | |
| 2.4.2 | 10,310 | 963 day(s) ago | |
| 2.4.1 | 12,066 | 1023 day(s) ago | |
| 2.4.0 | 753 | 1025 day(s) ago | |
| 2.3.1 | 8,712 | 1081 day(s) ago | |
| 2.3.0 | 12,105 | 1107 day(s) ago | |
| 2.2.1 | 1,151 | 1110 day(s) ago | |
| 2.2.0 | 2,222 | 1163 day(s) ago | |
| 2.2.0-beta2 | 329 | 1165 day(s) ago | |
| 2.1.1 | 569 | 940 day(s) ago | |
| 2.1.0 | 2,170 | 1208 day(s) ago | |
| 2.1.0-beta2 | 582 | 1297 day(s) ago | |
| 2.1.0-beta1 | 469 | 1370 day(s) ago | |
| 2.0.6 | 65,894 | 1429 day(s) ago | |
| 2.0.5 | 469 | 1432 day(s) ago | |
| 2.0.4 | 435 | 1437 day(s) ago | |
| 2.0.3 | 447 | 1444 day(s) ago | |
| 2.0.3-beta1 | 342 | 1457 day(s) ago | |
| 2.0.2 | 4,599 | 1481 day(s) ago | |
| 2.0.1 | 541 | 1487 day(s) ago | |
| 2.0.0 | 447 | 1488 day(s) ago | |
| 2.0.0-beta4 | 764 | 1513 day(s) ago | |
| 2.0.0-beta3 | 781 | 1557 day(s) ago | |
| 2.0.0-beta2 | 340 | 1558 day(s) ago | |
| 2.0.0-beta1 | 426 | 1564 day(s) ago | |
| 1.6.1 | 4,561 | 1110 day(s) ago | |
| 1.6.0 | 436 | 1115 day(s) ago | |
| 1.5.1 | 14,050 | 1488 day(s) ago | |
| 1.5.0 | 399 | 1488 day(s) ago | |
| 1.5.0-beta1 | 329 | 1513 day(s) ago | |
| 1.4.2 | 12,991 | 1522 day(s) ago | |
| 1.4.1 | 2,403 | 1558 day(s) ago | |
| 1.4.0 | 449 | 1571 day(s) ago | |
| 1.3.3 | 7,348 | 1587 day(s) ago | |
| 1.3.2 | 836 | 1600 day(s) ago | |
| 1.3.1 | 891 | 1611 day(s) ago | |
| 1.3.0 | 7,525 | 1632 day(s) ago | |
| 1.2.5 | 1,565 | 1669 day(s) ago | |
| 1.2.4 | 1,101 | 1671 day(s) ago | |
| 1.2.3 | 3,651 | 1704 day(s) ago | |
| 1.2.2 | 2,712 | 1725 day(s) ago | |
| 1.2.1 | 1,075 | 1733 day(s) ago | |
| 1.2.0 | 2,362 | 1787 day(s) ago | |
| 1.1.4 | 1,851 | 1803 day(s) ago | |
| 1.1.3 | 640 | 1808 day(s) ago | |
| 1.1.2 | 3,800 | 1829 day(s) ago | |
| 1.1.1 | 6,191 | 1872 day(s) ago | |
| 1.1.0 | 11,449 | 1929 day(s) ago | |
| 1.0.6 | 954 | 1964 day(s) ago | |
| 1.0.5 | 605 | 1979 day(s) ago | |
| 1.0.4 | 2,003 | 1999 day(s) ago | |
| 1.0.3 | 1,239 | 2034 day(s) ago | |
| 1.0.2 | 1,648 | 2046 day(s) ago | |
| 1.0.1 | 476 | 2046 day(s) ago | |
| 0.8.0 | 481 | 1933 day(s) ago | |
| 0.7.2 | 481 | 1933 day(s) ago | |
| 0.7.1 | 482 | 1933 day(s) ago | |
| 0.7.0 | 562 | 1933 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 67 day(s) ago
- Project Site
- License Info
Statistics
- 446179 total downloads
- 1598 downloads of current version
- 230.0 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge