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
# Phobos ![Phobos logo](https://raw.githubusercontent.com/petabridge/phobos-issues/refs/heads/master/phobos_logo_small.png) [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
netstandard2.0
Version Downloads Last Updated
2.11.0 Current 0 3 hour(s) ago
2.10.5 2,589 25 day(s) ago
2.10.4 4,007 75 day(s) ago
2.10.3 75 75 day(s) ago
2.10.2 8,388 144 day(s) ago
2.10.1 2,363 162 day(s) ago
2.10.0 1,421 181 day(s) ago
2.9.1 534 188 day(s) ago
2.9.0 1,134 203 day(s) ago
2.8.5 11,272 277 day(s) ago
2.8.4 3,941 322 day(s) ago
2.8.3 8,070 370 day(s) ago
2.8.2 3,029 404 day(s) ago
2.8.1 959 405 day(s) ago
2.8.0 1,854 411 day(s) ago
2.7.0 1,147 418 day(s) ago
2.6.2 1,527 438 day(s) ago
2.6.1 469 444 day(s) ago
2.6.0 1,508 452 day(s) ago
2.5.4 89,637 614 day(s) ago
2.5.3 1,060 624 day(s) ago
2.5.2 940 630 day(s) ago
2.5.1 18,372 713 day(s) ago
2.5.0 14,777 748 day(s) ago
2.4.5 2,833 782 day(s) ago
2.4.4 917 817 day(s) ago
2.4.3 9,191 824 day(s) ago
2.4.2 9,502 896 day(s) ago
2.4.1 11,999 956 day(s) ago
2.4.0 686 959 day(s) ago
2.3.1 8,645 1014 day(s) ago
2.3.0 11,291 1040 day(s) ago
2.2.1 1,084 1043 day(s) ago
2.2.0 2,155 1096 day(s) ago
2.2.0-beta2 262 1098 day(s) ago
2.1.1 498 873 day(s) ago
2.1.0 2,103 1141 day(s) ago
2.1.0-beta2 515 1230 day(s) ago
2.1.0-beta1 402 1303 day(s) ago
2.0.6 65,822 1362 day(s) ago
2.0.5 402 1365 day(s) ago
2.0.4 368 1370 day(s) ago
2.0.3 380 1377 day(s) ago
2.0.3-beta1 275 1390 day(s) ago
2.0.2 4,532 1414 day(s) ago
2.0.1 474 1420 day(s) ago
2.0.0 380 1421 day(s) ago
2.0.0-beta4 697 1446 day(s) ago
2.0.0-beta3 714 1490 day(s) ago
2.0.0-beta2 273 1491 day(s) ago
2.0.0-beta1 359 1497 day(s) ago
1.6.1 4,494 1043 day(s) ago
1.6.0 369 1048 day(s) ago
1.5.1 13,949 1421 day(s) ago
1.5.0 332 1421 day(s) ago
1.5.0-beta1 262 1446 day(s) ago
1.4.2 12,879 1456 day(s) ago
1.4.1 2,336 1491 day(s) ago
1.4.0 382 1504 day(s) ago
1.3.3 7,281 1520 day(s) ago
1.3.2 769 1533 day(s) ago
1.3.1 824 1544 day(s) ago
1.3.0 7,458 1565 day(s) ago
1.2.5 1,498 1602 day(s) ago
1.2.4 1,034 1604 day(s) ago
1.2.3 3,584 1637 day(s) ago
1.2.2 2,645 1658 day(s) ago
1.2.1 1,008 1666 day(s) ago
1.2.0 2,295 1720 day(s) ago
1.1.4 1,784 1736 day(s) ago
1.1.3 573 1742 day(s) ago
1.1.2 3,733 1762 day(s) ago
1.1.1 6,124 1805 day(s) ago
1.1.0 11,382 1862 day(s) ago
1.0.6 887 1897 day(s) ago
1.0.5 538 1912 day(s) ago
1.0.4 1,936 1932 day(s) ago
1.0.3 1,172 1967 day(s) ago
1.0.2 1,581 1980 day(s) ago
1.0.1 409 1980 day(s) ago
0.8.0 414 1866 day(s) ago
0.7.2 414 1866 day(s) ago
0.7.1 415 1866 day(s) ago
0.7.0 463 1866 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

Statistics

  • 411056 total downloads
  • 0 downloads of current version
  • 230.0 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge