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 | 11,175 | 104 day(s) ago | |
| 2.11.3 | 2,390 | 125 day(s) ago | |
| 2.11.2 | 311 | 131 day(s) ago | |
| 2.11.1 | 248 | 132 day(s) ago | |
| 2.11.0 Current | 1,783 | 160 day(s) ago | |
| 2.10.5 | 13,644 | 185 day(s) ago | |
| 2.10.4 | 6,236 | 235 day(s) ago | |
| 2.10.3 | 233 | 235 day(s) ago | |
| 2.10.2 | 27,117 | 305 day(s) ago | |
| 2.10.1 | 2,557 | 322 day(s) ago | |
| 2.10.0 | 1,882 | 341 day(s) ago | |
| 2.9.1 | 703 | 348 day(s) ago | |
| 2.9.0 | 1,430 | 363 day(s) ago | |
| 2.8.5 | 11,580 | 437 day(s) ago | |
| 2.8.4 | 4,447 | 483 day(s) ago | |
| 2.8.3 | 8,423 | 530 day(s) ago | |
| 2.8.2 | 3,370 | 564 day(s) ago | |
| 2.8.1 | 1,117 | 565 day(s) ago | |
| 2.8.0 | 2,012 | 572 day(s) ago | |
| 2.7.0 | 1,307 | 579 day(s) ago | |
| 2.6.2 | 1,685 | 598 day(s) ago | |
| 2.6.1 | 627 | 605 day(s) ago | |
| 2.6.0 | 1,666 | 613 day(s) ago | |
| 2.5.4 | 97,497 | 774 day(s) ago | |
| 2.5.3 | 1,218 | 784 day(s) ago | |
| 2.5.2 | 1,098 | 790 day(s) ago | |
| 2.5.1 | 19,057 | 873 day(s) ago | |
| 2.5.0 | 21,977 | 909 day(s) ago | |
| 2.4.5 | 2,992 | 943 day(s) ago | |
| 2.4.4 | 1,075 | 978 day(s) ago | |
| 2.4.3 | 9,810 | 985 day(s) ago | |
| 2.4.2 | 11,594 | 1056 day(s) ago | |
| 2.4.1 | 12,157 | 1116 day(s) ago | |
| 2.4.0 | 844 | 1119 day(s) ago | |
| 2.3.1 | 8,803 | 1174 day(s) ago | |
| 2.3.0 | 12,963 | 1200 day(s) ago | |
| 2.2.1 | 1,242 | 1203 day(s) ago | |
| 2.2.0 | 2,313 | 1257 day(s) ago | |
| 2.2.0-beta2 | 420 | 1258 day(s) ago | |
| 2.1.1 | 665 | 1033 day(s) ago | |
| 2.1.0 | 2,261 | 1302 day(s) ago | |
| 2.1.0-beta2 | 673 | 1390 day(s) ago | |
| 2.1.0-beta1 | 560 | 1463 day(s) ago | |
| 2.0.6 | 65,995 | 1522 day(s) ago | |
| 2.0.5 | 560 | 1526 day(s) ago | |
| 2.0.4 | 526 | 1530 day(s) ago | |
| 2.0.3 | 538 | 1537 day(s) ago | |
| 2.0.3-beta1 | 433 | 1551 day(s) ago | |
| 2.0.2 | 4,690 | 1574 day(s) ago | |
| 2.0.1 | 632 | 1580 day(s) ago | |
| 2.0.0 | 538 | 1581 day(s) ago | |
| 2.0.0-beta4 | 855 | 1607 day(s) ago | |
| 2.0.0-beta3 | 872 | 1650 day(s) ago | |
| 2.0.0-beta2 | 431 | 1651 day(s) ago | |
| 2.0.0-beta1 | 517 | 1657 day(s) ago | |
| 1.6.1 | 4,652 | 1203 day(s) ago | |
| 1.6.0 | 527 | 1208 day(s) ago | |
| 1.5.1 | 14,164 | 1581 day(s) ago | |
| 1.5.0 | 490 | 1581 day(s) ago | |
| 1.5.0-beta1 | 420 | 1607 day(s) ago | |
| 1.4.2 | 13,120 | 1616 day(s) ago | |
| 1.4.1 | 2,494 | 1651 day(s) ago | |
| 1.4.0 | 540 | 1664 day(s) ago | |
| 1.3.3 | 7,439 | 1680 day(s) ago | |
| 1.3.2 | 927 | 1693 day(s) ago | |
| 1.3.1 | 982 | 1704 day(s) ago | |
| 1.3.0 | 7,616 | 1725 day(s) ago | |
| 1.2.5 | 1,656 | 1762 day(s) ago | |
| 1.2.4 | 1,192 | 1764 day(s) ago | |
| 1.2.3 | 3,742 | 1797 day(s) ago | |
| 1.2.2 | 2,803 | 1818 day(s) ago | |
| 1.2.1 | 1,166 | 1826 day(s) ago | |
| 1.2.0 | 2,453 | 1880 day(s) ago | |
| 1.1.4 | 1,942 | 1896 day(s) ago | |
| 1.1.3 | 731 | 1902 day(s) ago | |
| 1.1.2 | 3,891 | 1922 day(s) ago | |
| 1.1.1 | 6,282 | 1966 day(s) ago | |
| 1.1.0 | 11,540 | 2023 day(s) ago | |
| 1.0.6 | 1,045 | 2057 day(s) ago | |
| 1.0.5 | 696 | 2072 day(s) ago | |
| 1.0.4 | 2,094 | 2093 day(s) ago | |
| 1.0.3 | 1,330 | 2128 day(s) ago | |
| 1.0.2 | 1,739 | 2140 day(s) ago | |
| 1.0.1 | 567 | 2140 day(s) ago | |
| 0.8.0 | 572 | 2027 day(s) ago | |
| 0.7.2 | 572 | 2027 day(s) ago | |
| 0.7.1 | 573 | 2027 day(s) ago | |
| 0.7.0 | 682 | 2027 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 160 day(s) ago
- Project Site
- License Info
Statistics
- 492388 total downloads
- 1783 downloads of current version
- 230.0 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge