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')