Prometheus metrics

DataPress can expose an HTTP endpoint in Prometheus text format so a scraper can track request volume, latency, and status-code distribution. Metrics are produced by the actix-web-prom middleware and cover every HTTP request the server handles.

The endpoint is unauthenticated and sits in front of the auth layer, just like the health probes — scrapers rarely carry bearer tokens, and the endpoint exposes only aggregate request counters, never row data. Isolate it at the network layer (bind to a private interface, restrict via firewall / NetworkPolicy, or scrape over the pod network only).

Build

Metrics are opt-in at compile time so binaries without them stay slim:

cargo build --release -p datapress-duckdb --features docs,swagger,metrics

When the binary is built without metrics but [metrics] enabled = true in the TOML, the server logs a warning at startup and skips the endpoint.

Configuration

[metrics]
enabled = true
path    = "/metrics"

Key	Default	Notes
enabled	false	Master switch. When false the endpoint is not served.
path	"/metrics"	Endpoint path. Must start with / and not end with /. Served at the bare host root, independent of the configured URL prefix.

The path must not collide with reserved mounts (/, /api, /health, /healthz, /readyz, /version) or with the docs / swagger paths; startup validation rejects the config otherwise.

From Python

from datap_rs.datapress import DataPress, DataPressConfig, DatasetConfig

config = DataPressConfig(
    backend="duckdb",
    listen="0.0.0.0",
    port=8080,
    metrics_enabled=True,
    metrics_path="/metrics",
)

This requires a wheel built with the metrics feature.

What it exposes

Metric names are prefixed with the datapress namespace:

Metric	Type	Labels
datapress_http_requests_total	counter	endpoint, method, status
datapress_http_requests_duration_seconds	histogram	endpoint, method, status

curl -s http://localhost:8080/metrics | head
# # HELP datapress_http_requests_duration_seconds HTTP request duration in seconds.
# # TYPE datapress_http_requests_duration_seconds histogram
# ...
# # HELP datapress_http_requests_total Total number of HTTP requests.
# # TYPE datapress_http_requests_total counter
# datapress_http_requests_total{endpoint="/healthz",method="GET",status="200"} 4

All workers share a single registry, so counts aggregate across the worker pool.

Scrape config

scrape_configs:
  - job_name: datapress
    metrics_path: /metrics
    static_configs:
      - targets: ["datapress.internal:8080"]