Skip to main content
tolmo monitor manages the Datadog monitors that Tolmo owns for your organization. Tolmo resolves the Datadog credentials on the server, so the CLI never sees them. Tolmo adds the managed-by:tolmo tag to each monitor that it creates. This tag separates these monitors from the monitors that you manage outside Tolmo.

​
List managed monitors

tolmo monitor list lists the monitors that the selected integration can see. Use --tag to show only Tolmo’s monitors. Add --json to get machine-readable output:
To inspect one monitor by its Datadog ID, use monitor get:
You can also filter by --name. To paginate, use --page-size (up to 1000) and the zero-based --page:

​
Create a monitor

Write a JSON spec in the Datadog monitor API format. You do not need to add the managed-by:tolmo tag. Tolmo adds it before it sends the request to Datadog. Pass the spec as a file path, or pipe it from stdin:

​
Update a monitor

Pass the monitor’s Datadog ID and a JSON patch file with the fields to change:
tolmo monitor update and tolmo monitor delete return HTTP 403 for any monitor without the managed-by:tolmo tag. This rule protects the monitors that you manage outside Tolmo from accidental changes.

​
Delete a monitor

Delete a Tolmo-managed monitor by its Datadog ID:
The command returns HTTP 403 for a monitor without the managed-by:tolmo tag.

​
Multiple Datadog integrations

If you connected more than one Datadog account, select one with --integration <integration-id>. tolmo query list shows the integration IDs. For example:

​
Example monitor spec

This minimal spec creates a CPU alert. Change the query, message, and thresholds for your environment. Then pass the file to tolmo monitor create:
cpu-monitor.json