datadog-deployer 0.4.0

A simple command line utility to deploy datadog monitors from code.

dump

datadog-deployer dump

dumps the current datadog monitor definitions to the filename

Options:

--account TEXT

name of the Datadog account.

--filename PATH

to dump the monitors to.

--help

Show this message and exit.

deploy

datadog-deployer deploy

Deploys the datadog monitor definitions from filename. Compares the monitors with the deployed monitors and determines for each monitor whether to insert or update. Monitors defined in datadog which are not in defined in the file are left, unless –force-delete is specified.

Options:

--account TEXT

name of the Datadog account.

--filename PATH

to deploy monitors from.

--verbose

showing change details that are applied.

--dry-run

only show changes that would be applied.

--force-delete

monitors in datadog not defined in the file.

--help

Show this message and exit.

Example

Dump the current monitor definitions:

$ datadog-deployer dump --filename dd-monitors.yaml

Update the monitor definitions:

$ datadog-deployer deploy --filename dd-monitors.yaml
INFO: 5 inserts, 1 updates, 2 unmanaged and 33 unchanged.
INFO: "VPN connectivity" not defined in file. use --force-delete to delete.
INFO: "Invalid objects in Oracle" not defined in file. use --force-delete to delete.

If you want to delete unmanaged monitors, type:

$ datadog-deployer deploy --filename dd-monitors.yaml --force-delete
INFO: 0 inserts, 0 updates, 2 deletes and 39 unchanged.

File formats The file ~/.datadog.ini is a Python configuration file from which the Datadog connection parameters are read. At least it will need the api_key and api_app attributes in the section DEFAULT:

[DEFAULT]
api_key=a77aaaaaaaaaaaaaaaaaaaaa
app_key=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb

Other attributes you can add are: proxies, api_host, statsd_host, statsd_port, statsd_socket_path, cacert, mute