Agent Issues
Agent Not Connecting
Symptoms: Agent shows as offline in dashboard
Solutions:
- Verify network connectivity to api.sent1nels.com:443
- Check firewall rules allow outbound HTTPS
- Verify API key is valid and not expired
- Check agent logs:
/var/log/sent1nels/agent.log - Restart agent service:
systemctl restart sent1nels-agent
High CPU Usage
Symptoms: Agent consuming excessive CPU resources
Solutions:
- Increase scan interval in agent configuration
- Reduce number of monitored paths
- Enable log sampling for high-volume sources
- Update to latest agent version
- Check for conflicting security software
Detection Issues
False Positives
Symptoms: Legitimate activity triggering alerts
Solutions:
- Review and tune detection rule thresholds
- Add exceptions for known-good patterns
- Use whitelists for trusted IPs/users
- Enable learning mode to baseline normal behavior
- Adjust severity levels appropriately
Missing Detections
Symptoms: Known threats not being detected
Solutions:
- Verify agent is monitoring correct data sources
- Check detection rules are enabled
- Update threat intelligence feeds
- Review agent logs for errors
- Ensure sufficient agent permissions
API Issues
Authentication Errors
Error: 401 Unauthorized
Solutions:
- Verify API key is included in Authorization header
- Check API key hasn't expired
- Ensure correct format:
Bearer YOUR_API_KEY - Regenerate API key if compromised
Rate Limiting
Error: 429 Too Many Requests
Solutions:
- Implement exponential backoff
- Reduce request frequency
- Use batch endpoints where available
- Cache responses when appropriate
- Contact support for rate limit increase
Performance Issues
Slow Dashboard Loading
Solutions:
- Clear browser cache and cookies
- Reduce date range for queries
- Use filters to limit result sets
- Archive old incidents
- Check network latency
Database Connection Errors
Solutions:
- Verify database credentials
- Check database server is running
- Ensure connection pool isn't exhausted
- Review database logs for errors
- Restart database service if needed