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.0 Current | 5 | 5 hour(s) ago | |
| 2.12.1 | 1,419 | 27 day(s) ago | |
| 2.12.0 | 16,142 | 147 day(s) ago | |
| 2.11.3 | 2,522 | 168 day(s) ago | |
| 2.11.2 | 354 | 175 day(s) ago | |
| 2.11.1 | 325 | 176 day(s) ago | |
| 2.11.0 | 1,859 | 204 day(s) ago | |
| 2.10.5 | 16,623 | 229 day(s) ago | |
| 2.10.4 | 6,590 | 279 day(s) ago | |
| 2.10.3 | 276 | 279 day(s) ago | |
| 2.10.2 | 28,559 | 348 day(s) ago | |
| 2.10.1 | 2,600 | 366 day(s) ago | |
| 2.10.0 | 1,982 | 385 day(s) ago | |
| 2.9.1 | 749 | 392 day(s) ago | |
| 2.9.0 | 1,473 | 407 day(s) ago | |
| 2.8.5 | 11,629 | 481 day(s) ago | |
| 2.8.4 | 4,538 | 526 day(s) ago | |
| 2.8.3 | 8,477 | 574 day(s) ago | |
| 2.8.2 | 3,473 | 608 day(s) ago | |
| 2.8.1 | 1,160 | 609 day(s) ago | |
| 2.8.0 | 2,055 | 615 day(s) ago | |
| 2.7.0 | 1,350 | 622 day(s) ago | |
| 2.6.2 | 1,728 | 642 day(s) ago | |
| 2.6.1 | 670 | 649 day(s) ago | |
| 2.6.0 | 1,709 | 657 day(s) ago | |
| 2.5.4 | 99,273 | 818 day(s) ago | |
| 2.5.3 | 1,261 | 828 day(s) ago | |
| 2.5.2 | 1,141 | 834 day(s) ago | |
| 2.5.1 | 19,325 | 917 day(s) ago | |
| 2.5.0 | 24,652 | 953 day(s) ago | |
| 2.4.5 | 3,035 | 987 day(s) ago | |
| 2.4.4 | 1,118 | 1021 day(s) ago | |
| 2.4.3 | 9,949 | 1028 day(s) ago | |
| 2.4.2 | 12,295 | 1100 day(s) ago | |
| 2.4.1 | 12,200 | 1160 day(s) ago | |
| 2.4.0 | 887 | 1163 day(s) ago | |
| 2.3.1 | 8,846 | 1218 day(s) ago | |
| 2.3.0 | 13,008 | 1244 day(s) ago | |
| 2.2.1 | 1,285 | 1247 day(s) ago | |
| 2.2.0 | 2,356 | 1300 day(s) ago | |
| 2.2.0-beta2 | 463 | 1302 day(s) ago | |
| 2.1.1 | 708 | 1077 day(s) ago | |
| 2.1.0 | 2,304 | 1345 day(s) ago | |
| 2.1.0-beta2 | 716 | 1434 day(s) ago | |
| 2.1.0-beta1 | 603 | 1507 day(s) ago | |
| 2.0.6 | 66,038 | 1566 day(s) ago | |
| 2.0.5 | 603 | 1570 day(s) ago | |
| 2.0.4 | 569 | 1574 day(s) ago | |
| 2.0.3 | 581 | 1581 day(s) ago | |
| 2.0.3-beta1 | 476 | 1594 day(s) ago | |
| 2.0.2 | 4,733 | 1618 day(s) ago | |
| 2.0.1 | 675 | 1624 day(s) ago | |
| 2.0.0 | 581 | 1625 day(s) ago | |
| 2.0.0-beta4 | 898 | 1650 day(s) ago | |
| 2.0.0-beta3 | 915 | 1694 day(s) ago | |
| 2.0.0-beta2 | 474 | 1695 day(s) ago | |
| 2.0.0-beta1 | 560 | 1701 day(s) ago | |
| 1.6.1 | 4,695 | 1247 day(s) ago | |
| 1.6.0 | 570 | 1252 day(s) ago | |
| 1.5.1 | 14,209 | 1625 day(s) ago | |
| 1.5.0 | 533 | 1625 day(s) ago | |
| 1.5.0-beta1 | 463 | 1650 day(s) ago | |
| 1.4.2 | 13,192 | 1660 day(s) ago | |
| 1.4.1 | 2,537 | 1695 day(s) ago | |
| 1.4.0 | 583 | 1708 day(s) ago | |
| 1.3.3 | 7,482 | 1724 day(s) ago | |
| 1.3.2 | 970 | 1737 day(s) ago | |
| 1.3.1 | 1,025 | 1748 day(s) ago | |
| 1.3.0 | 7,659 | 1769 day(s) ago | |
| 1.2.5 | 1,699 | 1806 day(s) ago | |
| 1.2.4 | 1,235 | 1808 day(s) ago | |
| 1.2.3 | 3,785 | 1841 day(s) ago | |
| 1.2.2 | 2,846 | 1862 day(s) ago | |
| 1.2.1 | 1,209 | 1870 day(s) ago | |
| 1.2.0 | 2,496 | 1924 day(s) ago | |
| 1.1.4 | 1,985 | 1940 day(s) ago | |
| 1.1.3 | 774 | 1946 day(s) ago | |
| 1.1.2 | 3,934 | 1966 day(s) ago | |
| 1.1.1 | 6,325 | 2009 day(s) ago | |
| 1.1.0 | 11,583 | 2067 day(s) ago | |
| 1.0.6 | 1,088 | 2101 day(s) ago | |
| 1.0.5 | 739 | 2116 day(s) ago | |
| 1.0.4 | 2,137 | 2137 day(s) ago | |
| 1.0.3 | 1,373 | 2171 day(s) ago | |
| 1.0.2 | 1,782 | 2184 day(s) ago | |
| 1.0.1 | 610 | 2184 day(s) ago | |
| 0.8.0 | 615 | 2071 day(s) ago | |
| 0.7.2 | 615 | 2071 day(s) ago | |
| 0.7.1 | 616 | 2071 day(s) ago | |
| 0.7.0 | 725 | 2071 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 5 hour(s) ago
- Project Site
- License Info
Statistics
- 512884 total downloads
- 5 downloads of current version
- 255.7 KB package size
Owners and Products
Petabridge
Authors
Petabridge
Copyright
Copyright © 2017-2026 Petabridge