NetEvolve.HealthPublishers.PagerDuty
1.10.0
Prefix Reserved
dotnet add package NetEvolve.HealthPublishers.PagerDuty --version 1.10.0
NuGet\Install-Package NetEvolve.HealthPublishers.PagerDuty -Version 1.10.0
<PackageReference Include="NetEvolve.HealthPublishers.PagerDuty" Version="1.10.0" />
<PackageVersion Include="NetEvolve.HealthPublishers.PagerDuty" Version="1.10.0" />
<PackageReference Include="NetEvolve.HealthPublishers.PagerDuty" />
paket add NetEvolve.HealthPublishers.PagerDuty --version 1.10.0
#r "nuget: NetEvolve.HealthPublishers.PagerDuty, 1.10.0"
#:package NetEvolve.HealthPublishers.PagerDuty@1.10.0
#addin nuget:?package=NetEvolve.HealthPublishers.PagerDuty&version=1.10.0
#tool nuget:?package=NetEvolve.HealthPublishers.PagerDuty&version=1.10.0
NetEvolve.HealthPublishers.PagerDuty
An IHealthCheckPublisher implementation that triggers and resolves PagerDuty incidents based on HealthReport results, using the Events API v2 (/v2/enqueue) directly over HTTP.
Features
- Maps
HealthStatusto a PagerDuty event action:Healthy→resolve,Degraded/Unhealthy→trigger - Maps
Degraded/Unhealthyto a PagerDuty severity (warning/critical) on triggered incidents - Derives a stable
dedup_keyfrom the requiredSystemIdentifier, so a triggered incident is automatically resolved once the same system reports healthy again - Tags triggered incidents with the machine name as the event
source, and a per-check breakdown ascustom_details - Configuration- or builder-based setup, consistent with the
NetEvolve.HealthChecks.*conventions - Named registrations to publish to multiple PagerDuty services side by side
- No PagerDuty client dependency - just
HttpClientviaIHttpClientFactory
Installation
NuGet Package Manager
Install-Package NetEvolve.HealthPublishers.PagerDuty
.NET CLI
dotnet add package NetEvolve.HealthPublishers.PagerDuty
PackageReference
<PackageReference Include="NetEvolve.HealthPublishers.PagerDuty" Version="x.x.x" />
Quick Start
using NetEvolve.HealthPublishers.PagerDuty;
var builder = services.AddHealthChecks();
builder.AddPagerDutyPublisher(options =>
{
options.RoutingKey = "<integration-key>";
options.SystemIdentifier = "checkout-service";
});
Usage
Basic Example
Register under the default name ("Default"), configured via code:
var builder = services.AddHealthChecks();
builder.AddPagerDutyPublisher(options =>
{
options.RoutingKey = "<integration-key>"; // Required, PagerDuty Events API v2 integration/routing key
options.SystemIdentifier = "checkout-service"; // Required, derives the dedup_key and tags the event source
});
Advanced Example
Register multiple named PagerDuty targets, each pushing the same health reports to a different service:
var builder = services.AddHealthChecks();
builder.AddPagerDutyPublisher("Database", options =>
{
options.RoutingKey = "<database-integration-key>";
options.SystemIdentifier = "checkout-service-database";
});
builder.AddPagerDutyPublisher("Cache", options =>
{
options.RoutingKey = "<cache-integration-key>";
options.SystemIdentifier = "checkout-service-cache";
});
Configuration
Code-based
builder.AddPagerDutyPublisher(options =>
{
options.RoutingKey = "<integration-key>"; // Required
options.SystemIdentifier = "checkout-service"; // Required
});
appsettings.json-based
builder.AddPagerDutyPublisher(); // reads the "Default" section below
{
"HealthPublishers": {
"PagerDuty": {
"Default": {
"RoutingKey": "<integration-key>",
"SystemIdentifier": "checkout-service"
}
}
}
}
When using an explicit name, the section key must match: builder.AddPagerDutyPublisher("Database") reads HealthPublishers:PagerDuty:Database.
Requirements
- .NET 8.0 or higher
- A PagerDuty account and an Events API v2 integration/routing key
Related Packages
- NetEvolve.HealthPublishers.Abstractions - Shared abstractions used by all
NetEvolve.HealthPublishers.*packages
Documentation
For complete documentation, please visit the official documentation.
Contributing
Contributions are welcome! Please read the Contributing Guidelines before submitting a pull request.
Support
- Issues: Report bugs or request features on GitHub Issues
- Documentation: Read the full documentation at https://github.com/dailydevops/healthpublishers
License
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by the NetEvolve Team Visit us at https://www.daily-devops.net for more information about our services and solutions.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 10.0.10)
- Microsoft.Extensions.Http (>= 10.0.10)
- Microsoft.Extensions.Options (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
-
net8.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 10.0.10)
- Microsoft.Extensions.Http (>= 10.0.10)
- Microsoft.Extensions.Options (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
-
net9.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.10)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.10)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 10.0.10)
- Microsoft.Extensions.Http (>= 10.0.10)
- Microsoft.Extensions.Options (>= 10.0.10)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.10)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.10.0 | 47 | 7/27/2026 |