Skip to main content

​
Access log

ONR emits one-line request logs. Common fields include:
  • request_id, status, latency_ms, method, path, client_ip
  • routing (when available): api, provider, provider_source, model, stream
  • upstream (when available): upstream_status, finish_reason
  • usage/cost (when enabled and extractable): token fields and cost breakdown
See AppName for how the appname field is resolved.

​
Dashboards

ONR includes an optional Grafana + Loki + Promtail stack and a prebuilt access-log dashboard. See Dashboards for setup and notes on label cardinality.

​
Access log format

If you use a custom logging.access_log_format, see Access Log Fields for the full variable list and semantics.

​
Traffic dump (file-based)

Enable file-based dumps for debugging:
  • traffic_dump.enabled / ONR_TRAFFIC_DUMP_ENABLED
  • traffic_dump.dir / ONR_TRAFFIC_DUMP_DIR
  • traffic_dump.file_path / ONR_TRAFFIC_DUMP_FILE_PATH (template supports {{.request_id}})
  • traffic_dump.max_bytes / ONR_TRAFFIC_DUMP_MAX_BYTES
  • traffic_dump.mask_secrets / ONR_TRAFFIC_DUMP_MASK_SECRETS
  • traffic_dump.sections / ONR_TRAFFIC_DUMP_SECTIONS (comma-separated allowlist; empty means all sections)
Captured sections (default: all; configurable via traffic_dump.sections):
  • META
  • ORIGIN REQUEST
  • UPSTREAM REQUEST
  • UPSTREAM RESPONSE
  • PROXY RESPONSE
  • STREAM