Synthetic monitors API - GET all monitors

Lists all synthetic monitors from your environment. The list contains only the names and IDs of monitors. To retrieve details, use the GET a monitor call.

This request is an early adopter release and may be changed in non compatible way.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/synthetic/monitors
  • SaaS https://{your-environment-id}.live.dynatrace.com/api/v1/synthetic/monitors

Parameters

Parameter Type Description In Required
managementZone integer

Filters the resulting set of monitors to those which are part of the specified management zone.

query optional
tag array

Filters the resulting set of monitors by specified tags.You can specify several tags in the following format: tag=tag1&tag=tag2. The monitor has to match all the specified tags.

In case of key-value tags, such as imported AWS or CloudFoundry tags use following format: [context]key:value.

query optional
location string

Filters the resulting set of monitors to those assigned to a specified location.

query optional
assignedApps array

Filters the resulting set of monitors to those assigned (manually or automatically) to certain apps.

query optional
type string

Filters the resulting set of monitors to those of a given type.

query optional
enabled boolean

Filters the resulting set of monitors to those which are enabled or disabled

query optional

Response format

The Monitors object

A list of synthetic monitors

Element Type Description
monitors MonitorCollectionElement[]

The list of synthetic monitors.

The MonitorCollectionElement object

The short representation of a synthetic monitor.

Element Type Description
name string

The name of a synthetic object.

entityId string

The ID of a synthetic object.

type string

The type of a synthetic monitor.

enabled boolean

The state of a synthetic monitor.

Example

In this example, the request lists all available monitors of the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to the first three entries.

Curl

curl -X GET \
  https://mySampleEnv.live.dynatrace.com/api/v1/synthetic/monitors \
  -H 'Authorization: Api-Token abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v1/synthetic/monitors

Response body

{
  "monitors": [
    {
      "name": "easyTravel Angular",
      "entityId": "SYNTHETIC_TEST-000000000000C69F"
    },
    {
      "name": "dynatrace.com",
      "entityId": "SYNTHETIC_TEST-0000000000025434"
    },
    {
      "name": "easytravel special offers",
      "entityId": "SYNTHETIC_TEST-000000000000987A"
    }
  ]
}

Response code

200