From 41589effc1a62866dc0f19e8fdd34f3a4606e3a5 Mon Sep 17 00:00:00 2001 From: Meliox Date: Sun, 23 Aug 2026 15:59:17 +0200 Subject: [PATCH] readme updates --- src/modules/node_info/readme.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/src/modules/node_info/readme.md b/src/modules/node_info/readme.md index c102355..0e4183a 100644 --- a/src/modules/node_info/readme.md +++ b/src/modules/node_info/readme.md @@ -67,3 +67,27 @@ Each feature requires the corresponding tool to be installed on the Proxmox host ## Debug Mode Each collector supports a debug mode that reads from a local file instead of executing the real tool. Useful for development and testing without physical hardware. + +### Per-collector debug files + +Set the collector's `_mode` flag to `1` in the `[debug]` section of `/etc/pve-mod/conf.d/node_info.conf` and populate its file(s) with sample data, captured from a real host via the commands below: + +| Collector | Enable flag | File | Content | Example to generate it | +|-----------|-------------|------|---------|-------------------------| +| Temperature sensors | `lm_sensors_mode` | `lm_sensors_output_file` | Raw `sensors -j` JSON output | `sensors -j > /tmp/sensors-output.json` | +| Intel GPU | `intel_mode` | `intel_devices_file` | Device list, one line per GPU (`intel_gpu_top -L` format) | `intel_gpu_top -L > /tmp/intel-gpu-devices.json` | +| | | `intel_output_file` | Continuous `intel_gpu_top` stats output | `intel_gpu_top -d /dev/dri/card0 -s 1000 -l > /tmp/intel-gpu-output.txt` | +| NVIDIA GPU | `nvidia_mode` | `nvidia_devices_file` | Device list CSV | `nvidia-smi --query-gpu=index,name --format=csv > /tmp/nvidia-smi-devices.csv` | +| | | `nvidia_output_file` | Stats CSV | `nvidia-smi --query-gpu=index,name,temperature.gpu,utilization.gpu,utilization.memory,memory.used,memory.total,power.draw,power.limit,fan.speed --format=csv,nounits > /tmp/nvidia-smi-output.csv` | +| AMD GPU | `amd_mode` | `amd_devices_file` | Placeholder — collector not yet implemented | — | +| UPS | `ups_mode` | `ups_output_file` | Raw `upsc` key: value output (despite the `.json` name, it's plain text, not JSON) | `upsc ups@192.168.1.50 > /tmp/ups-output.json` | + +### Verbose module logging (mod_debug) + +Set `mod_debug=1` in the `[debug]` section of `/etc/pve-mod/conf.d/node_info.conf`, then restart `pveproxy` (`systemctl restart pveproxy`) — the setting is only read at startup. With it enabled, the mod logs each internal step (collector start/stop, cache hits, file reads, etc.) to the journal, viewable with: + +```sh +journalctl -u pveproxy -f +``` + +Set `log_enabled=1` (and optionally `log_file`) in the same section to also persist this output to a file.