Synthetic monitoring
Monitor health, latency, regional history, events, certificates, and security reports. Required resource or feature: Configured synthetic HTTP or DNS monitor.
Metric families and dimensions
Section titled “Metric families and dimensions”Select the configured HTTP or DNS monitor and supported region and time dimensions. Transport Layer Security (TLS) monitor queries add protocol, grade, and certificate expiration information. Historical measurements and retrieval of existing security reports remain separate from current monitor state.
Use Query concepts for shared request guidance and table conventions.
Statistics and analytics queries
Section titled “Statistics and analytics queries”| Method and exact path | Information returned | Scope and principal filters | Specification reference |
|---|---|---|---|
GET /api/observability/synthetic_monitor/namespaces/{namespace}/certificate-summary | Certificate Summary; returns items | Selected namespace; period_in_days | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/dns-monitor-summary | DNS Monitor Summary; returns avg_latency, health, last_critical_event_timestamp, latency, max_latency | Selected namespace; start_time, end_time, monitor_name | Operation · Request schema · Response schema |
POST /api/observability/synthetic_monitor/namespaces/{namespace}/dns-monitors-health | DNS Monitor Health; returns items | Selected namespace; include_latency, monitor_names | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/global-history | Global History; returns items | Selected namespace; monitor_type, start_time, end_time, step_size | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/global-summary | Global Summary; returns critical_monitor_count, healthy_monitor_count, number_of_monitors | Selected namespace; monitor_type | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/health | Synthetic monitoring service health | Selected namespace; No additional selector | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/http-monitor-detail | HTTP Monitor Detail; returns items | Selected namespace; monitor_name, start_time, end_time | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/http-monitor-summary | HTTP Monitor Summary; returns avg_latency, cert_expiry_date, health, last_critical_event_timestamp, latency | Selected namespace; start_time, end_time, monitor_name | Operation · Request schema · Response schema |
POST /api/observability/synthetic_monitor/namespaces/{namespace}/http-monitors-health | HTTP Monitor Health; returns items | Selected namespace; include_latency, monitor_names | Operation · Request schema · Response schema |
POST /api/observability/synthetic_monitor/namespaces/{namespace}/metric-query | Metric Query Data; returns data | Selected namespace; end_time, metrics, start_time, step_size | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/monitor-events | Monitor Events; returns events | Selected namespace; monitor_type, monitor_name, start_time, end_time | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/monitor-history | Monitor History; returns histories | Selected namespace; monitor_type, start_time, end_time, step_size, monitor_name | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/record-type-summary | Record Type Summary; returns items | Selected namespace; No additional selector | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/source-summary | Source Summary; returns monitor_by_source | Selected namespace; monitor_type, label_filter, monitor_name | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/tls-report-summary | TLS Report Summary; returns grade, grade_reason, protocols, score | Selected namespace; monitor_name | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/tls-summary | TLS Summary; returns items | Selected namespace; No additional selector | Operation · Request schema · Response schema |
Related discovery and status
Section titled “Related discovery and status”| Method and exact path | Information returned | Scope and principal filters | Specification reference |
|---|---|---|---|
GET /api/observability/synthetic_monitor/namespaces/{namespace}/filtered-dns-monitor-list | Filtered DNS Monitor List; returns errors, items | Selected namespace; filter, page, limit, sort | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/filtered-http-monitor-list | Filtered HTTP Monitor List; returns errors, items | Selected namespace; filter, page, limit, sort | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/v1_dns_monitors | DNS Monitor; returns errors, items | Selected namespace; label_filter, report_fields, report_status_fields | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/v1_dns_monitors/{name} | DNS Monitor; returns create_form, deleted_referred_objects, disabled_referred_objects, metadata, referring_objects | Selected namespace; name, response_format | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/v1_http_monitors | HTTP Monitor; returns errors, items | Selected namespace; label_filter, report_fields, report_status_fields | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/v1_http_monitors/{name} | HTTP Monitor; returns create_form, deleted_referred_objects, disabled_referred_objects, metadata, referring_objects | Selected namespace; name, response_format | Operation · Request schema · Response schema |
Existing reports and artifacts
Section titled “Existing reports and artifacts”| Method and exact path | Information returned | Scope and principal filters | Specification reference |
|---|---|---|---|
GET /api/observability/synthetic_monitor/namespaces/{namespace}/certificate-report-detail | Certificate Report Detail; returns entries | Selected namespace; No additional selector | Operation · Request schema · Response schema |
GET /api/observability/synthetic_monitor/namespaces/{namespace}/tls-report-detail | TLS Report Detail; returns ssl_check_html_report | Selected namespace; monitor_name | Operation · Request schema · Response schema |