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 collapsed phone History charts before missing-data diagnosis

pulse-triage[bot]5cd659b325fe
diff --git a/docs/METRICS_HISTORY.md b/docs/METRICS_HISTORY.md
index c64478b480..9ec2141047 100644
--- a/docs/METRICS_HISTORY.md
+++ b/docs/METRICS_HISTORY.md
@@ -11,6 +11,21 @@ tab. If your installed version still has a **History** tab, use that tab; do not
upgrade or restart just to follow this guide. A resource without a supported
history target may have no chart.
+**On a phone**, drawers can show only **Utilization** and panels with active
+alerts. Use the **Show …** button below the charts to reveal the others, for
+example **Show Network I/O, Disk I/O, Thermals**. Its labels name the currently
+collapsed panels, so they vary by resource and alert. **Show fewer charts**
+collapses them again. Wider layouts show all panels and may have no button;
+older installed layouts may differ.
+
+This button changes only the layout, preserving **History range**; it does not
+refresh history or collect new measurements. A collapsed panel is not missing
+data or measured zero. After revealing it, **No stored history in this range**
+means that panel has no plotted stored samples for the selected range, not zero
+usage or proof that collection stopped. Loading, an access error, a locked range
+and **History unavailable** are different states: retain the existing message
+and range. Do not refresh, run Diagnostics or restart just to reveal a chart.
+
These charts are separate from **Alerts → History**, table sparklines and
current summary cards. A current card or a short trend preview does not
establish the observations in the selected stored range. For a PBS host, use
diff --git a/docs/PBS.md b/docs/PBS.md
index 0539fc2e2e..ce6841246f 100644
--- a/docs/PBS.md
+++ b/docs/PBS.md
@@ -441,7 +441,12 @@ same series. Current CPU and memory values, a green connection badge, and an
Use the chart's selected stored range, not a current summary card or table
sparkline. For observation times, missing samples and aggregated low–high bands,
-see [reading a History panel](METRICS_HISTORY.md#read-a-history-panel).
+see [reading a History panel](METRICS_HISTORY.md#read-a-history-panel). On a
+phone, secondary panels may be collapsed behind **Show …** below the charts;
+reveal them before treating a panel as missing. This changes the layout, not
+the selected range or collection. CPU and memory are in **Utilization**, which
+is already visible when the charts are shown; the button is not a fix for an
+empty CPU or memory chart.
Start with one affected PBS and a recent, unlocked time range:
diff --git a/frontend-modern/public/docs/METRICS_HISTORY.md b/frontend-modern/public/docs/METRICS_HISTORY.md
index c64478b480..9ec2141047 100644
--- a/frontend-modern/public/docs/METRICS_HISTORY.md
+++ b/frontend-modern/public/docs/METRICS_HISTORY.md
@@ -11,6 +11,21 @@ tab. If your installed version still has a **History** tab, use that tab; do not
upgrade or restart just to follow this guide. A resource without a supported
history target may have no chart.
+**On a phone**, drawers can show only **Utilization** and panels with active
+alerts. Use the **Show …** button below the charts to reveal the others, for
+example **Show Network I/O, Disk I/O, Thermals**. Its labels name the currently
+collapsed panels, so they vary by resource and alert. **Show fewer charts**
+collapses them again. Wider layouts show all panels and may have no button;
+older installed layouts may differ.
+
+This button changes only the layout, preserving **History range**; it does not
+refresh history or collect new measurements. A collapsed panel is not missing
+data or measured zero. After revealing it, **No stored history in this range**
+means that panel has no plotted stored samples for the selected range, not zero
+usage or proof that collection stopped. Loading, an access error, a locked range
+and **History unavailable** are different states: retain the existing message
+and range. Do not refresh, run Diagnostics or restart just to reveal a chart.
+
These charts are separate from **Alerts → History**, table sparklines and
current summary cards. A current card or a short trend preview does not
establish the observations in the selected stored range. For a PBS host, use
diff --git a/frontend-modern/public/docs/PBS.md b/frontend-modern/public/docs/PBS.md
index 0539fc2e2e..ce6841246f 100644
--- a/frontend-modern/public/docs/PBS.md
+++ b/frontend-modern/public/docs/PBS.md
@@ -441,7 +441,12 @@ same series. Current CPU and memory values, a green connection badge, and an
Use the chart's selected stored range, not a current summary card or table
sparkline. For observation times, missing samples and aggregated low–high bands,
-see [reading a History panel](METRICS_HISTORY.md#read-a-history-panel).
+see [reading a History panel](METRICS_HISTORY.md#read-a-history-panel). On a
+phone, secondary panels may be collapsed behind **Show …** below the charts;
+reveal them before treating a panel as missing. This changes the layout, not
+the selected range or collection. CPU and memory are in **Utilization**, which
+is already visible when the charts are shown; the button is not a fix for an
+empty CPU or memory chart.
Start with one affected PBS and a recent, unlocked time range:
diff --git a/frontend-modern/src/features/docs/__tests__/drawerHistoryGuide.test.ts b/frontend-modern/src/features/docs/__tests__/drawerHistoryGuide.test.ts
index 019a029df4..4c49904267 100644
--- a/frontend-modern/src/features/docs/__tests__/drawerHistoryGuide.test.ts
+++ b/frontend-modern/src/features/docs/__tests__/drawerHistoryGuide.test.ts
@@ -66,6 +66,31 @@ describe('stored-chart navigation and interpretation help', () => {
expect(panel).toContain('average, ${low} to ${high}');
});
+ it('makes collapsed phone charts discoverable without another collection request', () => {
+ const text = prose(history());
+ expect(text).toContain('On a phone');
+ expect(text).toContain('Utilization and panels with active alerts');
+ expect(text).toContain('Show Network I/O, Disk I/O, Thermals');
+ expect(text).toContain('Show fewer charts collapses them again');
+ expect(text).toContain('labels name the currently collapsed panels');
+ expect(text).toContain('Wider layouts show all panels and may have no button');
+ expect(text).toContain('preserving History range');
+ expect(text).toContain('does not refresh history or collect new measurements');
+ expect(text).toContain('Do not refresh, run Diagnostics or restart just to reveal a chart');
+ });
+
+ it('does not mistake collapsed layout or an empty panel for measured zero', () => {
+ const text = prose(history());
+ expect(text).toContain('A collapsed panel is not missing data or measured zero');
+ expect(text).toContain('No stored history in this range');
+ expect(text).toContain('no plotted stored samples for the selected range');
+ expect(text).toContain('not zero usage or proof that collection stopped');
+ expect(text).toContain('Loading, an access error, a locked range and History unavailable');
+ expect(prose(pbs())).toContain('secondary panels may be collapsed behind Show …');
+ expect(prose(pbs())).toContain('CPU and memory are in Utilization');
+ expect(prose(pbs())).toContain('button is not a fix for an empty CPU or memory chart');
+ });
+
it('explains stored buckets and peaks without inventing coverage or an incident time', () => {
const text = prose(history());
expect(text).toContain('22% average, 10% to 95%');