Phobos.Tracing 2.11.0

Distributed tracing support for Akka.NET ActorSystems.

Install-Package Phobos.Tracing -Version 2.11.0
dotnet add package Phobos.Tracing --version 2.11.0
<PackageReference Include="Phobos.Tracing" Version="2.11.0" />
paket add Phobos.Tracing --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.3 820 13 day(s) ago
2.11.2 203 19 day(s) ago
2.11.1 52 20 day(s) ago
2.11.0 Current 1,370 48 day(s) ago
2.10.5 6,242 73 day(s) ago
2.10.4 4,837 123 day(s) ago
2.10.3 125 123 day(s) ago
2.10.2 14,224 193 day(s) ago
2.10.1 2,426 210 day(s) ago
2.10.0 1,541 229 day(s) ago
2.9.1 584 236 day(s) ago
2.9.0 1,320 251 day(s) ago
2.8.5 11,346 325 day(s) ago
2.8.4 4,086 371 day(s) ago
2.8.3 8,154 418 day(s) ago
2.8.2 3,124 452 day(s) ago
2.8.1 1,007 453 day(s) ago
2.8.0 1,903 460 day(s) ago
2.7.0 1,165 467 day(s) ago
2.6.2 1,575 486 day(s) ago
2.6.1 517 493 day(s) ago
2.6.0 1,541 501 day(s) ago
2.5.4 96,561 662 day(s) ago
2.5.3 1,112 672 day(s) ago
2.5.2 971 678 day(s) ago
2.5.1 18,310 761 day(s) ago
2.5.0 17,064 797 day(s) ago
2.4.5 2,884 831 day(s) ago
2.4.4 967 866 day(s) ago
2.4.3 9,620 873 day(s) ago
2.4.2 10,240 944 day(s) ago
2.4.1 11,930 1004 day(s) ago
2.4.0 731 1007 day(s) ago
2.3.1 8,576 1062 day(s) ago
2.3.0 12,259 1088 day(s) ago
2.2.1 1,187 1091 day(s) ago
2.2.0 2,207 1144 day(s) ago
2.2.0-beta2 310 1146 day(s) ago
2.1.1 550 921 day(s) ago
2.1.0 2,150 1190 day(s) ago
2.1.0-beta2 564 1278 day(s) ago
2.1.0-beta1 450 1351 day(s) ago
2.0.6 65,911 1410 day(s) ago
2.0.5 447 1414 day(s) ago
2.0.4 414 1418 day(s) ago
2.0.3 429 1425 day(s) ago
2.0.3-beta1 321 1439 day(s) ago
2.0.2 4,576 1462 day(s) ago
2.0.1 521 1468 day(s) ago
2.0.0 411 1469 day(s) ago
2.0.0-beta4 747 1495 day(s) ago
2.0.0-beta3 764 1538 day(s) ago
2.0.0-beta2 321 1539 day(s) ago
2.0.0-beta1 409 1545 day(s) ago
1.6.1 4,584 1091 day(s) ago
1.6.0 469 1096 day(s) ago
1.5.1 14,027 1469 day(s) ago
1.5.0 380 1469 day(s) ago
1.5.0-beta1 310 1495 day(s) ago
1.4.2 12,935 1504 day(s) ago
1.4.1 2,383 1539 day(s) ago
1.4.0 430 1552 day(s) ago
1.3.3 7,331 1568 day(s) ago
1.3.2 815 1581 day(s) ago
1.3.1 872 1592 day(s) ago
1.3.0 7,499 1613 day(s) ago
1.2.5 1,540 1650 day(s) ago
1.2.4 1,076 1652 day(s) ago
1.2.3 3,626 1685 day(s) ago
1.2.2 2,694 1706 day(s) ago
1.2.1 1,055 1714 day(s) ago
1.2.0 2,342 1768 day(s) ago
1.1.4 1,833 1784 day(s) ago
1.1.3 617 1790 day(s) ago
1.1.2 3,776 1810 day(s) ago
1.1.1 6,169 1854 day(s) ago
1.1.0 11,430 1911 day(s) ago
1.0.6 931 1945 day(s) ago
1.0.5 584 1960 day(s) ago
1.0.4 1,981 1981 day(s) ago
1.0.3 1,226 2016 day(s) ago
1.0.2 1,610 2028 day(s) ago
1.0.1 463 2028 day(s) ago
0.7.0 36,511 1915 day(s) ago
0.6.1 461 1915 day(s) ago
0.6.0 538 1915 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

  • 474574 total downloads
  • 1370 downloads of current version
  • 68.7 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge