Skip to content
Slipwaydocs

Prometheus

PromQL queries for canary verification and deploy annotations.

At a glance

Section titled “At a glance”
Category Observability
Authentication None, bearer token or mTLS
Provider id prometheus

What it does

Section titled “What it does”
  • Canary verification queries
  • Environment health signals

Set up

Section titled “Set up”
  1. Create a read-only credential or enable workload identity for the metrics API.
  2. Add the integration in Slipway and run Test to execute a trivial query.
  3. Reference it from a canary verification block by provider name.
  4. Dry-run the queries against a past deployment before relying on them.

Configuration

Section titled “Configuration”

Illustrative configuration. Non-secret settings are stored as integration config; credentials are stored as encrypted Slipway secrets and referenced by name.

provider: prometheus
config:
  url: https://prometheus.example.com
  bearer_token_secret: PROM_TOKEN
verification_query: |
  sum(rate(http_requests_total{service="api",status=~"5.."}[2m]))
  / sum(rate(http_requests_total{service="api"}[2m]))

Notes

Section titled “Notes”

See Canary verification for how thresholds and intervals are evaluated.

Section titled “Related”