Configuration

sre.yaml

The main config file. Set SRE_CONFIG_FILE env var to point to your own (default: app/config/sre.yaml).

provider: http          # preset to use (traefik | http)
default_service: api    # service shown on load

services:
  - name: api
    slo_target: 99.5    # SLO target in percent
    labels:
      service: api      # fills {service} in query templates

  - name: frontend
    slo_target: 99.9
    labels:
      service: frontend

Provider presets

Presets live in app/config/providers/. Each defines latency_unit and a queries map.

Preset	File	Works with
traefik	traefik.yaml	Traefik + dockerstats + node_exporter
http	http.yaml	Any app with standard HTTP metrics

Custom query overrides

Add a queries: block to sre.yaml to override or extend the preset:

provider: http
queries:
  # replace the default availability query
  availability: 'avg_over_time(my_custom_up{job="{service}"}[{window}]) * 100'
  # add a signal the preset doesn't have
  saturation: 'my_cpu_ratio{container="{container}"}'

Query templates use {service}, {container}, {window} as placeholders. Escape literal PromQL braces as {{ and }}.

Adding a provider preset

Create app/config/providers/<name>.yaml:

name: mystack
latency_unit: seconds   # or "milliseconds"
queries:
  availability: '...'
  request_rate: '...'
  latency_p99:  '...'
  error_rate:   '...'
  saturation:   '...'       # optional
  cap_vps_cpu:  '...'       # optional
  cap_vps_mem:  '...'       # optional
  cap_vps_disk: '...'       # optional
  cap_container_cpu: '...'  # optional
  cap_container_mem: '...'  # optional

Then set provider: mystack in sre.yaml.

Environment variables

Infrastructure

Variable	Default	Description
PROMETHEUS_URL	http://prometheus:9090	Prometheus API endpoint
SRE_CONFIG_FILE	app/config/sre.yaml	Path to main config
TRAEFIK_HOST	(unset)	Domain for Traefik TLS routing
COMPOSE_PROJECT_NAME	sre	Docker Compose project name

UI customization

These are injected at serve time — no rebuild required. Set them in .env or your Docker environment.

Variable	Default	Description
SRE_TITLE	SRE Ops — Mission Control	Browser tab title and dashboard heading
SRE_TIMEZONE	UTC	Clock display timezone — any IANA tz string (e.g. America/New_York, Europe/Berlin). Run timedatectl list-timezones to list all valid values
SRE_WINDOW	28d	Prometheus evaluation window for SLO and error budget queries. Day format only (e.g. 7d, 14d, 30d)
SRE_FAVICON	/favicon.png	URL to a custom favicon and sidebar logo. To serve a local file, mount it into the container at frontend/dist/<name> and set this to /<name>
SRE_ACCENT	#caff04	Override UI accent color. 6-digit hex string (e.g. #3b82f6). Applied at runtime — no rebuild needed.

Example .env:

SRE_TITLE=Acme SRE Dashboard
SRE_TIMEZONE=America/Chicago
SRE_WINDOW=30d
SRE_FAVICON=https://example.com/logo.png