Sample script to output all PagerDuty incidents for a given time period to a CSV file (defaults to previous 24 hours)

get_incidents_csv.py

#!/usr/bin/env python
#
# Copyright (c) 2016, PagerDuty, Inc. <[email protected]>
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#     * Redistributions of source code must retain the above copyright
#       notice, this list of conditions and the following disclaimer.
#     * Redistributions in binary form must reproduce the above copyright
#       notice, this list of conditions and the following disclaimer in the
#       documentation and/or other materials provided with the distribution.
#     * Neither the name of PagerDuty Inc nor the
#       names of its contributors may be used to endorse or promote products
#       derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL PAGERDUTY INC BE LIABLE FOR ANY
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# Sample script to output all incidents for a given time period to a CSV file
# Currently the time period defaults to one day
# CLI Usage: ./get_incidents_csv api_key [since] [until]
#   api_key: PagerDuty API access token
#   since: Start date of incidents you want to pull in YYYY-MM-DD format
#   until: End date of incidents you want to pull in YYYY-MM-DD format

import requests
import sys
import json
import csv
import datetime
from datetime import date
from datetime import timedelta

url = 'https://api.pagerduty.com/incidents'
yesterday = date.today() - timedelta(days=1)

def get_incidents(api_key, since=yesterday, until=date.today()):
    headers = {
        'Accept': 'application/vnd.pagerduty+json;version=2',
        'Authorization': 'Token token=' + api_key
    }
    if isinstance(since, datetime.date):
        since = since.isoformat()
    if isinstance(until, datetime.date):
        until = until.isoformat()
    payload = {
        'since': since,
        'until': until
    }
    r = requests.get(url, headers=headers, params=payload)
    incidents = r.json()['incidents']
    csvfile = open('test.csv', 'w')
    fieldnames = ['incident_id','incident_summary','incident_urgency','incident_status','created_at','incident_type','service_id','service_summary','escalation_policy_id','escalation_policy_summary']
    writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
    writer.writeheader()
    for i in incidents:
        row = {
            'incident_id': i['id'],
            'incident_summary': i['summary'],
            'incident_urgency': i['urgency'],
            'incident_status': i['status'],
            'created_at': i['created_at'],
            'incident_type': i['type'],
            'service_id': i['service']['id'],
            'service_summary': i['service']['summary'],
            'escalation_policy_id': i['escalation_policy']['id'],
            'escalation_policy_summary': i['escalation_policy']['summary']
        }
        writer.writerow(row)
    csvfile.close()

if __name__ == '__main__':
    if len(sys.argv) == 1:
        print "Error: You did not enter any parameters.\nUsage: ./get_incidents_csv api_key [since] [until]\n\tapi_key: PagerDuty API access token\n\tsince: Start date of incidents you want to pull in YYYY-MM-DD format\n\tuntil: End date of incidents you want to pull in YYYY-MM-DD format"
    elif len(sys.argv) == 2:
        get_incidents(sys.argv[1])
    elif len(sys.argv) == 3:
        get_incidents(sys.argv[1], sys.argv[2])
    else:
        get_incidents(sys.argv[1], sys.argv[2], sys.argv[3])

TODO: extract the acknowledge summary and created_at for each incident:

URL: https://api.pagerduty.com/incidents/PV7J8IW/log_entries?time_zone=UTC&is_overview=true
API HELP: https://v2.developer.pagerduty.com/v2/page/api-reference#!/Incidents/get_incidents_id_log_entries

Sample output:

    {
      "id": "R8RW6FZYBOJ6U2368XLZY0N1J4",
      "type": "acknowledge_log_entry",
      "summary": "Acknowledged by Bogdan Radocea",
      "self": "https://api.pagerduty.com/log_entries/R8RW6FZYBOJ6U2368XLZY0N1J4",
      "html_url": null,
      "created_at": "2017-01-28T13:36:17Z",
      "agent": {
        "id": "PD13FOY",
        "type": "user_reference",
        "summary": "Bogdan Radocea"
      },
      "channel": {
        "type": "mobile"
      },
      "service": {
        "id": "PBM70NM",
        "type": "service_reference",
      },
      "incident": {
        "id": "PV7J8IW",
        "type": "incident_reference",
        "summary": "....."
      },
      "teams": [],
      "contexts": [],
      "acknowledgement_timeout": 7200,
      "event_details": {}
    }