Expand description
Prometheus metric counters and gauges for copy operations and I/O stats. Prometheus metric counters and gauges for copy operations, I/O stats, and storage detection results.
Structs§
- ATOMIC_
WRITE_ FALLBACKS - Atomic write attempts (tmp+rename) that fell back to buffered I/O.
- BUFFER_
POOL_ CAPACITY - Number of buffers currently in the worker’s buffer pool.
- BUFFER_
POOL_ CHUNK_ SIZE - Size of each individual buffer chunk in the pool (bytes).
- BUFFER_
POOL_ TOTAL_ BYTES - Total memory allocated to the buffer pool (bytes).
- BYTES_
REPLICATED - Total bytes successfully written to each replication target.
- Batched
Atomic Counter - Batches increments and decrements to a global
AtomicU64to reduce contention. - Batched
Counter - Batches increments to a Prometheus [
Counter] to reduce atomic contention. - COALESCED_
WRITES - Write events merged into larger chunks by the coalescer.
- COPY_
METHOD_ OFFLOAD - Copies completed via hardware or network offload (copy_file_range/sendfile), per target.
- COPY_
METHOD_ REFLINK - Copies completed via CoW reflink (FICLONE), per target.
- COPY_
METHOD_ SENDFILE_ FALLBACK - Copies that fell back from io_uring to sendfile due to EBADF or timeout.
- COPY_
METHOD_ STANDARD - Copies completed via standard read/write or io_uring, per target.
- DM_
CRYPT_ DETECTED - Set to 1 when dm-crypt (LUKS) is detected in the storage stack.
- DM_
STACK_ DEPTH - Number of device-mapper layers detected beneath the target filesystem.
- GLOBAL_
BUFFER_ COUNT - Atomic counter tracking the total number of allocated buffers globally.
- GLOBAL_
BUFFER_ LIMIT - Maximum configured memory budget for I/O buffers across all workers (bytes).
- GLOBAL_
MEMORY_ USAGE_ BYTES - Current total memory allocated for I/O buffers across all workers (bytes).
- GOVERNOR_
LOAD_ AVERAGE - System load averages (1-minute, 5-minute, 15-minute), labeled by period.
- GOVERNOR_
PACING_ DURATION_ MS - Cumulative time workers spent sleeping due to governor pacing (ms).
- GOVERNOR_
STRESSED - Whether the system is currently under stress (1 = stressed, 0 = normal).
- GOVERNOR_
STRESS_ SCORE - Composite stress score from PSI, memory, and CPU pressure (0.0..1.0 = OK, >1.0 = critical).
- GOVERNOR_
THROTTLED_ EVENTS - Events delayed because the governor detected system pressure.
- HASH_
CACHE_ HITS - Files skipped because their cached signature matched the source.
- HASH_
COMPUTATION_ DURATION - Time spent computing BLAKE3 hashes (seconds).
- HASH_
VERIFICATIONS_ TOTAL - BLAKE3 hash verifications performed (post-copy integrity checks).
- INODE_
LOOKUP_ DURATION - Time spent resolving an inode number to a filesystem path.
- NFS_
BYPASS_ DOUBLE_ ENCRYPTION - Double encryption detected: sec=krb5p (per-RPC AES) + xprtsec=tls.
- NFS_
BYPASS_ KRB5_ FALLBACK - NFS bypass fallbacks due to Kerberos auth (krb5/krb5i/krb5p) on the mount.
- NFS_
BYPASS_ KTLS_ PROMOTED - kTLS kernel offload successfully promoted after TLS handshake.
- NFS_
BYPASS_ TLS_ FALLBACK - NFS bypass TLS upgrade skipped – xprtsec=tls mount but tls feature disabled or STARTTLS rejected.
- RDMA_
RPC_ LATENCY_ US - RDMA per-RPC round-trip latency in microseconds (Send WR post -> CQ completion).
- REGISTRY
- Shared Prometheus registry for all foxing metrics.
- RENAME_
EVENTS - Total rename operations processed across all targets.
- REPLICATION_
LATENCY - End-to-end replication latency from source event to target write, per target.
- SIDECAR_
FILES_ CREATED .foxing_metasidecar files created (fallback for filesystems without xattr support).- STORAGE_
PHYSICAL_ BLOCK_ SIZE - Physical block size of the underlying storage device (bytes).
- VERSIONING_
FAILURES - Failed attempts to create reflink version snapshots before overwrite.
- VERSIONING_
SUCCESS - Successfully created reflink version snapshots.
Functions§
- initialize_
metrics - Set the global buffer memory limit gauge from a megabyte value.