synthetics

Search monitors

Spaces method and path for this operation:

<div><span class="operation-verb get">get</span>&nbsp;<span class="operation-path">/s/{space_id}/api/synthetics/monitors</span></div>

Refer to Spaces for more information.

Get a list of monitors.

You must have read privileges for the Synthetics feature in the Observability section of the Kibana feature privileges.<br/><br/>[Required authorization] Route required privileges: uptime-read.

get/api/synthetics/monitors

Request

  • Base URL
    https://localhost:5601
  • URL
    https://localhost:5601/api/synthetics/monitors
  • Auth
    • API key in header Authorization
    • or HTTP basic

Query parameters

querystring

A free-text query string.

filterstring

Additional KQL filtering criteria.

tagsstring[]

Tags to filter monitors. Accepts a string or an array of strings.

monitorTypesstring[]

The monitor types to filter by, such as http. Accepts a string or an array of strings.

locationsstring[]

The location IDs to filter by. Accepts a string or an array of strings.

projectsstring[]

The projects to filter by. Accepts a string or an array of strings.

schedulesstring[]

The schedules to filter by. Accepts a string or an array of strings.

remoteNamesstring[]

A string or an array of strings.

statusstring[]

The monitor statuses to filter by. Accepts a string or an array of strings.

monitorQueryIdsstring[]

The monitor query IDs to filter by. Accepts a string or an array of strings.

configIdsstring[]

The monitor config IDs to filter by. Accepts a string or an array of strings.

'true' | 'false'
OR
boolean

If true, return monitors from all spaces the user can access.

useLogicalAndForstring[]

Apply logical AND for tags and/or locations. Accepts a string or an array.

dateRangeStartstring

The start of the status window, as datemath (now-15m) or an ISO-8601 timestamp.

dateRangeEndstring

The end of the status window, as datemath (now) or an ISO-8601 timestamp.

pagenumber

The page number for paginated results.

perPagenumber

The number of items to return per page.

sortField'enabled' | 'status' | 'updated_at' | 'created_at' | 'urls' | 'name' | 'tags' | 'project_id' | 'type' | 'schedule' | 'journey_id'

The field to sort the results by.

sortOrder'desc' | 'asc'

The sort order.

searchAfterstring[]

A JSON array of sort values from the previous page, for cursor-based paging.

Response

A successful response.

absoluteTotalinteger
monitorsobject[]
pageinteger
perPageinteger
totalinteger

Changes

No operation changes recorded.