Table of Contents

Class TelemetryResiliencePipeline

Namespace
Excalibur.Dispatch.Resilience.Polly
Assembly
Excalibur.Dispatch.Resilience.Polly.dll

Decorator that emits OpenTelemetry metrics for resilience operations including retries, circuit breaker state transitions, and timeouts.

public sealed class TelemetryResiliencePipeline : IDisposable
Inheritance
TelemetryResiliencePipeline
Implements
Inherited Members
Extension Methods

Remarks

Wraps a resilience execution delegate and records metrics using the Excalibur.Dispatch.Resilience.Polly.ResilienceTelemetryConstants meter. All metrics follow OpenTelemetry semantic conventions for resilience operations.

Constructors

TelemetryResiliencePipeline(string, ILogger<TelemetryResiliencePipeline>, IMeterFactory?)

Initializes a new instance of the TelemetryResiliencePipeline class.

public TelemetryResiliencePipeline(string pipelineName, ILogger<TelemetryResiliencePipeline> logger, IMeterFactory? meterFactory = null)

Parameters

pipelineName string

The name of the resilience pipeline for metric tagging.

logger ILogger<TelemetryResiliencePipeline>

The logger instance.

meterFactory IMeterFactory

Optional meter factory for DI-managed meter lifecycle.

Methods

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

public void Dispose()

ExecuteAsync<TResult>(Func<CancellationToken, Task<TResult>>, CancellationToken)

Executes an operation with telemetry instrumentation.

public Task<TResult> ExecuteAsync<TResult>(Func<CancellationToken, Task<TResult>> operation, CancellationToken cancellationToken)

Parameters

operation Func<CancellationToken, Task<TResult>>

The operation to execute.

cancellationToken CancellationToken

The cancellation token to observe.

Returns

Task<TResult>

The result of the operation.

Type Parameters

TResult

The type of result returned by the operation.

RecordCircuitBreakerTransition(string, string)

Records a circuit breaker state transition metric.

public void RecordCircuitBreakerTransition(string fromState, string toState)

Parameters

fromState string

The previous circuit breaker state.

toState string

The new circuit breaker state.

RecordRetryAttempt(int, string)

Records a retry attempt metric.

public void RecordRetryAttempt(int attemptNumber, string strategyType)

Parameters

attemptNumber int

The retry attempt number.

strategyType string

The type of retry strategy.