HerdRanger 0.20.18 pre-release guide
06 · Monitoring and notifications
Choose timeliness, battery use, and visibility.
Choose optional live monitoring or periodic checks for agent attention. Delivery depends on Android, network access, and host availability.
Open the user guide
Periodic and live monitoring
Android schedules periodic checks and can delay them. Optional foreground live monitoring listens for agent changes on eligible saved Herdr servers and shows an ongoing monitoring notification. While active, it reconciles the server and session topology every five minutes. Individual event and alert delivery can vary.
Android and device-specific battery or foreground-service restrictions can limit live monitoring. Periodic checks can continue when Android stops the foreground service.
Enable or pause monitoring
Open Menu → Settings → Agent notifications. Enable the alerts you want and grant Android’s notification permission when asked. Use Pause monitoring in the ongoing notification to stop live monitoring while keeping periodic alerts and open terminal views available.
Tap the ongoing notification to return to settings. Turning off agent alerts closes the monitoring connections.
Open and clear an alert
Tap an agent alert to open its target and dismiss that alert. Viewing the exact chat can also clear its existing alert. The app’s waiting state and monitoring count update after an authenticated check confirms the agent’s state.
Notification privacy
Agent alerts can show the configured server, project and agent labels and a short request classification. They omit full agent output, terminal output and credentials. Use Android’s lock-screen notification settings to control what others can see.
When alerts are late or missing
Check notification permission, network reachability, the chosen Herdr mode, Android’s background policy and the monitoring settings. Open the agent or verify its state on the host when timing matters.