Phobos.Hosting 2.11.0

Akka.Hosting prototype support for Phobos.

Install-Package Phobos.Hosting -Version 2.11.0
dotnet add package Phobos.Hosting --version 2.11.0
<PackageReference Include="Phobos.Hosting" Version="2.11.0" />
paket add Phobos.Hosting --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 725 23 day(s) ago
2.10.5 4,674 48 day(s) ago
2.10.4 4,210 98 day(s) ago
2.10.3 108 98 day(s) ago
2.10.2 10,505 168 day(s) ago
2.10.1 1,934 185 day(s) ago
2.10.0 1,310 204 day(s) ago
2.9.1 553 211 day(s) ago
2.9.0 923 226 day(s) ago
2.8.5 10,736 300 day(s) ago
2.8.4 3,777 346 day(s) ago
2.8.3 7,622 393 day(s) ago
2.8.2 3,246 427 day(s) ago
2.8.1 759 428 day(s) ago
2.8.0 1,905 435 day(s) ago
2.7.0 1,121 442 day(s) ago
2.6.2 1,511 461 day(s) ago
2.6.1 518 468 day(s) ago
2.6.0 1,542 476 day(s) ago
2.5.4 91,349 637 day(s) ago
2.5.3 1,137 647 day(s) ago
2.5.2 947 653 day(s) ago
2.5.1 17,968 736 day(s) ago
2.5.0 7,401 772 day(s) ago
2.4.5 2,456 806 day(s) ago
2.4.4 652 841 day(s) ago
2.4.3 1,142 848 day(s) ago
2.4.2 1,536 919 day(s) ago
2.4.1 7,656 979 day(s) ago
2.4.0 696 982 day(s) ago
2.3.1 6,380 1037 day(s) ago
2.3.0 3,031 1063 day(s) ago
2.2.1 1,068 1066 day(s) ago
2.2.0 1,472 1119 day(s) ago
2.2.0-beta2 279 1121 day(s) ago
2.1.1 350 896 day(s) ago
2.1.0 899 1165 day(s) ago
2.1.0-beta2 471 1253 day(s) ago
2.1.0-beta1 281 1326 day(s) ago
2.0.6 53,122 1385 day(s) ago
2.0.5 382 1389 day(s) ago
2.0.4 366 1393 day(s) ago
2.0.3 369 1400 day(s) ago
2.0.3-beta1 281 1414 day(s) ago
2.0.2 527 1437 day(s) ago
2.0.1 467 1443 day(s) ago
2.0.0 359 1444 day(s) ago
1.6.1 372 1066 day(s) ago
1.6.0 349 1071 day(s) ago
1.5.1 530 1444 day(s) ago
1.5.0-beta 279 1444 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

  • 262253 total downloads
  • 725 downloads of current version
  • 59.2 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge