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.0 Current 5 1 day(s) ago
2.10.5 2,733 26 day(s) ago
2.10.4 4,017 76 day(s) ago
2.10.3 77 76 day(s) ago
2.10.2 8,539 145 day(s) ago
2.10.1 2,368 163 day(s) ago
2.10.0 1,433 182 day(s) ago
2.9.1 536 189 day(s) ago
2.9.0 1,141 204 day(s) ago
2.8.5 11,272 278 day(s) ago
2.8.4 3,940 323 day(s) ago
2.8.3 8,051 371 day(s) ago
2.8.2 3,033 405 day(s) ago
2.8.1 960 406 day(s) ago
2.8.0 1,856 412 day(s) ago
2.7.0 1,117 419 day(s) ago
2.6.2 1,528 439 day(s) ago
2.6.1 470 446 day(s) ago
2.6.0 1,494 454 day(s) ago
2.5.4 92,743 615 day(s) ago
2.5.3 1,065 625 day(s) ago
2.5.2 924 631 day(s) ago
2.5.1 18,132 714 day(s) ago
2.5.0 14,757 750 day(s) ago
2.4.5 2,837 784 day(s) ago
2.4.4 920 818 day(s) ago
2.4.3 9,201 825 day(s) ago
2.4.2 9,469 897 day(s) ago
2.4.1 11,883 957 day(s) ago
2.4.0 684 960 day(s) ago
2.3.1 8,529 1015 day(s) ago
2.3.0 11,482 1041 day(s) ago
2.2.1 1,140 1044 day(s) ago
2.2.0 2,160 1097 day(s) ago
2.2.0-beta2 263 1099 day(s) ago
2.1.1 500 874 day(s) ago
2.1.0 2,103 1142 day(s) ago
2.1.0-beta2 517 1231 day(s) ago
2.1.0-beta1 403 1304 day(s) ago
2.0.6 65,860 1363 day(s) ago
2.0.5 400 1367 day(s) ago
2.0.4 367 1371 day(s) ago
2.0.3 382 1378 day(s) ago
2.0.3-beta1 274 1391 day(s) ago
2.0.2 4,529 1415 day(s) ago
2.0.1 474 1421 day(s) ago
2.0.0 364 1422 day(s) ago
2.0.0-beta4 699 1447 day(s) ago
2.0.0-beta3 716 1491 day(s) ago
2.0.0-beta2 274 1492 day(s) ago
2.0.0-beta1 361 1498 day(s) ago
1.6.1 4,537 1044 day(s) ago
1.6.0 422 1049 day(s) ago
1.5.1 13,949 1422 day(s) ago
1.5.0 333 1422 day(s) ago
1.5.0-beta1 263 1447 day(s) ago
1.4.2 12,868 1457 day(s) ago
1.4.1 2,336 1492 day(s) ago
1.4.0 383 1505 day(s) ago
1.3.3 7,284 1521 day(s) ago
1.3.2 768 1534 day(s) ago
1.3.1 825 1545 day(s) ago
1.3.0 7,452 1566 day(s) ago
1.2.5 1,493 1603 day(s) ago
1.2.4 1,029 1605 day(s) ago
1.2.3 3,579 1638 day(s) ago
1.2.2 2,647 1659 day(s) ago
1.2.1 1,008 1667 day(s) ago
1.2.0 2,295 1721 day(s) ago
1.1.4 1,786 1737 day(s) ago
1.1.3 570 1743 day(s) ago
1.1.2 3,729 1763 day(s) ago
1.1.1 6,122 1806 day(s) ago
1.1.0 11,383 1864 day(s) ago
1.0.6 884 1898 day(s) ago
1.0.5 536 1913 day(s) ago
1.0.4 1,934 1934 day(s) ago
1.0.3 1,179 1968 day(s) ago
1.0.2 1,563 1981 day(s) ago
1.0.1 416 1981 day(s) ago
0.7.0 36,464 1868 day(s) ago
0.6.1 414 1868 day(s) ago
0.6.0 460 1868 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

  • 449893 total downloads
  • 5 downloads of current version
  • 68.7 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge