Phobos.Actor 2.13.0
Automatic Akka.NET tracing and monitoring integration as part of the Phobos Enterprise Framework.
Install-Package Phobos.Actor -Version 2.13.0
dotnet add package Phobos.Actor --version 2.13.0
<PackageReference Include="Phobos.Actor" Version="2.13.0" />
paket add Phobos.Actor --version 2.13.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.13.0)
- Phobos.Tracing (>=2.13.0)
- Akka.Cluster (>=1.5.71)
- Akka.Persistence (>=1.5.71)
- Phobos.Actor.Common (>=1.1.2)
netstandard2.0
- Phobos.Monitoring (>=2.13.0)
- Phobos.Tracing (>=2.13.0)
- Akka.Cluster (>=1.5.71)
- Akka.Persistence (>=1.5.71)
- Phobos.Actor.Common (>=1.1.2)
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 2.13.1 | 1,062 | 41 day(s) ago | |
| 2.13.0 Current | 64 | 52 day(s) ago | |
| 2.12.1 | 5,768 | 80 day(s) ago | |
| 2.12.0 | 21,299 | 200 day(s) ago | |
| 2.11.3 | 3,210 | 221 day(s) ago | |
| 2.11.2 | 402 | 228 day(s) ago | |
| 2.11.1 | 416 | 229 day(s) ago | |
| 2.11.0 | 2,006 | 256 day(s) ago | |
| 2.10.5 | 21,376 | 282 day(s) ago | |
| 2.10.4 | 6,712 | 331 day(s) ago | |
| 2.10.3 | 324 | 332 day(s) ago | |
| 2.10.2 | 29,578 | 401 day(s) ago | |
| 2.10.1 | 2,648 | 418 day(s) ago | |
| 2.10.0 | 2,112 | 438 day(s) ago | |
| 2.9.1 | 797 | 444 day(s) ago | |
| 2.9.0 | 1,521 | 459 day(s) ago | |
| 2.8.5 | 11,857 | 534 day(s) ago | |
| 2.8.4 | 4,644 | 579 day(s) ago | |
| 2.8.3 | 8,525 | 627 day(s) ago | |
| 2.8.2 | 3,658 | 661 day(s) ago | |
| 2.8.1 | 1,208 | 661 day(s) ago | |
| 2.8.0 | 2,103 | 668 day(s) ago | |
| 2.7.0 | 1,398 | 675 day(s) ago | |
| 2.6.2 | 1,776 | 695 day(s) ago | |
| 2.6.1 | 718 | 701 day(s) ago | |
| 2.6.0 | 1,757 | 709 day(s) ago | |
| 2.5.4 | 105,158 | 871 day(s) ago | |
| 2.5.3 | 1,309 | 881 day(s) ago | |
| 2.5.2 | 1,189 | 887 day(s) ago | |
| 2.5.1 | 19,922 | 969 day(s) ago | |
| 2.5.0 | 26,008 | 1005 day(s) ago | |
| 2.4.5 | 3,083 | 1039 day(s) ago | |
| 2.4.4 | 1,166 | 1074 day(s) ago | |
| 2.4.3 | 10,130 | 1081 day(s) ago | |
| 2.4.2 | 12,775 | 1152 day(s) ago | |
| 2.4.1 | 12,248 | 1213 day(s) ago | |
| 2.4.0 | 935 | 1215 day(s) ago | |
| 2.3.1 | 8,894 | 1271 day(s) ago | |
| 2.3.0 | 13,056 | 1297 day(s) ago | |
| 2.2.1 | 1,333 | 1299 day(s) ago | |
| 2.2.0 | 2,404 | 1353 day(s) ago | |
| 2.2.0-beta2 | 511 | 1354 day(s) ago | |
| 2.1.1 | 756 | 1130 day(s) ago | |
| 2.1.0 | 2,352 | 1398 day(s) ago | |
| 2.1.0-beta2 | 764 | 1486 day(s) ago | |
| 2.1.0-beta1 | 651 | 1560 day(s) ago | |
| 2.0.6 | 66,087 | 1618 day(s) ago | |
| 2.0.5 | 651 | 1622 day(s) ago | |
| 2.0.4 | 617 | 1627 day(s) ago | |
| 2.0.3 | 629 | 1634 day(s) ago | |
| 2.0.3-beta1 | 524 | 1647 day(s) ago | |
| 2.0.2 | 4,781 | 1671 day(s) ago | |
| 2.0.1 | 723 | 1677 day(s) ago | |
| 2.0.0 | 629 | 1677 day(s) ago | |
| 2.0.0-beta4 | 946 | 1703 day(s) ago | |
| 2.0.0-beta3 | 963 | 1747 day(s) ago | |
| 2.0.0-beta2 | 522 | 1747 day(s) ago | |
| 2.0.0-beta1 | 608 | 1753 day(s) ago | |
| 1.6.1 | 4,743 | 1300 day(s) ago | |
| 1.6.0 | 618 | 1305 day(s) ago | |
| 1.5.1 | 14,258 | 1677 day(s) ago | |
| 1.5.0 | 581 | 1677 day(s) ago | |
| 1.5.0-beta1 | 511 | 1703 day(s) ago | |
| 1.4.2 | 13,267 | 1712 day(s) ago | |
| 1.4.1 | 2,585 | 1747 day(s) ago | |
| 1.4.0 | 631 | 1761 day(s) ago | |
| 1.3.3 | 7,530 | 1776 day(s) ago | |
| 1.3.2 | 1,018 | 1790 day(s) ago | |
| 1.3.1 | 1,073 | 1801 day(s) ago | |
| 1.3.0 | 7,707 | 1822 day(s) ago | |
| 1.2.5 | 1,747 | 1859 day(s) ago | |
| 1.2.4 | 1,283 | 1860 day(s) ago | |
| 1.2.3 | 3,833 | 1893 day(s) ago | |
| 1.2.2 | 2,894 | 1915 day(s) ago | |
| 1.2.1 | 1,257 | 1923 day(s) ago | |
| 1.2.0 | 2,544 | 1976 day(s) ago | |
| 1.1.4 | 2,033 | 1993 day(s) ago | |
| 1.1.3 | 822 | 1998 day(s) ago | |
| 1.1.2 | 3,982 | 2018 day(s) ago | |
| 1.1.1 | 6,373 | 2062 day(s) ago | |
| 1.1.0 | 11,631 | 2119 day(s) ago | |
| 1.0.6 | 1,136 | 2154 day(s) ago | |
| 1.0.5 | 787 | 2168 day(s) ago | |
| 1.0.4 | 2,185 | 2189 day(s) ago | |
| 1.0.3 | 1,421 | 2224 day(s) ago | |
| 1.0.2 | 1,830 | 2236 day(s) ago | |
| 1.0.1 | 658 | 2236 day(s) ago | |
| 0.8.0 | 663 | 2123 day(s) ago | |
| 0.7.2 | 663 | 2123 day(s) ago | |
| 0.7.1 | 664 | 2123 day(s) ago | |
| 0.7.0 | 773 | 2123 day(s) ago |
**Phobos 2.x Maintenance Release**
**Bug Fixes**
- Fixed receive metrics (and the matching receive-span `messageType` attribute) to label the inner wrapped payload instead of the outer envelope type. Application code that unpacks `IWrappedMessage` envelopes can now get per-message breakdowns by the business message actually being processed, rather than the generic wrapper type. See [phobos-issues#96](https://github.com/petabridge/phobos-issues/issues/96).
- Fixed explicit child and runtime instrumentation settings being overridden for `Cluster.Sharding` entities. A child's own `WithInstrumentation` (and runtime settings) now takes precedence over settings propagated from its parent, so sharded/custom entities can opt out of or fine-tune tracing even when propagation is enabled. See [phobos-issues#98](https://github.com/petabridge/phobos-issues/issues/98).
Info
- last updated 52 day(s) ago
- Project Site
- License Info
Statistics
- 542964 total downloads
- 64 downloads of current version
- 255.7 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge