Python Module for Pingdom REST API

Description

Simple Python wrapper for the Pingdom REST API.

This module does not support the soon-to-be obsolete Pingdom SOAP API. See python-pingdom for the SOAP interface.

Dependencies

None beyond the Python standard library.

Usage

Instantiate:

import pingdom
p = pingdom.Pingdom(username=YourUserName, password=YourPassword, appkey=YourAppKey)

Call an arbitrary method as described in the API docs:

p.method(url='method/url/', method="GET/POST/PUT/etc", parameters={'name':'value', })

Example methods:

# List checks
p.method('checks')

# Modifiy a check, in this case, pause it
p.method('checks/CHECK_ID_NUM/', method='PUT', parameters={'paused': True})

Some shortcut methods that were useful to me:

# Get checks by name instead of number
p.check_by_name('my check name')

# Pause and unpause a check by name
p.pause_check('my check name')
p.unpause_check('my check name')

# Average Response Time
p.avg_response(CHEKC_ID_NUM)

# Average Response Time for the last 15 minutes
p.avg_response(CHEKC_ID_NUM, minutes_back=15)

# Average Response Time for the last 15 minutes in the US
p.avg_response(CHEKC_ID_NUM, minutes_back=15, country='US')