Pulse/docs
rcourtman 469d11fc7e docs: add comprehensive scheduler health API documentation
Add detailed API reference and update rollout playbook:

**New: docs/api/SCHEDULER_HEALTH.md**
- Complete endpoint reference for /api/monitoring/scheduler/health
- Request/response structure with field descriptions
- Enhanced "instances" array documentation
- Example responses showing all states (healthy, transient, DLQ)
- Useful jq queries for troubleshooting:
  - Find instances with errors
  - List DLQ entries
  - Show open circuit breakers
  - Sort by failure streaks
- Migration guide (legacy → new fields)
- Troubleshooting examples with real scenarios

**Updated: docs/operations/ADAPTIVE_POLLING_ROLLOUT.md**
- Enhanced "Accessing Scheduler Health API" section (§6)
- Added examples using new instances[] array
- Updated queries to use pollStatus, breaker, deadLetter fields
- Practical jq commands for operators

**Key Documentation Features:**
- Complete JSON schema with examples
- All new fields documented with types and descriptions
- Real-world troubleshooting scenarios
- Copy-paste ready jq queries
- Migration path for existing integrations
- Backward compatibility notes

Operators can now:
- Find error messages without log digging
- Understand circuit breaker states
- Track DLQ entries with full context
- Diagnose issues using single API call

Part of Phase 2 follow-up - enhanced observability
2025-10-20 15:13:38 +00:00
..
api docs: add comprehensive scheduler health API documentation 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: add comprehensive scheduler health API documentation 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
CONTRIBUTING-SCRIPTS.md feat: add shared script library system and refactor docker-agent installer 2025-10-20 15:13:38 +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
installer-v2-quickref.md feat: add shared script library system and refactor docker-agent installer 2025-10-20 15:13:38 +00:00
installer-v2-rollout.md feat: add shared script library system and refactor docker-agent installer 2025-10-20 15:13:38 +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
script-library-guide.md feat: add shared script library system and refactor docker-agent installer 2025-10-20 15:13:38 +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