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.

Bind the extended webhook example to supporting software

pulse-triage[bot]f6e8a3c9f445
diff --git a/docs/WEBHOOKS.md b/docs/WEBHOOKS.md
index cd038af44d..e2bef27473 100644
--- a/docs/WEBHOOKS.md
+++ b/docs/WEBHOOKS.md
@@ -372,6 +372,14 @@ member-aware template below; do not use the short example as an exactly-once key
### Sample PSA payloads
+Use this extended template only with a Pulse version that exposes
+`NotRecovered` and member `Resolution`; **v6.5.0 does not have these fields**.
+Consult the help bundled with your installed version before replacing a
+working template. If rendering reports a missing field, leave failed deliveries
+retained rather than retrying the batch or removing the reason fields and
+treating every close as recovery. A newer guide on the website does not establish
+that its supporting software has been released.
+
A fuller template for normal queued firing and recovery notifications includes
tenant context and every member's occurrence, severity, condition and close reason. The
primary fields remain convenient summary context, **not the whole batch**:
diff --git a/frontend-modern/public/docs/WEBHOOKS.md b/frontend-modern/public/docs/WEBHOOKS.md
index cd038af44d..e2bef27473 100644
--- a/frontend-modern/public/docs/WEBHOOKS.md
+++ b/frontend-modern/public/docs/WEBHOOKS.md
@@ -372,6 +372,14 @@ member-aware template below; do not use the short example as an exactly-once key
### Sample PSA payloads
+Use this extended template only with a Pulse version that exposes
+`NotRecovered` and member `Resolution`; **v6.5.0 does not have these fields**.
+Consult the help bundled with your installed version before replacing a
+working template. If rendering reports a missing field, leave failed deliveries
+retained rather than retrying the batch or removing the reason fields and
+treating every close as recovery. A newer guide on the website does not establish
+that its supporting software has been released.
+
A fuller template for normal queued firing and recovery notifications includes
tenant context and every member's occurrence, severity, condition and close reason. The
primary fields remain convenient summary context, **not the whole batch**:
diff --git a/frontend-modern/src/utils/__tests__/webhookCloseHelp.test.ts b/frontend-modern/src/utils/__tests__/webhookCloseHelp.test.ts
index 4c1abb2210..aa0058da19 100644
--- a/frontend-modern/src/utils/__tests__/webhookCloseHelp.test.ts
+++ b/frontend-modern/src/utils/__tests__/webhookCloseHelp.test.ts
@@ -28,6 +28,17 @@ const closeText = (): string => {
};
describe('webhook non-recovery close help', () => {
+ it('keeps unsupported stable versions and failed renders out of blind batch retries', () => {
+ const text = article().textContent!.replace(/\s+/g, ' ');
+ expect(text).toContain('v6.5.0 does not have these fields');
+ expect(text).toContain('Consult the help bundled with your installed version');
+ expect(text).toContain('leave failed deliveries retained rather than retrying the batch');
+ expect(text).toContain('removing the reason fields and treating every close as recovery');
+ expect(text).toContain(
+ 'A newer guide on the website does not establish that its supporting software has been released',
+ );
+ });
+
it('ships the exact tested guidance and member-aware copied template', () => {
expect(readFileSync(path.join(root, 'frontend-modern/public/docs/WEBHOOKS.md'), 'utf8')).toBe(
guide(),