Polly v8 resilience pipelines for Hangfire — retry, timeout, and circuit-breaker for IBackgroundJobClient.Enqueue and Schedule.
Hangfire's built-in retry applies to job execution on the server side. It does not protect the client side — when your app calls Enqueue() or Schedule() and the backing job store (Redis, SQL Server, etc.) is temporarily unavailable, you get an unhandled BackgroundJobClientException or DistributedLockTimeoutException.
PollyHangfire fills that gap.
dotnet add package PollyHangfire
`csharp services.AddPollyHangfire(pipeline => pipeline .AddRetry(new RetryStrategyOptions { MaxRetryAttempts = 3, Delay = TimeSpan.FromMilliseconds(500), BackoffType = DelayBackoffType.Exponential, ShouldHandle = HangfireTransientErrors.IsTransient, }) .AddTimeout(TimeSpan.FromSeconds(10)));
// Requires IBackgroundJobClient to already be registered (e.g. via services.AddHangfire(...)) public class OrderService(ResilientBackgroundJobClient jobs) { public void PlaceOrder(Order order) => jobs.Enqueue(p => p.ProcessAsync(order)); } `
`csharp IBackgroundJobClient client = new BackgroundJobClient();
var resilient = client.WithPolly(pipeline => pipeline.AddRetry(new RetryStrategyOptions { MaxRetryAttempts = 3, Delay = TimeSpan.FromMilliseconds(500), BackoffType = DelayBackoffType.Exponential, ShouldHandle = HangfireTransientErrors.IsTransient, }));
resilient.Enqueue(s => s.SendWelcomeEmailAsync(userId)); resilient.Schedule(r => r.GenerateAsync(reportId), TimeSpan.FromHours(1)); `
| Method | Description |
|---|---|
| Enqueue(Expression) | Enqueue fire-and-forget job |
| Enqueue(Expression<Action>) | Enqueue typed fire-and-forget job |
| Schedule(Expression, TimeSpan) | Schedule delayed job |
| Schedule(Expression<Action>, TimeSpan) | Schedule typed delayed job |
| Execute(Func) | Execute arbitrary function in pipeline |
HangfireTransientErrors.IsTransient handles:
| Exception | Reason |
|---|---|
| BackgroundJobClientException | Job store temporarily unavailable |
| DistributedLockTimeoutException | Distributed lock acquisition failed |
| TimeoutException | Store connection or command timed out |
| TaskCanceledException | Operation cancelled |
et6.0 · et8.0 · et9.0
| Package | Downloads | Description |
|---|---|---|
| PollyHealthChecks |  |
ASP.NET Core health checks for Polly v8 circuit breakers — expose circuit-breaker state (Closed, HalfOpen, Open, Isolated) as /health endpoint responses |
| PollyBackoff |  |
Backoff delay strategies for Polly v8 resilience pipelines |
| PollyGrpc |  |
Polly v8 resilience interceptor for gRPC |
| PollyEFCore |  |
Polly v8 resilience pipelines for Entity Framework Core — wrap every EF Core query and SaveChanges with retry, timeout and circuit-breaker via a single AddPollyResilience() call |
| PollyRabbitMQ |  |
Polly v8 resilience for RabbitMQ.Client v7+ — retry, circuit-breaker, and timeout for IChannel operations, with built-in RabbitMqTransientErrors predicate covering AlreadyClosedException, BrokerUnreachableException, OperationInterruptedException, and ConnectFailureException |
| PollyMailKit |  |
Polly v8 resilience pipelines for MailKit — retry, timeout, and circuit-breaker for SmtpClient.SendAsync and any MailKit SMTP operation |
| PollyMassTransit |  |
Polly v8 resilience pipelines for MassTransit — retry, timeout, and circuit-breaker for IBus.Publish and ISendEndpointProvider.Send |
| PollyNpgsql |  |
Polly v8 resilience pipelines for Npgsql (PostgreSQL) — retry, timeout, and circuit-breaker for NpgsqlConnection queries and commands, plus a built-in PostgresTransientErrors predicate covering all common PostgreSQL transient SQLSTATE codes |
| PollyOpenAI |  |
Polly v8 resilience for OpenAI and Azure OpenAI API calls |
| PollyAzureEventHub |  |
Polly v8 resilience pipelines for Azure Event Hubs — retry, timeout, and circuit-breaker for EventHubProducerClient and EventHubConsumerClient |
| PollySignalR |  |
Polly v8 reconnect policy for SignalR |
| PollyElasticsearch |  |
Polly v8 resilience pipelines for Elastic.Clients.Elasticsearch 8+ — retry, timeout, and circuit-breaker for any Elasticsearch operation, plus a built-in ElasticTransientErrors predicate covering rate limiting (429), service unavailability (503), gateway timeouts (504), and connection failures |
| PollyCosmosDb |  |
Polly v8 resilience pipelines for Azure Cosmos DB — retry, timeout, and circuit-breaker for Container operations, plus a built-in CosmosTransientErrors predicate covering rate limiting (429), timeouts (408), partition failovers (410), and service unavailability (503) |
| PollySendGrid |  |
Polly v8 resilience pipelines for SendGrid — retry, timeout, and circuit-breaker for ISendGridClient.SendEmailAsync |
| PollyMongo |  |
Polly v8 resilience pipelines for MongoDB.Driver — wrap Find, InsertOne, UpdateOne, DeleteOne and other IMongoCollection calls with retry, timeout, circuit-breaker, and more using a single ResilientMongoCollection decorator |
| PollyDapper |  |
Polly v8 resilience pipelines for Dapper — wrap QueryAsync, ExecuteAsync, and other Dapper calls with retry, timeout, circuit-breaker, and more using a single ResilientDbConnection decorator |
| PollyMediatR |  |
Polly v8 resilience pipelines for MediatR — add retry, timeout, circuit-breaker, rate-limiting, hedging, and chaos engineering to any MediatR request handler with a single line of DI registration |
| PollySqlClient |  |
Polly v8 resilience pipelines for Microsoft.Data.SqlClient (SQL Server and Azure SQL) — retry, timeout, and circuit-breaker for SqlConnection queries and commands, plus a built-in SqlServerTransientErrors predicate covering all common SQL Server and Azure SQL transient error numbers |
| PollyAzureKeyVault |  |
Polly v8 resilience pipelines for Azure Key Vault — retry, timeout, and circuit-breaker for SecretClient, KeyClient, and CertificateClient |
| PollyAzureQueueStorage |  |
Polly v8 resilience pipelines for Azure Queue Storage — retry, timeout, and circuit-breaker for Azure.Storage.Queues QueueClient |
| PollyRedis |  |
Polly v8 resilience for StackExchange.Redis |
| PollyAzureServiceBus |  |
Polly v8 resilience for Azure Service Bus — retry, circuit breaker, and timeout for sending and receiving messages |
| PollyAzureBlob |  |
Polly v8 resilience pipelines for Azure Blob Storage — wrap BlobClient and BlobContainerClient operations with retry, timeout, circuit-breaker, and more using ResilientBlobClient and ResilientBlobContainerClient decorators |
| PollyKafka |  |
Polly v8 resilience for Confluent.Kafka — retry, circuit breaker, and timeout for producers and consumers |
| PollyAzureTableStorage |  |
Polly v8 resilience pipelines for Azure Table Storage — retry, timeout, and circuit-breaker for Azure.Data.Tables TableClient |
| PollyRateLimiter |  |
Convenience extension methods for Polly v8 resilience pipelines: AddFixedWindowRateLimiter, AddSlidingWindowRateLimiter, and AddTokenBucketRateLimiter |
| PollyChaos |  |
Chaos engineering and fault-injection resilience strategies for Polly v8 pipelines |
The author of this package is available for consulting on Polly v8 resilience, Azure cloud architecture, and clean .NET design.
→ solidqualitysolutions.com · LinkedIn
MIT © Justin Bannister