capture-health-check

End-to-end health checks validate API endpoints, device availability, and spectrum status to detect stuck captures, missing audio, or non-updating data. Run ./check_health.sh or curl the /health endpoint to receive a diagnostic report identifying the failure point and guidance for remediation.

Health checks validate /health, /devices, /captures, /captures/{id}/channels, and /captures/{id}/spectrum/snapshot endpoints. This comprehensive validation confirms API responsiveness, device connectivity, active captures, channel configuration, and spectrum readiness across the entire system.

Yes. Use the --fix workflow option to automatically restart services and restart stuck captures. This remediation step follows diagnosis and helps restore system health without manual intervention.

Run health checks when captures remain in 'starting' state, the spectrum analyzer shows no progress, audio fails to play, or you suspect misconfiguration. Health checks guide diagnosis and validate overall system state before troubleshooting deeper issues.

Health checks require curl for API requests and python3 for scripting. These tools enable the diagnostic script to query endpoints, parse responses, and generate health reports.