Operations

Metrics


The orchestrator exposes Prometheus-compatible metrics on a dedicated HTTP endpoint. These cover workflow execution, task performance, queue depth, database pool health, journal cache efficiency, polling latency, retry rates, and dead letter queue depth.

  • Prometheus-native — Standard /metrics endpoint with all metrics following Prometheus naming conventions
  • Dedicated metrics port — Metrics are served on port 8001, separate from the gRPC (50051) and HTTP (8080) APIs
  • Comprehensive coverage — 100+ metrics across workflows, tasks, queues, storage, polling, retries, and DLQ
  • Zero-config — Sensible defaults with environment variable overrides

Metrics Endpoint

The orchestrator serves metrics at:

1
http://<host>:8001/metrics

A health endpoint is also available:

1
http://<host>:8001/health

Configuration

1
# Enable metrics (enabled by default)
2
ORCHER_METRICS_ENABLED=true
3
4
# Metrics bind address
5
ORCHER_METRICS_ADDRESS="0.0.0.0:8001"
6
7
# Log level and format
8
LOG_LEVEL=info
9
LOG_FORMAT=json # json or pretty

Next Steps