Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

Explain TrueNAS disk heat without hiding health evidence

pulse-triage[bot]7c431a5a36ff
diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md
index 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 to
check 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 inheritance
For numeric metric rules such as CPU, memory and disk usage:
diff --git a/docs/TRUENAS.md b/docs/TRUENAS.md
index 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) before
testing 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 Systems
Add 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.md
index 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 to
check 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 inheritance
For 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.md
index 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) before
testing 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 Systems
Add 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.py
index 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]