To install simply
$ pip install pingdomexport
Check the configuration file.
Place the configuration file in any place that seems fit to you. Make sure the user you will use to run pingdom export has read access to the configuration file.
pingdom_access:
username: dummy
password: dummy
account_email: dummy
app_key: dummy
The username, password and account email should be easy to fill in (is your credentials to log in in pindgom).
To get your app key, log in on pingdom then go to Integrations > The Pingdom API > Register Application
# the checks that you want to export data
checks:
# 3 strategies supported
# all: all checks
# include: will only include the ids specified
# exclude: all checks except the ids specified
strategy: all
ids: []
Pindgom export allows to export all checks:
checks:
strategy: all
ids: []
Specify the checks to export:
checks:
strategy: include
ids: [12454, 32932]
Specify the checks to exclude (will export every check except the ones specified):
checks:
strategy: exclude
ids: [12454]
Pingdom export allows to export the checks and results to mysql, postgres or the stdout.
load:
# type: output|mysql|postgres
type: output
parameters: []
# if mysql
#parameters:
# db_url: mysql+pymysql://user:password@host/database
# if postgres
#parameters:
# db_url: postgres://user:password@host/database
If output:
load:
type: output
parameters: []
If mysql:
load:
type: mysql
parameters:
db_url: mysql+pymysql://user:password@host/database
If posgres:
load:
type: postgres
parameters:
db_url: mysql+pymysql://user:password@host/database
If you are going to export for database then you need to create the schema upfront:
Both MySQL and Postgres requires a user with SELECT,INSERT,UPDATE,DELETE permissions to the DB. In case of Postgres the user also requires access to sequences.
To list the options available:
$ pingdom-run-export --help
Export only checks information:
$ pingdom-run-export --config /full/path/to/config.yml --type checks
Export only checks results:
$ pingdom-run-export --config /full/path/to/config.yml --type results
Export checks information & results:
$ pingdom-run-export --config /full/path/to/config.yml --type all
By default the pingdom export will always export the full results. There is optional arguments to allow to specify a time range, eg:
$ pingdom-run-export --config /full/path/to/config.yml --type results --checks-from 1465071758 --checks-to 1465158158
In case you have multiple checks with months of history, running everything in a single thread will probably take too much time.
You can use multiple configuration files and run one pingdom export per check. Then just have a crontab running daily and use the checks-from and checks-to.