Skip to content
alert-triangle

GitHub Action

PagerDuty Alert Remastered

0.3.2 Latest version

PagerDuty Alert Remastered

alert-triangle

PagerDuty Alert Remastered

GitHub Action to send a critical PagerDuty alert, e.g. on action failure

Installation

Copy and paste the following snippet into your .yml file.

              

- name: PagerDuty Alert Remastered

uses: miparnisari/action-pagerduty-alert@0.3.2

Learn more about this action in miparnisari/action-pagerduty-alert

Choose a version

PagerDuty Alert GitHub Action

Sends a critical PagerDuty alert, e.g. on action failure.

Prerequisites

  1. Create a service integration in PagerDuty:
    1. Go to PagerDuty > "Services" > Pick your service > "Integrations" > "Add a new integration"
    2. Choose a name (e.g. "Your GitHub CI/CD") and "Use our API directly" with "Events API v2"
    3. Copy the integration key
  2. Set up a secret in your GitHub repo to store the integration key, e.g. "PAGERDUTY_INTEGRATION_KEY"

Inputs

pagerduty-integration-key

Required: the integration key for your PagerDuty service

pagerduty-dedup-key

Optional: a dedup_key for your alert. This will enable PagerDuty to coalesce multiple alerts into one. More documentation is available here.

incident-summary

Optional: a custom summary for your PagerDuty alert

incident-region

Optional: the region where the incident occurred

incident-environment

Optional: the environment where the incident occurred

Example usage

In your steps:

- name: Send PagerDuty alert on failure
  if: ${{ failure() }}
  uses: miparnisari/action-pagerduty-alert
  with:
    pagerduty-integration-key: '${{ secrets.PAGERDUTY_INTEGRATION_KEY }}'
    pagerduty-dedup-key: github_workflow_failed