List monitors
List monitors the caller can read, with filtering and cursor-based pagination. Results are ordered by creation time, newest first. Deleted and draft monitors are excluded.
The shape of each returned monitor varies by type (DATA_QUALITY, PERFORMANCE, DRIFT, CUSTOM_METRIC, TRACING).
All filters are optional and compose with AND semantics (a monitor must match every provided filter). When a filter is omitted, no filtering is applied for that field. Filters that cannot be satisfied together — a metric filter from one family combined with a type from another, or two metric filters from different families — are valid input and return a 200 with an empty monitors array, as does any other combination that simply matches nothing.
The four name filters do not all match the same way. name and space_name are case-insensitive substring searches, so name=prod matches "production". project_name and dimension_name are exact, case-sensitive matches, so they need the full name as stored — for dimension_name, the value copied verbatim from a returned monitor's dimension.name.
An identifier that is not a well-formed ID of the expected kind returns a 400. A well-formed space_id, project_id, or custom_metric_id that either does not exist or is not readable by the caller returns the same 404 in both cases, so the response never reveals whether the referenced resource exists.
A caller whose credentials grant monitor read access in no space at all receives a 403.
<Warning>This endpoint is in alpha, read more here.</Warning>
Query parameters
A universally unique identifier (base64-encoded opaque string).
Filter search results to a particular space ID
Case-insensitive substring filter on the space name. Narrows results to resources in spaces whose name contains the given string. If omitted, no space name filtering is applied and all resources are returned.
Case-insensitive substring filter on the resource name. Returns only resources whose name contains the given string. For example, name=prod matches "production", "my-prod-dataset", etc. If omitted, no name filtering is applied and all resources are returned.
A universally unique identifier (base64-encoded opaque string).
Filter results to resources associated with a specific project (base64 identifier). If omitted, results are not filtered by project.
Exact-match filter on the name of the project the monitor's primary metric is computed over. Unlike name and space_name, this is an exact (case-sensitive) match, not a substring search. If omitted, no project name filtering is applied.
The kind of monitor. Determines which type-specific fields apply.
- DATA_QUALITY - Monitors a data quality metric (e.g. percent empty, CARDINALITY).
- PERFORMANCE - Monitors a model performance metric (e.g. ACCURACY, RMSE).
- DRIFT - Monitors distributional drift of a feature/output.
- CUSTOM_METRIC - Monitors a user-defined custom metric.
- TRACING - Monitors a span/trace-derived metric (e.g. span attributes, evals).
Filter by monitor type. Types are exact: DATA_QUALITY does not include TRACING monitors, and PERFORMANCE does not include CUSTOM_METRIC monitors. If omitted, monitors of all types are returned.
The monitor's current state from its most recent evaluation.
- TRIGGERED - The metric breached the threshold.
- CLEARED - The metric is within healthy bounds.
- NO_DATA - No data was available to evaluate.
Filter by the monitor's current evaluation state (TRIGGERED, CLEARED, or NO_DATA). If omitted, monitors in every state are returned.
Filter by whether notifications fire on a triggered transition. true returns only monitors with notifications enabled; false returns only monitors with notifications disabled. If omitted, monitors are returned regardless of notification state.
The category of dimension the metric is evaluated over.
Filter to monitors whose metric is computed over a dimension of this category. Values copied from a returned monitor's dimension.category work as filters. If omitted, no dimension category filtering is applied.
Exact-match filter on the name of the dimension the monitor's metric is computed over. Values copied from a returned monitor's dimension.name work as filters. If omitted, no dimension name filtering is applied.
The data quality metric computed over the selected dimension.
Filter to monitors computing this data quality metric. Matches both DATA_QUALITY and TRACING monitors; combine with type to narrow to one of them. If omitted, no data quality metric filtering is applied.
The model performance metric.
Filter to PERFORMANCE monitors computing this performance metric. Does not match CUSTOM_METRIC monitors. If omitted, no performance metric filtering is applied.
The statistical drift metric. PSI/KL/JS/KS apply to structured data; EUCLIDEAN_DISTANCE/COSINE_SIMILARITY apply to unstructured (embedding) data.
Filter to DRIFT monitors computing this drift metric. If omitted, no drift metric filtering is applied.
A universally unique identifier (base64-encoded opaque string).
Filter to CUSTOM_METRIC monitors evaluating this custom metric (base64 identifier). If omitted, no custom metric filtering is applied.
Maximum items to return
Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.
Response
Returns a list of monitor objects