PagerDuty Integration for Home Assistant

A custom component designed for Home Assistant to integrate with PagerDuty, providing insights and controls over incidents and on-call schedules.

PagerDuty license requirements

At the moment, code requires advanced-permissions option, which is only available in Business and Digital Operations plans
The plan is to add support for account-level access token later

Features

• Monitor PagerDuty services and incidents.
• View on-call schedule of the API owner. + calendar integration
• View assigned incident counts. + their details
• Support for multiple PagerDuty teams.
• Allow notification to a service

Install with HACS (recommended)

If you have HACS installed, search for the PagerDuty Integration and install it directly from HACS. HACS will manage updates, allowing you to easily keep track of the latest versions.

Manual Installation

1. Open the directory (folder) for your HA configuration (where configuration.yaml is located).
2. Create a custom_components directory if it doesn't already exist.
3. Inside custom_components, create a new folder named pagerduty.
4. Download all the files from the custom_components/pagerduty/ directory in this repository.
5. Place the files you downloaded into the pagerduty directory you created.
6. Restart Home Assistant.
7. In the HA UI, go to "Configuration" -> "Integrations" click "+" and search for "PagerDuty".

Configuration

Once installed, configure the integration with your PagerDuty API token through the Home Assistant UI.

Use of notifications

The service ID you can get from the URL when checking the service.
The integration will create a new integration_key in PD with Home Assistant name, no need to fiddle with integration_key

service: notify.pagerduty
data:
    message: "Your message here"
    data:
        service_id: "specific_service_id"

Contributions

Contributions to the project are welcome!

---