Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Explain TrueNAS disk heat without hiding health evidence
pulse-triage[bot]7c431a5a36ff
diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.mdindex 1080d48e90..8bf3f31dd3 100644--- a/docs/CONFIGURATION.md+++ b/docs/CONFIGURATION.md@@ -565,6 +565,11 @@ resource override takes precedence. Finish the edit and use **Save Changes**;an unsaved value is not the running policy. Reload after a successful save tocheck that the intended value persisted.+For TrueNAS physical disks, read the [disk temperature and health guide](TRUENAS.md#disk-temperature-and-health)+before changing a rule: heat, SMART faults and missing readings are different+signals, and Storage display thresholds do not yet follow TrueNAS-wide or+per-disk temperature overrides. Silencing an alert is not disk recovery.+### Metric thresholds, Off and inheritanceFor numeric metric rules such as CPU, memory and disk usage:diff --git a/docs/TRUENAS.md b/docs/TRUENAS.mdindex 238a333687..e6c5df7f73 100644--- a/docs/TRUENAS.md+++ b/docs/TRUENAS.md@@ -72,6 +72,41 @@ Pulse has collected; an absent tab is not proof of successful collection.For missing or stale data, use the [polling checks](#stale-truenas-data) beforetesting the connection or restarting.+## Disk temperature and health++In **TrueNAS → Storage**, read the disk's **Health** reason and details, not+only its colour. Heat, native SMART faults and stale or missing readings are+separate evidence. A cool disk can still have a SMART fault; a retained **last+known** temperature is not a current reading, and no temperature is not zero.++Check the saved rule in **Alerts → Thresholds → TrueNAS → TrueNAS Disks**:++- A disk's own temperature override takes precedence over the **TrueNAS Disks**+ default. With neither set, it inherits **Disk temperature by type**.+- The inherited type policy is off when the agent **Disk Temp** default is off;+ an explicit TrueNAS temperature rule can still enable it for TrueNAS disks.+- Thresholds are in **°C**. Finish with **Save Changes**; an unsaved edit is not+ the running rule. See [Off and inheritance](CONFIGURATION.md#metric-thresholds-off-and-inheritance).++**Off is not recovery.** Switching off global or platform alerts silences+alerts, not collection or disk-health evidence. Switching off a disk's+Temperature rule disables that rule, not its native SMART faults. Acknowledging+or dismissing a TrueNAS SMART alert does not repair the disk; its risk remains+while TrueNAS still reports the condition.++**Storage display limitation:** temperature colouring and its heat reason+currently use the inherited agent/by-type policy, not the TrueNAS-wide or+per-disk temperature override. A display mismatch is not proof that your saved+rule failed. Compare the same disk, observation time and saved threshold with+its existing TrueNAS reading and SMART state; do not raise thresholds, run new+SMART tests, force a probe or restart merely to make the views agree.++If reporting a mismatch, include only the disk type, saved threshold, redacted+reason, time and whether the reading is current or last known. Use consistent+aliases instead of hostnames, disk serials or device identifiers; keep the full+diagnostics and configuration private. For missing or stale collection, use+the [polling checks](#stale-truenas-data), not repeated connection tests.+## Multiple TrueNAS SystemsAdd as many TrueNAS connections as needed. Each connection is polled independently. Resources from all connected systems are merged into the unified view.diff --git a/frontend-modern/public/docs/CONFIGURATION.md b/frontend-modern/public/docs/CONFIGURATION.mdindex 1080d48e90..8bf3f31dd3 100644--- a/frontend-modern/public/docs/CONFIGURATION.md+++ b/frontend-modern/public/docs/CONFIGURATION.md@@ -565,6 +565,11 @@ resource override takes precedence. Finish the edit and use **Save Changes**;an unsaved value is not the running policy. Reload after a successful save tocheck that the intended value persisted.+For TrueNAS physical disks, read the [disk temperature and health guide](TRUENAS.md#disk-temperature-and-health)+before changing a rule: heat, SMART faults and missing readings are different+signals, and Storage display thresholds do not yet follow TrueNAS-wide or+per-disk temperature overrides. Silencing an alert is not disk recovery.+### Metric thresholds, Off and inheritanceFor numeric metric rules such as CPU, memory and disk usage:diff --git a/frontend-modern/public/docs/TRUENAS.md b/frontend-modern/public/docs/TRUENAS.mdindex 238a333687..e6c5df7f73 100644--- a/frontend-modern/public/docs/TRUENAS.md+++ b/frontend-modern/public/docs/TRUENAS.md@@ -72,6 +72,41 @@ Pulse has collected; an absent tab is not proof of successful collection.For missing or stale data, use the [polling checks](#stale-truenas-data) beforetesting the connection or restarting.+## Disk temperature and health++In **TrueNAS → Storage**, read the disk's **Health** reason and details, not+only its colour. Heat, native SMART faults and stale or missing readings are+separate evidence. A cool disk can still have a SMART fault; a retained **last+known** temperature is not a current reading, and no temperature is not zero.++Check the saved rule in **Alerts → Thresholds → TrueNAS → TrueNAS Disks**:++- A disk's own temperature override takes precedence over the **TrueNAS Disks**+ default. With neither set, it inherits **Disk temperature by type**.+- The inherited type policy is off when the agent **Disk Temp** default is off;+ an explicit TrueNAS temperature rule can still enable it for TrueNAS disks.+- Thresholds are in **°C**. Finish with **Save Changes**; an unsaved edit is not+ the running rule. See [Off and inheritance](CONFIGURATION.md#metric-thresholds-off-and-inheritance).++**Off is not recovery.** Switching off global or platform alerts silences+alerts, not collection or disk-health evidence. Switching off a disk's+Temperature rule disables that rule, not its native SMART faults. Acknowledging+or dismissing a TrueNAS SMART alert does not repair the disk; its risk remains+while TrueNAS still reports the condition.++**Storage display limitation:** temperature colouring and its heat reason+currently use the inherited agent/by-type policy, not the TrueNAS-wide or+per-disk temperature override. A display mismatch is not proof that your saved+rule failed. Compare the same disk, observation time and saved threshold with+its existing TrueNAS reading and SMART state; do not raise thresholds, run new+SMART tests, force a probe or restart merely to make the views agree.++If reporting a mismatch, include only the disk type, saved threshold, redacted+reason, time and whether the reading is current or last known. Use consistent+aliases instead of hostnames, disk serials or device identifiers; keep the full+diagnostics and configuration private. For missing or stale collection, use+the [polling checks](#stale-truenas-data), not repeated connection tests.+## Multiple TrueNAS SystemsAdd as many TrueNAS connections as needed. Each connection is polled independently. Resources from all connected systems are merged into the unified view.diff --git a/scripts/tests/test_truenas_docs.py b/scripts/tests/test_truenas_docs.pyindex c486695221..7de736534f 100644--- a/scripts/tests/test_truenas_docs.py+++ b/scripts/tests/test_truenas_docs.py@@ -74,6 +74,46 @@ class TrueNASDocsTest(unittest.TestCase):self.assertIn("does not establish a live reading", text)self.assertIn("Do not upload a full browser network capture", text)+ def disk_health_section(self):+ text = DOC.read_text()+ heading = "## Disk temperature and health\n"+ self.assertIn(heading, text, "disk-health interpretation must have a reachable guide")+ return text.split(heading, 1)[1].split("## Multiple TrueNAS Systems", 1)[0]++ def test_disk_health_guidance_separates_reading_rule_and_recovery(self):+ prose = " ".join(self.disk_health_section().split())+ for boundary in (+ "Heat, native SMART faults and stale or missing readings are separate evidence",+ "last known** temperature is not a current reading", "no temperature is not zero",+ "Alerts → Thresholds → TrueNAS → TrueNAS Disks", "own temperature override",+ "takes precedence", "inherits **Disk temperature by type**",+ "agent **Disk Temp** default is off", "explicit TrueNAS temperature rule",+ "Thresholds are in **°C**", "**Save Changes**", "unsaved edit is not the running rule",+ "**Off is not recovery.**", "not collection or disk-health evidence",+ "disables that rule, not its native SMART faults", "does not repair the disk",+ ):+ with self.subTest(boundary=boundary):+ self.assertIn(boundary, prose)+ self.assertNotIn("```", self.disk_health_section(), "no new live diagnostic recipe")++ def test_disk_display_mismatch_has_a_passive_private_reporting_route(self):+ prose = " ".join(self.disk_health_section().split())+ for boundary in (+ "**Storage display limitation:**", "inherited agent/by-type policy",+ "not the TrueNAS-wide or per-disk temperature override",+ "not proof that your saved rule failed", "same disk, observation time and saved threshold",+ "existing TrueNAS reading and SMART state", "do not raise thresholds",+ "run new SMART tests", "force a probe or restart", "only the disk type",+ "redacted reason, time", "current or last known", "consistent aliases",+ "keep the full diagnostics and configuration private", "not repeated connection tests",+ ):+ with self.subTest(boundary=boundary):+ self.assertIn(boundary, prose)+ config = ROOT / "docs/CONFIGURATION.md"+ self.assertIn("TRUENAS.md#disk-temperature-and-health", config.read_text())+ self.assertEqual(config.read_bytes(),+ (ROOT / "frontend-modern/public/docs/CONFIGURATION.md").read_bytes())+def log_section(self):return DOC.read_text().split("### No data appearing after adding connection\n", 1)[1].split("### Inventory works but CPU, memory or History is missing", 1)[0]