Pagerduty sample incident import script

Bring your historical PagerDuty incidents into incident.io with a sample import script.

This script provides a basic structure that can be utilized to import historical incident data from Pagerduty to incident.io.

For best results, we recommend doing further mapping to ensure all fields are being mapped to your requirements.

You can use the PagerDuty API to fetch incidents and the incident.io API to add retrospective incidents.

Prerequisites

Ensure you have the necessary API keys and permissions for both services.

Also, make sure you have the required libraries installed by running:

pip install requests

Sample script

Here’s a simple Python script that demonstrates how you might export incidents from PagerDuty and add them as retrospective incidents to incident.io:

import math

import requests
import json

# PagerDuty API credentials
pagerduty_token = 'your_pagerduty_token'
pagerduty_api_url = 'https://api.pagerduty.com/incidents'

# Incident.io API credentials
incidentio_token = 'your_incidentio_token'
incidentio_api_url = 'https://api.incident.io/v2/incidents'

# Function to fetch incidents from PagerDuty
def fetch_pagerduty_incidents(params):
    headers = {
        'Authorization': f'Token token={pagerduty_token}',
        'Content-Type': 'application/json',
    }
    response = requests.get(pagerduty_api_url, headers=headers, params=params)
    return response.json()

def import_incidents_to_incident_io(incident, retrospective_data):
    headers = {
        'Authorization': f'Bearer {incidentio_token}',
        'Content-Type': 'application/json',
    }

    response = requests.post(incidentio_api_url, headers=headers, data=json.dumps(retrospective_data))
    if response.status_code == 201:
        print(f"Retrospective incident added for PagerDuty incident ID: {incident['id']}")
    else:
        print(f"Failed to add retrospective incident for PagerDuty incident ID: {incident['id']}")

# Function to add retrospective incidents to Incident.io
def add_retrospective_incidents(incident_total):
    max_pages = math.ceil(incident_total/10)  # calculate how many pages we need

    for page in range(1, max_pages + 1):
        offset = (page - 1) * 10
        params = {
            "limit": 10,
            "offset": offset
        }
        pagerduty_incidents = fetch_pagerduty_incidents(params)["incidents"]

        if pagerduty_incidents:
            for incident in pagerduty_incidents:
                # Customize the data you want to send to Incident.io
                retrospective_data = {
                    'name': f"Retrospective - {incident['summary']}",
                    'idempotency_key': f"pagerduty-import-{incident['id']}",
                    'mode': 'retrospective',
                    'severity_id': 'your_default_severity_id',  # Replace with a real severity ID
                    'visibility': 'public',
                    # Add any other relevant fields, This is where you get to customize any fields on incident.io side
                    # with data from PagerDuty
                }
                import_incidents_to_incident_io(incident, retrospective_data)

def main():
    # Fetch the total number of incidents from PagerDuty to handle pagination
    total_number_of_incidents = fetch_pagerduty_incidents({"limit": 10, "offset": 0, "total": True})["total"]
    print(total_number_of_incidents)

    # Extract relevant information from PagerDuty incidents and add to Incident.io
    if total_number_of_incidents:
        add_retrospective_incidents(total_number_of_incidents)
    else:
        print("No incidents found in PagerDuty.")

if __name__ == "__main__":
    main()

Note: Make sure to replace placeholders like 'your_pagerduty_token', 'your_incidentio_token', and 'your_default_severity_id' (find severity IDs via the List Severities API), and customize the data fields according to your needs.