Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Monitoring & Diagnostics

Enable the diagnostics server in your config:

server:
  diagnostics: 0.0.0.0:9090

Endpoints

EndpointDescription
GET /healthLiveness probe (uptime, version)
GET /readyReadiness probe (200 once initialized)
GET /api/pipelinesDetailed JSON with per-stage metrics
GET /api/statsFlattened JSON for polling/benchmarks
GET /api/configView active YAML configuration
GET /api/logsView recent log lines from stderr
GET /api/historyTime-series data for dashboard charts
GET /api/tracesDetailed latency spans for recent batches
GET /HTML dashboard

Key metrics

MetricDescription
logfwd_input_lines_totalLines read per input
logfwd_transform_lines_inLines entering SQL transform
logfwd_transform_lines_outLines after filtering
logfwd_stage_seconds_totalTime per stage (scan, transform, output)
logfwd_flush_reason_totalFlush triggers (size vs timeout)

OTLP metrics push

server:
  metrics_endpoint: http://otel-collector:4318
  metrics_interval_secs: 60