--server-enable-prometheus
Serves the GET /metrics Prometheus endpoint and collects its metrics.
Protect or relocate the endpoint with --server-prometheus-auth, --server-prometheus-bind-address, and --server-prometheus-bind-port.
Enterprise license. Requires --server.
Exposed metrics
All series share the zshot_ prefix. The zshot_requests_* / render metrics describe renders by their semantics (output format, cache, endpoint); the lower-level zshot_http_requests_* metrics describe raw HTTP traffic by route, method, and status.
| Metric | Type | Labels | Description |
|---|---|---|---|
zshot_requests_total | counter | endpoint, format, outcome | Completed renders. endpoint is get/post/mcp; outcome is success/error. Filter outcome="success" for successful renders by format and endpoint. |
zshot_request_duration_seconds | histogram | format, cache, status | REST render response time in seconds, segmented by output type, cache hit/miss, and HTTP status. MCP is not included here. |
zshot_auth_failures_total | counter | endpoint, format, reason | Authentication rejections. reason is missing_credentials, invalid_credentials, missing_signature, invalid_signature, expired_signature, missing_expires, or expires_too_far. |
zshot_requests_in_flight | gauge | — | Renders currently being processed. |
zshot_requests_queued | gauge | — | Renders waiting in the concurrency queue. |
zshot_http_requests_total | counter | method, status, endpoint | All HTTP responses, by route. |
zshot_http_requests_duration_seconds | histogram | method, status, endpoint | Latency of all HTTP requests, by route. |
zshot_http_requests_pending | gauge | method, endpoint | In-flight HTTP requests, by route. |