Skip to content
Python module for Pingdom's RESTful API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.rst
pingdom.py

README.rst

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')
You can’t perform that action at this time.