Commit 5541f269 authored Aug 30, 2026 by Ramon Nou

harden distributed readiness and migration observability

parent 1adf54a3

README.md

+10 −0

Original line number	Diff line number	Diff line
		@@ -956,6 +956,16 @@ Environment variable prefixes are scoped by component:
		- `GKFS_USE_DIRENTS_COMPRESSION` - Enable compression for directory entries (default: OFF).
		- `GKFS_HOSTS_FILE` - Legacy daemon-side hostfile path.

		### Daemon metrics (startup-only)
		- `GKFS_DAEMON_ENABLE_STATS` - Enable general daemon statistics collection (default: OFF).
		- `GKFS_DAEMON_ENABLE_CHUNKSTATS` - Enable chunk statistics collection (default: OFF).
		- `GKFS_DAEMON_ENABLE_PROMETHEUS` - Enable Prometheus output when compiled with `GKFS_ENABLE_PROMETHEUS` (default: OFF).
		- `GKFS_DAEMON_PROMETHEUS_GATEWAY` - Prometheus Pushgateway address, `host:port`.
		- `GKFS_DAEMON_MIGRATION_CHECKPOINT` - Enable atomic per-daemon migration checkpoints (default: OFF).

		These variables are read once during daemon startup. They add no statistics
		collection overhead when unset. Existing command-line options remain supported.

		### Client
		#### Core
		- `LIBGKFS_HOSTS_FILE` - Path to the hostsfile (created by the daemon and mandatory for the client).

WIP.md

0 → 100644

+504 −0

File added.

Preview size limit exceeded, changes collapsed.

docs/sphinx/users/running.md

+9 −0

Original line number	Diff line number	Diff line
		@@ -288,6 +288,15 @@ instead or in addition to the output file. It must be enabled at compile time vi
		argument `-DGKFS_ENABLE_PROMETHEUS` and the daemon argument `--enable-prometheus`. The corresponding statistics are then
		pushed to the Prometheus instance.

		Statistics features are startup-only and can also be enabled with daemon
		environment variables: `GKFS_DAEMON_ENABLE_STATS=ON`,
		`GKFS_DAEMON_ENABLE_CHUNKSTATS=ON`, and
		`GKFS_DAEMON_ENABLE_PROMETHEUS=ON`. Set
		`GKFS_DAEMON_PROMETHEUS_GATEWAY=host:port` to override the Pushgateway.
		When these variables are unset, no statistics collection thread is started.
		Set `GKFS_DAEMON_MIGRATION_CHECKPOINT=ON` to enable atomic per-daemon migration
		checkpoint files; this is startup-only and disabled by default.

		### Advanced experimental features

		#### Rename

include/common/env_util.hpp

+3 −0

File changed.

Preview size limit exceeded, changes collapsed.

include/common/malleability_markers.hpp

+1 −0

File changed.

Preview size limit exceeded, changes collapsed.