Camera Diagnostics & Ingestion Troubleshooting
This guide provides practical troubleshooting steps for resolving common IP camera connectivity, authentication, and video stream degradation issues.
1. Quick Diagnostic Flowchart
2. Diagnosing RTSP Ingest Errors
| Error Symptom | Root Cause | Solution |
|---|---|---|
401 Unauthorized | Incorrect RTSP credentials or special characters | Verify credentials. URL-encode characters like @ (%40), : (%3A), # (%23). |
i/o timeout | Camera offline or port 554 blocked | Ping camera IP and verify port with nc -zv 192.168.1.100 554. |
| Green artifacts / frame tearing | Dropped UDP packets on congested Wi-Fi/WAN | In camera settings, set transport to TCP (transport: "tcp"). |
| Silent audio in web player | Camera using legacy G.726 audio codec | In camera web admin UI, switch audio compression to AAC (48kHz). |
| Timestamp jump / PTS drift | Camera hardware NTP clock desync | Enable NTP time synchronization on the camera matching the RUSEON server time. |
3. Testing with FFprobe
Verify the camera stream independently from the command line:
bash
ffprobe -rtsp_transport tcp -v error -show_streams "rtsp://admin:pass@192.168.1.100:554/stream1"Expected output confirms codec compatibility:
text
codec_name=h264
profile=High
width=1920
height=1080
r_frame_rate=25/1