isabella232 / datadog-deployer

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

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