Metrics
GET /metrics serves these series in the Prometheus text format when --server-enable-prometheus is set. Protect it with --server-prometheus-auth or move it to a private listener with --server-prometheus-bind-address and --server-prometheus-bind-port.
| Metric | Type | Labels | Description |
|---|---|---|---|
zshot_ | counter | endpoint, format, outcome | Completed renders. outcome is success or error. |
zshot_ | histogram | format, cache, status | REST render response time; MCP renders are not counted. cache is hit or miss; status is the HTTP status code. |
zshot_ | gauge | Renders in progress. | |
zshot_ | gauge | Requests waiting in the concurrency queue. | |
zshot_ | gauge | kind | Browsers open. kind is render for a request’s own browser, crawl for a crawl’s further browsers, or cdp for --cdp pages. A crawl counts as one request in flight however many browsers it runs. |
zshot_ | counter | endpoint, format, reason | Rejected credentials or signatures. |
zshot_ | counter | role, provider, name | Navigator and formatter model calls, failed calls included. |
zshot_ | counter | role, provider, name, type | Model tokens. type is input or output; input includes cached tokens. |
zshot_ | counter | role, provider, name, type | Cached input tokens. type is read or write. |
zshot_ | counter | method, endpoint, status | Every HTTP request. |
zshot_ | histogram | method, endpoint, status | Every HTTP request’s response time. |
zshot_ | gauge | method, endpoint | HTTP requests in progress. |
Labels
| Label | Values |
|---|---|
endpoint on zshot_ series | get, post, delete, mcp, assets, metrics |
endpoint on zshot_ series | the request path |
format | the output type’s extension, or none for / |
reason | missing_, invalid_, missing_, invalid_, expired_, missing_, expires_ |
role | navigator or formatter |
name | the model’s name=, empty without one; past 100 distinct names, (other) |