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.12.0 11,156 104 day(s) ago
2.11.3 2,387 125 day(s) ago
2.11.2 316 131 day(s) ago
2.11.1 249 132 day(s) ago
2.11.0 Current 1,786 160 day(s) ago
2.10.5 13,646 185 day(s) ago
2.10.4 6,231 235 day(s) ago
2.10.3 238 235 day(s) ago
2.10.2 27,116 305 day(s) ago
2.10.1 2,557 322 day(s) ago
2.10.0 1,886 341 day(s) ago
2.9.1 705 348 day(s) ago
2.9.0 1,432 363 day(s) ago
2.8.5 11,538 437 day(s) ago
2.8.4 4,446 483 day(s) ago
2.8.3 8,404 530 day(s) ago
2.8.2 3,374 564 day(s) ago
2.8.1 1,119 565 day(s) ago
2.8.0 2,015 572 day(s) ago
2.7.0 1,278 579 day(s) ago
2.6.2 1,687 598 day(s) ago
2.6.1 626 605 day(s) ago
2.6.0 1,650 613 day(s) ago
2.5.4 104,636 774 day(s) ago
2.5.3 1,224 784 day(s) ago
2.5.2 1,080 790 day(s) ago
2.5.1 18,811 873 day(s) ago
2.5.0 21,959 909 day(s) ago
2.4.5 2,998 943 day(s) ago
2.4.4 1,077 978 day(s) ago
2.4.3 9,801 985 day(s) ago
2.4.2 11,556 1056 day(s) ago
2.4.1 12,039 1116 day(s) ago
2.4.0 844 1119 day(s) ago
2.3.1 8,688 1174 day(s) ago
2.3.0 13,063 1200 day(s) ago
2.2.1 1,297 1203 day(s) ago
2.2.0 2,317 1257 day(s) ago
2.2.0-beta2 422 1258 day(s) ago
2.1.1 665 1033 day(s) ago
2.1.0 2,263 1302 day(s) ago
2.1.0-beta2 675 1390 day(s) ago
2.1.0-beta1 561 1463 day(s) ago
2.0.6 66,032 1522 day(s) ago
2.0.5 557 1526 day(s) ago
2.0.4 524 1530 day(s) ago
2.0.3 541 1537 day(s) ago
2.0.3-beta1 431 1551 day(s) ago
2.0.2 4,686 1574 day(s) ago
2.0.1 632 1580 day(s) ago
2.0.0 523 1581 day(s) ago
2.0.0-beta4 858 1607 day(s) ago
2.0.0-beta3 875 1650 day(s) ago
2.0.0-beta2 432 1651 day(s) ago
2.0.0-beta1 519 1657 day(s) ago
1.6.1 4,695 1203 day(s) ago
1.6.0 580 1208 day(s) ago
1.5.1 14,163 1581 day(s) ago
1.5.0 489 1581 day(s) ago
1.5.0-beta1 419 1607 day(s) ago
1.4.2 13,107 1616 day(s) ago
1.4.1 2,492 1651 day(s) ago
1.4.0 540 1664 day(s) ago
1.3.3 7,440 1680 day(s) ago
1.3.2 925 1693 day(s) ago
1.3.1 981 1704 day(s) ago
1.3.0 7,609 1725 day(s) ago
1.2.5 1,649 1762 day(s) ago
1.2.4 1,188 1764 day(s) ago
1.2.3 3,738 1797 day(s) ago
1.2.2 2,804 1818 day(s) ago
1.2.1 1,165 1826 day(s) ago
1.2.0 2,451 1880 day(s) ago
1.1.4 1,945 1896 day(s) ago
1.1.3 726 1902 day(s) ago
1.1.2 3,886 1922 day(s) ago
1.1.1 6,278 1966 day(s) ago
1.1.0 11,542 2023 day(s) ago
1.0.6 1,040 2057 day(s) ago
1.0.5 695 2072 day(s) ago
1.0.4 2,091 2093 day(s) ago
1.0.3 1,336 2128 day(s) ago
1.0.2 1,721 2140 day(s) ago
1.0.1 573 2140 day(s) ago
0.7.0 36,622 2027 day(s) ago
0.6.1 570 2027 day(s) ago
0.6.0 679 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

Statistics

  • 534567 total downloads
  • 1786 downloads of current version
  • 68.7 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge