Use-case recommendation

Best Format for Analytics Event Ingestion

JSONL is a strong default for append-only event ingestion streams.

Recommendation

Define the default first.

JSONL

Line-delimited JSON is easy to append, partition, and process incrementally.

application/octet-stream

NDJSON

Use NDJSON for strict newline-delimited ingestion contracts.

Files: 9

JSON

Use JSON for batched payloads rather than streaming records.

Files: 22

Related decisions

Keep adjacent decisions one step away.

FAQ

Resolve the likely objections early.

What is the default format recommendation for this use case?

JSONL is the recommended default format here.

How should teams validate this recommendation?

Use sample files and manifest endpoints to test compatibility and behavior before rollout.