Skip to content

Commit d60a9ce

Browse files
author
Om Pathak
committed
docs: note WSL filesystem caveat for MultiProcessCollector
Signed-off-by: Om Pathak <ompathak@gmail.com>
1 parent c0e416d commit d60a9ce

1 file changed

Lines changed: 6 additions & 0 deletions

File tree

docs/content/multiprocess/_index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,12 @@ between process/Gunicorn runs (before startup is recommended).
3535
This environment variable should be set from a start-up shell script,
3636
and not directly from Python (otherwise it may not propagate to child processes).
3737

38+
Note: on Windows Subsystem for Linux (WSL), set `PROMETHEUS_MULTIPROC_DIR` to a
39+
Linux-native filesystem path (e.g. `/tmp` or `/home/<user>`) rather than a
40+
Windows-mounted path (e.g. `/mnt/c/...`). On Windows-mounted filesystems the
41+
per-process metric files can be written with an incorrect internal offset,
42+
causing the collector to silently read no data.
43+
3844
**2. Metrics collector**:
3945

4046
The application must initialize a new `CollectorRegistry`, and store the

0 commit comments

Comments
 (0)