Skip to content

Module kumo.jsonl

Since: Dev Builds Only

The functionality described in this section requires a dev build of KumoMTA. You can obtain a dev build by following the instructions in the Installation section.

This module provides utilities for reading and writing JSONL (newline-delimited JSON) log files stored in zstd-compressed segments, as produced by kumomta's logging subsystem.

It supports:

  • Writingkumo.jsonl.new_writer produces a LogWriter that compresses records into time-based segment files.

  • Reading (single consumer)kumo.jsonl.new_tailer returns a streaming tailer for a single consumer with optional filtering, checkpointing, and configurable batching.

  • Reading (multiple consumers)kumo.jsonl.new_multi_tailer fans a single read pass out to multiple independent consumers, each with its own filter, batch parameters, and checkpoint.

Available Functions