Table of Contents

Class ObservabilityBridgeExtensions

Namespace
Typhon.Engine
Assembly
Typhon.Engine.dll

Extension methods for registering Typhon Observability Bridge services with dependency injection.

public static class ObservabilityBridgeExtensions
Inheritance
ObservabilityBridgeExtensions
Inherited Members

Methods

AddTyphonBackupMetrics(IServiceCollection)

Registers BackupMetricsExporter (meter Typhon.Backup): the engine's backup health, ages, depths and archive lag as gauges, its totals as counters. Like AddTyphonEcsMetrics(IServiceCollection), resolve it once after the provider is built so its meter exists before the first scrape.

public static IServiceCollection AddTyphonBackupMetrics(this IServiceCollection services)

Parameters

services IServiceCollection

The service collection.

Returns

IServiceCollection

AddTyphonEcsMetrics(IServiceCollection)

Registers EcsMetricsExporter so the ECS and spatial-partitioning instruments can be published on the Typhon.ECS meter.

public static IServiceCollection AddTyphonEcsMetrics(this IServiceCollection services)

Parameters

services IServiceCollection

The service collection.

Returns

IServiceCollection

The service collection for chaining.

Remarks

Deliberately separate from AddTyphonObservabilityBridge(IServiceCollection, Action<ObservabilityBridgeOptions>): that method's documented prerequisite is IResourceGraph, and folding a DatabaseEngine dependency into it would change its contract for every existing caller. Registration is lazy, so resolving it without an engine registered fails at resolution rather than at startup.

Registration alone publishes nothing. The instruments are created in the exporter's constructor, and this is a lazy singleton — a host that calls this method and then scrapes sees no typhon.ecs.* series until something resolves EcsMetricsExporter at least once. Resolve it during startup:

services.AddTyphonEcsMetrics();
// ...after the provider is built, before the first scrape:
_ = provider.GetRequiredService<EcsMetricsExporter>();

Every instrument is observable — the callbacks run when an OTel consumer polls, never on the tick path, so enabling this costs a running engine nothing until something scrapes it.

AddTyphonObservabilityBridge(IServiceCollection, Action<ObservabilityBridgeOptions>)

Adds the Typhon Observability Bridge to the service collection.

public static IServiceCollection AddTyphonObservabilityBridge(this IServiceCollection services, Action<ObservabilityBridgeOptions> configure = null)

Parameters

services IServiceCollection

The service collection.

configure Action<ObservabilityBridgeOptions>

Optional action to configure bridge options.

Returns

IServiceCollection

The service collection for chaining.

Remarks

This method registers:

Prerequisites: IResourceGraph must be registered in the service collection.

services.AddSingleton<IResourceGraph>(sp => ...);
services.AddTyphonObservabilityBridge(options =>
{
    options.SnapshotInterval = TimeSpan.FromSeconds(10);
    options.Thresholds["Storage/PageCache"] = new HealthThresholds(0.70, 0.90);
});