Skip to main content
Version: v4.22

bitz

Reads and writes BITZ, Tenzir's internal wire format.

Synopsis

bitz

Description

The bitz format provides a parser and printer for Tenzir's internal wire format. It enables lossless transfer of events between Tenzir nodes through any connector.

Use BITZ when you need high-throughput structured data exchange with minimal overhead. BITZ is a thin wrapper around Arrow's record batches. That is, BITZ lays out data in a (compressed) columnar fashion that makes it conducive for analytical workloads. Since it's padded and byte-aligned, it is portable and doesn't induce any deserialization cost, making it suitable for write-once-read-many use cases.

Internally, BITZ uses Arrow's IPC format for serialization and deserialization, but prefixes each message with a 64 bit size prefix to support changing schemas between batches—something that Arrow's IPC format does not support on its own.

Did you know?

BITZ is short for binary Tenzir, and a play on the word bits.

Examples

Transfer events between two pipelines using zmq.

Send BITZ over ZeroMQ
export
| to zmq://localhost:5670 write bitz
Receive BITZ from ZeroMQ
from zmq://localhost:5670 read bitz
| import