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

Output Types

OTLP

Send logs as OpenTelemetry protobuf over HTTP or gRPC.

output:
  type: otlp
  endpoint: https://collector:4318
  protocol: http       # http | grpc
  compression: zstd    # zstd | none (gzip not yet supported)
  auth:
    bearer_token: "${OTEL_TOKEN}"

HTTP (JSON Lines)

POST newline-delimited JSON to any HTTP endpoint.

output:
  type: http
  endpoint: https://logging-service:9200
  auth:
    headers:
      X-API-Key: "${API_KEY}"

Stdout

Print to stdout for debugging/testing.

output:
  type: stdout
  format: console    # console | json | text
  • console: Colored, human-readable (timestamp, level, message, key=value pairs)
  • json: One JSON object per line (machine-parseable)
  • text: Raw text (uses _raw column if available)

Elasticsearch

Ship logs to Elasticsearch via the Bulk API.

output:
  type: elasticsearch
  endpoint: https://es-cluster:9200
  index: logs             # default: "logs"
  compression: gzip       # gzip | none (optional)
  request_mode: buffered  # buffered | streaming (optional, default buffered)
  • Bulk API: Per-document error handling with automatic retries.
  • Batch splitting: Large payloads are split automatically to stay within Elasticsearch limits.
  • Compression: Optional gzip compression for reduced network usage.
  • Streaming mode: Experimental chunked HTTP request bodies for benchmarking against hosted/serverless clusters.
FieldTypeRequiredDefaultDescription
endpointstringYesElasticsearch URL
indexstringNologsTarget index name
compressionstringNononegzip or none
request_modestringNobufferedbuffered or experimental streaming (streaming currently requires compression: none)

Loki

Push logs to Grafana Loki with automatic label grouping.

output:
  type: loki
  endpoint: http://loki:3100
FieldTypeRequiredDescription
endpointstringYesLoki push URL

Multiple outputs (fan-out)

outputs:
  - name: collector
    type: otlp
    endpoint: https://collector:4318
  - name: debug
    type: stdout
    format: console