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

Input Types

File

Tail one or more log files with glob pattern support.

input:
  type: file
  path: /var/log/pods/**/*.log
  format: cri      # cri | json | raw | auto
  • Glob re-scanning: New files matching the pattern are discovered automatically (every 5s).
  • Rotation handling: Detects file rotation (rename + create) and switches to the new file. Drains remaining data from the old file before switching.
  • Formats: CRI (Kubernetes container runtime), JSON (newline-delimited), raw (plain text, each line becomes {"_raw": "..."})

Generator

Emit synthetic JSON log lines for benchmarking and pipeline testing. No external data source is required.

FieldTypeRequiredDefaultDescription
listenstringNo(unlimited)Target events per second, e.g. "50000". Omit for maximum throughput.
input:
  type: generator
  listen: "50000"   # ~50,000 events/sec; omit for unlimited

Use --generate-json <n> <file> on the CLI to write a fixed number of lines to a file instead.

UDP

Receive log lines on a UDP socket.

input:
  type: udp
  listen: 0.0.0.0:514
  format: syslog

TCP

Accept log lines on a TCP socket.

input:
  type: tcp
  listen: 0.0.0.0:5140
  format: json

OTLP

Receive OTLP log records from another agent or SDK.

input:
  type: otlp