Phobos
Enterprise Application Monitoring and Management for Akka.NET OSS
Published by Petabridge
  • last updated 2 day(s) ago
  • 3992 daily downloads
  • 1640424 total downloads
  • Latest version: 2.8.0

Phobos.TestKit 2.0.0-beta1

Framework used for testing applications that have been instrumented using Phobos. Makes it feasible to test using data collected from actor traces, monitoring, and so forth.

Install-Package Phobos.TestKit -Version 2.0.0-beta1
dotnet add package Phobos.TestKit --version 2.0.0-beta1
<PackageReference Include="Phobos.TestKit" Version="2.0.0-beta1"/>
paket add Phobos.TestKit --version 2.0.0-beta1

Release Notes

MAJOR RELEASE OF PHOBOS** In Phobos 2.0 we have migrated all of our tracing and monitoring capabilities to use [OpenTelemetry](https://opentelemetry.io/). As we mentioned in our recent blog post about Phobos 2.0 and its relationship with OpenTelemetry, we did this for the following reasons: OpenTelemetry is now the official APM solution for the entire .NET platform, including other popular frameworks such as ASP.NET and Entity Framework; All major APM vendors and OSS project such as Prometheus, Jaeger, DataDog, AWS, GCP, Azure, Elastic, and so on are all committed to supporting OpenTelemetry going forward and they implement their own first-party exporters that transmit data to those platforms; The performance of the `OpenTelemetry.Trace` and `OpenTelemetry.Metrics` implementations, which Phobos uses, are identical no matter which combination of exporters you adopt; and OpenTelemetry is much more decoupled and extensible than any of the previous solutions in market. We have replaced all of our OpenTracing and App.Metrics dependencies with 2.x going forward. Installation and Configuration** To use Phobos 2.0.0-beta* in your solution, all you need to do is: 1. Install [the appropriate `Phobos.Actor.*` package](https://phobos.petabridge.com/articles/setup/index.html#nuget-packages) into your application using the 2.0.0-beta* version; 2. Install the appropriate [`OpenTelemetry.Exporter.*` packages](https://www.nuget.org/packages?q=OpenTelemetry.Exporter) you want to use in combination with your preferred APM tools; and 3. Configure your `IServiceCollection` with the following (adjust as needed): ```csharp // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940 public void ConfigureServices(IServiceCollection services) { // Prometheus exporter won't work without this services.AddControllers(); var resource = ResourceBuilder.CreateDefault() .AddService(Assembly.GetEntryAssembly().GetName().Name, serviceInstanceId: $"{Dns.GetHostName()}"); // enables OpenTelemetry for ASP.NET / .NET Core services.AddOpenTelemetryTracing(builder => { builder .SetResourceBuilder(resource) .AddPhobosInstrumentation() .AddSource("Petabridge.Phobos.Web") .AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation() .AddJaegerExporter(opt => { opt.AgentHost = Environment.GetEnvironmentVariable(JaegerAgentHostEnvironmentVar); }); }); services.AddOpenTelemetryMetrics(builder => { builder .SetResourceBuilder(resource) .AddPhobosInstrumentation() .AddHttpClientInstrumentation() .AddAspNetCoreInstrumentation() .AddPrometheusExporter(opt => { }); }); // sets up Akka.NET ConfigureAkka(services); } ``` The `.AddPhobosInstrumentation()` line will ensure that OTel picks up all of the signals produced by Phobos - and you need to call this line for *both* metrics and tracing! Finally, you need to configure your `ActorSystem` to use Phobos and to leverage the `TracerProvider` and `MeterProvider`s from OpenTelemetry: ```csharp public static void ConfigureAkka(IServiceCollection services) { services.AddSingleton(sp => { var metrics = sp.GetRequiredService<MeterProvider>(); var tracer = sp.GetRequiredService<TracerProvider>(); var config = ConfigurationFactory.ParseString(File.ReadAllText("app.conf")) .BootstrapFromDocker() .UseSerilog(); var phobosSetup = PhobosSetup.Create(new PhobosConfigBuilder() .WithMetrics(m => m.SetMetricsRoot(metrics)) // binds Phobos to same IMetricsRoot as ASP.NET Core .WithTracing(t => t.SetTracer(tracer))) // binds Phobos to same tracer as ASP.NET Core .WithSetup(BootstrapSetup.Create() .WithConfig(config) // passes in the HOCON for Akka.NET to the ActorSystem .WithActorRefProvider(PhobosProviderSelection .Cluster)); // last line activates Phobos inside Akka.NET var sys = ActorSystem.Create("ClusterSys", phobosSetup); // create actor "container" and bind it to DI, so it can be used by ASP.NET Core return new AkkaActors(sys); }); // this will manage Akka.NET lifecycle services.AddHostedService<AkkaService>(); } ``` This is fundamentally not all that different from how Phobos 1.x works. We will update our official documentation and website with more Phobos 2.0-specific instructions as our releases mature, but for the time being please don't hesitate to submit an issue on the [Phobos Issue Tracker](https://github.com/petabridge/phobos-issues) if you run into trouble! Phobos 1.x Support Lifetime** Per our recent announcement, we will continue to support Phobos 1.x and 2.x concurrently. Phobos 1.x will exit support on December 31st, 2023.

Dependencies

.NETStandard

Versions

Version
Downloads
Last Updated
1
2 day(s) ago
2
9 day(s) ago
4
28 day(s) ago
2
35 day(s) ago
3
43 day(s) ago
27
204 day(s) ago
3
214 day(s) ago
2
220 day(s) ago
15
303 day(s) ago
7
339 day(s) ago
7
373 day(s) ago
7
408 day(s) ago
3
415 day(s) ago
2
463 day(s) ago
14
486 day(s) ago
106
546 day(s) ago
4
549 day(s) ago
127
604 day(s) ago
169
630 day(s) ago
5
633 day(s) ago
7
633 day(s) ago
16
638 day(s) ago
11
687 day(s) ago
1
688 day(s) ago
9
732 day(s) ago
1
820 day(s) ago
1
893 day(s) ago
51
952 day(s) ago
4
956 day(s) ago
3
960 day(s) ago
5
967 day(s) ago
2
981 day(s) ago
19
1004 day(s) ago
2
1010 day(s) ago
2
1011 day(s) ago
43
1011 day(s) ago
2
1011 day(s) ago
1
1037 day(s) ago
1
1037 day(s) ago
126
1046 day(s) ago
2
1080 day(s) ago
1
1081 day(s) ago
61
1081 day(s) ago
1
1087 day(s) ago
3
1094 day(s) ago
49
1110 day(s) ago
2
1123 day(s) ago
2
1135 day(s) ago
197
1156 day(s) ago
23
1192 day(s) ago
120
1194 day(s) ago
278
1227 day(s) ago
61
1248 day(s) ago
3
1256 day(s) ago
565
1310 day(s) ago
127
1326 day(s) ago
10
1332 day(s) ago
250
1352 day(s) ago
457
1396 day(s) ago
671
1453 day(s) ago
83
1457 day(s) ago
84
1457 day(s) ago
84
1457 day(s) ago
84
1457 day(s) ago
87
1487 day(s) ago
84
1502 day(s) ago
372
1523 day(s) ago
84
1558 day(s) ago
169
1570 day(s) ago
84
1570 day(s) ago

Info

Statistics

  • 4915 total downloads
  • 1 downloads of current version

Owners and Products

Petabridge Petabridge

Authors

Petabridge

Copyright

Copyright © 2017-2021 Petabridge

Petabridge