Pulse/docs
rcourtman ce5ad64810 docs: defer circuit breaker/DLQ management endpoints (Phase 2 Task 11)
Document decision to defer mutation endpoints after soak testing:

**Assessment Results:**
- Integration tests (55s, 12 instances): Automatic recovery worked perfectly
- Soak tests (2-240min, 80 instances): No manual intervention needed
- Circuit breakers: Opened/closed automatically as designed
- DLQ routing: Permanent failures handled correctly

**Current Capabilities (Sufficient):**
- Read-only scheduler health API provides full visibility
- Operator workarounds: service restart, feature flag toggle
- Grafana alerting: queue depth, staleness, DLQ, breakers

**Why Defer:**
- No operational need demonstrated in testing
- Implementation requires auth/RBAC/audit/UI work
- Cost not justified until production usage reveals need
- Can add later when data shows actual pain points

**Future Design Notes:**
- POST /api/monitoring/breakers/{instance}/reset
- POST /api/monitoring/dlq/retry (all or specific)
- DELETE /api/monitoring/dlq/{instance}
- Auth, audit, rate limiting, UI integration required

**Re-evaluation Criteria:**
- Operators request controls >3x in 30 days
- Troubleshooting steps inadequate
- Service restarts too disruptive
- Production incidents need surgical controls

Decision: Monitor production usage for 60 days, then reassess based on actual operator feedback and support ticket patterns.

Part of Phase 2 - Adaptive Polling completion
2025-10-20 15:13:38 +00:00
..
development feat: streamline docker agent onboarding 2025-10-14 09:45:32 +00:00
images Fix settings security tab navigation 2025-10-11 23:29:47 +00:00
monitoring feat: add scheduler health API endpoint (Phase 2 Task 8) 2025-10-20 15:13:38 +00:00
operations docs: defer circuit breaker/DLQ management endpoints (Phase 2 Task 11) 2025-10-20 15:13:38 +00:00
security security: complete Phase 1 sensor proxy hardening 2025-10-20 15:13:37 +00:00
API.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00
CONFIGURATION.md Add configurable backup polling interval 2025-10-18 13:06:41 +00:00
DOCKER.md Adopt multi-token auth across docs, UI, and tooling 2025-10-14 15:47:49 +00:00
DOCKER_HUB_README.md Adopt multi-token auth across docs, UI, and tooling 2025-10-14 15:47:49 +00:00
DOCKER_MONITORING.md feat: enhance alerts system with tests and improved thresholds 2025-10-15 22:25:04 +00:00
FAQ.md Adopt multi-token auth across docs, UI, and tooling 2025-10-14 15:47:49 +00:00
frontend-style-guide.md Fix settings security tab navigation 2025-10-11 23:29:47 +00:00
INSTALL.md Add Helm chart tooling, CI, and release packaging 2025-10-18 11:50:57 +00:00
KUBERNETES.md Add Helm chart tooling, CI, and release packaging 2025-10-18 11:50:57 +00:00
MIGRATION.md Fix settings security tab navigation 2025-10-11 23:29:47 +00:00
OIDC.md Fix settings security tab navigation 2025-10-11 23:29:47 +00:00
PORT_CONFIGURATION.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00
PROXY_AUTH.md Adopt multi-token auth across docs, UI, and tooling 2025-10-14 15:47:49 +00:00
PULSE_SENSOR_PROXY_HARDENING.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00
RELEASE.md Add Helm chart tooling, CI, and release packaging 2025-10-18 11:50:57 +00:00
REVERSE_PROXY.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00
SCREENSHOTS.md Fix settings security tab navigation 2025-10-11 23:29:47 +00:00
SECURITY.md feat: implement priority queue-based task execution (Phase 2 Task 6) 2025-10-20 15:13:37 +00:00
TEMPERATURE_MONITORING.md fix: gracefully handle standalone node cleanup limitation 2025-10-18 07:34:18 +00:00
TEMPERATURE_MONITORING_SECURITY.md test: add comprehensive security tests and documentation 2025-10-19 16:47:13 +00:00
TROUBLESHOOTING.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00
VM_DISK_MONITORING.md Ignore read-only guest filesystems in disk aggregation 2025-10-14 16:13:53 +00:00
WEBHOOKS.md feat: add docker agent command handling 2025-10-15 19:27:19 +00:00
zfs-monitoring.md Add guest agent caching and update doc hints (refs #560) 2025-10-16 08:15:49 +00:00