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 486 19 day(s) ago
2.10.5 4,358 44 day(s) ago
2.10.4 4,129 94 day(s) ago
2.10.3 104 94 day(s) ago
2.10.2 10,028 164 day(s) ago
2.10.1 1,927 181 day(s) ago
2.10.0 1,305 200 day(s) ago
2.9.1 549 207 day(s) ago
2.9.0 908 222 day(s) ago
2.8.5 10,731 297 day(s) ago
2.8.4 3,760 342 day(s) ago
2.8.3 7,613 389 day(s) ago
2.8.2 3,240 423 day(s) ago
2.8.1 755 424 day(s) ago
2.8.0 1,901 431 day(s) ago
2.7.0 1,116 438 day(s) ago
2.6.2 1,507 457 day(s) ago
2.6.1 514 464 day(s) ago
2.6.0 1,538 472 day(s) ago
2.5.4 91,068 633 day(s) ago
2.5.3 1,133 643 day(s) ago
2.5.2 943 650 day(s) ago
2.5.1 17,961 732 day(s) ago
2.5.0 7,312 768 day(s) ago
2.4.5 2,452 802 day(s) ago
2.4.4 648 837 day(s) ago
2.4.3 1,138 844 day(s) ago
2.4.2 1,532 915 day(s) ago
2.4.1 7,652 976 day(s) ago
2.4.0 692 978 day(s) ago
2.3.1 6,376 1034 day(s) ago
2.3.0 3,027 1059 day(s) ago
2.2.1 1,064 1062 day(s) ago
2.2.0 1,468 1116 day(s) ago
2.2.0-beta2 275 1117 day(s) ago
2.1.1 346 893 day(s) ago
2.1.0 895 1161 day(s) ago
2.1.0-beta2 467 1249 day(s) ago
2.1.0-beta1 277 1323 day(s) ago
2.0.6 53,118 1381 day(s) ago
2.0.5 378 1385 day(s) ago
2.0.4 362 1389 day(s) ago
2.0.3 365 1397 day(s) ago
2.0.3-beta1 277 1410 day(s) ago
2.0.2 523 1433 day(s) ago
2.0.1 463 1439 day(s) ago
2.0.0 355 1440 day(s) ago
1.6.1 368 1062 day(s) ago
1.6.0 345 1068 day(s) ago
1.5.1 526 1440 day(s) ago
1.5.0-beta 275 1440 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

  • 260550 total downloads
  • 486 downloads of current version
  • 59.2 KB package size

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2026 Petabridge