Recent check results of a monitor
monitor_resultsThe monitor’s check results, newest first. With resolution=raw (the default) each result is one check by one probe, filterable by status; for HTTP, API and keyword monitors it also says where the response time went, in milliseconds: dns_ms, connect_ms, tls_ms, server_ms (waiting for the first byte) and download_ms, null when the location did not measure them, and response_bytes, how big the answer’s body was (null for a HEAD request, or a location on an older version). Its meta holds what the check saw: a keyword check’s page_bytes and, when it failed, an excerpt of the page’s text (at most 512 bytes); a ping’s sent, received, loss_pct and jitter_ms; a DNS check’s records with their ttl and the resolver asked (null for the location’s own); a redirect check’s hops, each url (without its query) and status; a heartbeat’s run_duration_ms when the check-in sent duration, and for a run your agent reported, its exit_code, job_run_id and, when it failed, the masked last lines of its output — only when you can manage servers (cloud.write, on your role and on your token); otherwise output is left out and output_hidden is true. output_removed says who removed that output and when (by, at). Individual results are kept for 3 days. With resolution=hour or day each row sums one hour or one day across probes: checks by outcome (checks_up, checks_degraded for slow checks, checks_down for failures), up_percent and the p50 and p95 response times, reaching back as far as your plan keeps history. Set the window with from and to (ISO 8601; default: everything kept for raw, the last 24 hours for hours, the last 30 days for days), narrow it to one probe region, and page with page and per_page (up to 500, default 50). A range longer than the resolution allows — 3 days raw, 31 days by hour, 366 days by day — is refused with range_too_large. window repeats the range that was applied. Newest first. For uptime or response times over a period, monitor_stats is one call.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"monitor_id": "<monitor_id>"
},
"name": "monitor_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only results up to this time (ISO 8601). | |
| from | No | Only results from this time on (ISO 8601). | |
| page | No | Page number, from 1. | |
| status | No | Only results with this status, e.g. down. | |
| per_page | No | Rows per page, up to 500 (default 50). | |
| monitor_id | Yes | The monitor id, from list_monitors or the number of a search hit monitor:N. | |
| resolution | No | raw: each check (last 3 days, up to 3 days per call); hour or day: summed per hour (up to 31 days) or per day (up to 366 days). | |
| organization_id | No | The organization to read. Leave it out when the token reaches only one. |