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
| Field | Default | Description |
|---|---|---|
url | — | Target endpoint |
method | POST | HTTP method |
headers | — | Extra HTTP headers |
batch_size | 1 | Events per request. 1 sends each event as a JSON object; >1 batches as JSON array |
flush_interval | 5s | Max time to wait before flushing a partial batch |
skip_verify | false | Skip TLS verification |
workers | 1 | Parallel HTTP POSTs. Raise to 4–8 for slow endpoints |
buffer_size | 1000 | Subscriber 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.