Files
Wez Furlong 004b2aabd5 logging: expose log consumer backlog as metrics
Publish metrics showing how far each out-of-process log consumer trails
the newest data in the directories this node logs to, so that operators
can tell whether a consumer is keeping up. Covers both the
configure_local_logs and kumo.jsonl.new_writer directories.
2026-10-05 13:22:27 +01:00

933 B

log_consumer_bytes_behind

Type: Gauge
Labels: log_dir, checkpoint_name

The compressed size, in bytes, of whole log segments awaiting processing by a consumer.

!!! info This metric has labels, which means that the system will track the metric for each combination of the possible labels that are active. Certain labels, especially those that correlate with source or destination addresses or domains, can have high cardinality. High cardinality metrics may require some care and attention when provisioning a downstream metrics server.

This counts whole unread segments only, not the remainder of the segment that the consumer is partway through processing.

Labelled by:

  • log_dir - the log directory being scanned
  • checkpoint_name - the name set by the tailer of the consumer for its checkpoint.