Troubleshooting

Diagnosis Steps

1. Validate configuration: radar-agent --validate
2. Enable debug logging: RUST_LOG=debug radar-agent
3. Test connectivity with curl/redis-cli
4. Check error messages for diagnostic hints

Common Issues

Enterprise REST API Connection Failed

Symptoms:

Error: failed to connect to localhost:9443

Solutions:

1. Use actual hostname, not "localhost"

   credentials:
     rest_api:
       url: "https://enterprise.example.com:9443"  # Correct
   

2. Verify port 9443 (REST API), not 8443 (Admin UI)

3. For self-signed certificates:

   credentials:
     rest_api:
       insecure: true  # Skip certificate validation
   

Test connectivity:

curl -k -u admin@redis.local:password https://enterprise.example.com:9443/v1/cluster

Authentication Failed

Symptoms:

Error: Missing access token
Error: gRPC error: Unauthenticated

Solution:

Set API key via environment variable or config:

export ACCESS_KEY=your-api-key

Or in config:

server:
  api_key: your-api-key

Configuration Validation Failed

Symptoms:

Error: missing field `type`

Solution:

Check YAML syntax and required fields:

# Validate configuration
radar-agent --validate

# Test specific deployment
radar-agent validate --deployment redis-prod

Debug Logging

# Info level (default)
RUST_LOG=info radar-agent

# Debug level
RUST_LOG=debug radar-agent

# Trace level (very verbose)
RUST_LOG=trace radar-agent

Testing Connectivity

Enterprise

curl -k https://enterprise.example.com:9443/v1/cluster

Redis Standalone/Cluster

redis-cli -h host -p port ping

Getting Help

Include this information when reporting issues:

1. Agent version: radar-agent --version
2. Validation output: radar-agent --validate
3. Debug logs: RUST_LOG=debug radar-agent 2>&1 | head -100
4. Connection test results