Skip to main content

raw_http subscriber

POSTs enriched events as JSON to any HTTP endpoint. Good for AWS Lambda function URLs, generic HTTP receivers, or the upstream OTel Collector's webhookevent receiver. For native OTLP delivery use the otel subscriber.

Add to the subscribers block in config.yaml:

subscribers:
raw_http:
enabled: true
url: "https://my-endpoint.example.com/events"
method: "POST"
headers:
Authorization: "Bearer my-token"
X-Custom-Header: "my-value"
batch_size: 1 # 1 = one event per request; >1 = JSON array batching
flush_interval: 5s
skip_verify: false
workers: 1 # parallel HTTP POSTs (raise for slow endpoints)
buffer_size: 1000
# Per-event filter — drop before batching/compaction. include is any-of,
# exclude is none-of. See ../ "Per-Subscriber Filtering".
include: []
exclude: []

Available fields and defaults

FieldDefaultDescription
urlTarget endpoint
methodPOSTHTTP method
headersExtra HTTP headers
batch_size1Events per request. 1 sends each event as a JSON object; >1 batches as JSON array
flush_interval5sMax time to wait before flushing a partial batch
skip_verifyfalseSkip TLS verification
workers1Parallel HTTP POSTs. Raise to 4–8 for slow endpoints
buffer_size1000Subscriber channel capacity
include[]Per-event predicates against the enriched payload; any-of. Empty = pass everything. See Per-subscriber filtering.
exclude[]Per-event predicates; none-of — drop on match.

See Common tuning for workers and buffer_size semantics.