metrics.md

Metrics Reference

Metrics payload is Prometheus text exposition pushed over HTTP POST.

Metrics

• mysqlbinlog_archiver_stream_up{source="..."}

  • 1 when stream status is running, else 0.

• mysqlbinlog_archiver_source_reachable{source="..."}

  • Result of TCP probe from maintain cycle (1 reachable, 0 unreachable).

• mysqlbinlog_archiver_binlog_files{source="..."}

  • Number of regular files in the source binlog directory.

• mysqlbinlog_archiver_binlog_bytes{source="..."}

  • Total bytes across regular files in the source binlog directory.

• mysqlbinlog_archiver_last_error_ts_seconds{source="..."}

  • Last stream error timestamp from source state.

• mysqlbinlog_archiver_last_success_ts_seconds{source="..."}

  • Last successful stream timestamp from source state.

Push behavior

• If --metrics-url is empty, push is disabled.
• Push is attempted only when metrics interval is due.
• Push failures are non-fatal and written to maintain state/report.
• Retries are bounded by --metrics-retries and use short bounded sleeps.

Content type

The push request uses:

• Method: POST
• Header: Content-Type: text/plain; version=0.0.4