Skip to main content

Client for Pingdom Services

Project description

https://img.shields.io/pypi/v/pypingdom.svg https://img.shields.io/pypi/l/pypingdom.svg https://img.shields.io/pypi/pyversions/pypingdom.svg https://travis-ci.org/sekipaolo/pypingdom.svg?branch=master

Python library for interacting with Pingdom services (REST API and maintenance windows).

Features

  • Support for Multi-User Authentication

  • Check management: create, delete, update, list

  • Maintenance windows: create, delete, list

  • Fetching outage summaries

Requirements

  • Pingdom account

  • requests (0.10.8 or newer)

Installation

pip install pypingdom

Usage

The client object will allow you to interact both with the REST API and the GUI (for maintenance windows).

>>> import pypingdom
>>> client = pypingdom.Client(username="username@example.com",
                        password="your_password",
                        apikey="your_api_key",
                        email="your_email")

the email parameter is required for Multiuser Authentication.

Checks

Since Pingdom does not treat the check name as identifier (as we probably want to do) the client object will retrieve the check list from the API and cache it as a dictionary ( check_name => check_instance). You can access it through the checks attribute:

>>> client.checks["my awesome check"]
pingdom.Check <1895866>
  autoresolve: 0
  alert_policy: 2118909
  name: example_com
  created: 1448565930
  lasterrortime: 1489325292
  resolution: 1
  lastresponsetime: 558
  lasttesttime: 1489847772
  alert_policy_name: Production Systems
  paused: False
  host: hostname.example.com
  acktimeout: 0
  ipv6: False
  use_legacy_notifications: False
  type: http
  tags: []

a better way to retrieve a check would be:

>>> client.get_check("my awesome check")

that will return None if the check doesn’t exists

List checks with production and frontend tags:

>>> client.get_checks(filters={"tags": ["production", "frontend"]})

Create a check:

>>> check_definition = {
        "name": "My awesome check",
        "paused": True,
        "alert_policy": 201745,
        "type": "http",
        "host": "www.google.com",
        "url": "/",
        "requestheaders": {
            'XCustom': 'my header value'
        },
        "tags": ["pypingdom-test", "custom-tag"],
        "encryption": False
    }
>>> client.update_check(check, check_definition)

Refers to this page for the list of options.

When you create or modify a check some related entity need to be referenced by id:

Integrations

To enable/disable an integration plugins (like webhooks) use the field integrationids (array with integer ids to set or “null” tring to remove it)

Alert policies

To bind an alerting policy use the field alert_policy (numeric id to set it or string “null” to disable alerts)

Update a check:

>>> client.update_check(check, {"paused": True})

this will return True if an effective change was sent to the API and False otherwise (useful for idempotent usage, like ansible modules)

Delete a check:

>>> client.delete_check(check)

Maintenance windows

Retreive maintenance windows for production websites in the last 7 days:

>>> import datetime
>>> checks = client.get_checks(filters={"tags": ["production", "frontend"]})
>>> start = datetime.datetime.now() - datetime.timedelta(days=7)
>>> client.get_maintenances(filters={"checks": checks, "after": start})

Create a 1 hour maintenance window for production websites:

>>> start = datetime.datetime.now() + datetime.timedelta(minutes=10)
>>> end = start + datetime.timedelta(hours=1)

>>> window = client.create_maintenance({"checks": checks, "name": "pypingdom test maintenance", "start": start, "stop": end})

Delete future maintenance windows:

>>> windows = client.get_maintenances(filters={"checks": checks, "after": datetime.datetime.now()}):
>>> for m in maintenances:
    client.delete_maintenance(m)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pypingdom-0.1.3.tar.gz (14.1 kB view hashes)

Uploaded Source

Built Distributions

pypingdom-0.1.3-py3-none-any.whl (11.9 kB view hashes)

Uploaded Python 3

pypingdom-0.1.3-py2-none-any.whl (11.9 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page