Merge pull request #3415 from xoxys/proxy-stats

add documentation how to access pull-through proxy stats
This commit is contained in:
João Pereira 2021-05-13 11:31:23 +01:00 committed by GitHub
commit c63b580546
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -913,11 +913,17 @@ access to the debug endpoint is locked down in a production environment.
The `debug` section takes a single required `addr` parameter, which specifies The `debug` section takes a single required `addr` parameter, which specifies
the `HOST:PORT` on which the debug server should accept connections. the `HOST:PORT` on which the debug server should accept connections.
If the registry is configured as a pull-through cache, the `debug` server can be used
to access proxy statistics. These statistics are exposed at `/debug/vars` in JSON format.
## `prometheus` ## `prometheus`
The `prometheus` option defines whether the prometheus metrics is enable, as well The `prometheus` option defines whether the prometheus metrics is enable, as well
as the path to access the metrics. as the path to access the metrics.
>**NOTE**: The prometheus metrics do **not** cover pull-through cache statistics.
> Proxy statistics are exposed via `expvar` only.
| Parameter | Required | Description | | Parameter | Required | Description |
|-----------|----------|-------------------------------------------------------| |-----------|----------|-------------------------------------------------------|
| `enabled` | no | Set `true` to enable the prometheus server | | `enabled` | no | Set `true` to enable the prometheus server |