Skip to main content

Troubleshooting Guide

This guide helps you resolve common issues with Keymate.

Common Issues​

API Authentication​

Invalid API Key​

Symptoms:

  • 401 Unauthorized errors
  • Authentication failures

Solutions:

  1. Verify API key format
  2. Check key permissions
  3. Ensure key is active
  4. Try regenerating key

Rate Limiting​

Symptoms:

  • 429 Too Many Requests errors
  • Request throttling

Solutions:

  1. Implement backoff strategy
  2. Reduce request frequency
  3. Use bulk operations
  4. Contact support for limits

Scanning Issues​

Failed Scans​

Symptoms:

  • Scan timeout
  • Incomplete results
  • Error messages

Solutions:

  1. Check repository access
  2. Verify scan configuration
  3. Review error logs
  4. Try smaller scan scope

False Positives​

Symptoms:

  • Incorrect vulnerability reports
  • Misidentified issues

Solutions:

  1. Review scan rules
  2. Update rule sets
  3. Configure exclusions
  4. Report issues to support

Monitoring Problems​

Alert Issues​

Symptoms:

  • Missing alerts
  • False alerts
  • Alert delays

Solutions:

  1. Check alert configuration
  2. Verify notification settings
  3. Review alert rules
  4. Test alert system

Performance Issues​

Symptoms:

  • Slow response times
  • High resource usage
  • Timeout errors

Solutions:

  1. Check network connectivity
  2. Monitor resource usage
  3. Optimize queries
  4. Scale resources

Debugging Tools​

Logging​

# Enable debug logging
export KEYMATE_LOG_LEVEL=debug

# View logs
keymate logs

Diagnostic Tools​

# Run diagnostics
keymate diagnose

# Check system status
keymate status

Network Testing​

# Test API connectivity
keymate ping

# Check network latency
keymate latency

Support​

Getting Help​

  1. Check documentation
  2. Search knowledge base
  3. Contact support
  4. Join community

Reporting Issues​

  1. Gather information
  2. Document steps
  3. Include logs
  4. Submit ticket

Next Steps​