Troubleshooting

Diagnosis Steps

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

Common Issues

Redis Software REST API Connection Failed

Symptoms:

Error: failed to connect to localhost:9443

Solutions:

1. Use actual hostname, not “localhost”

   rest_api:
     host: "enterprise.example.com"
     port: 9443
     use_tls: true
   

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

3. For self-signed certificates:

   rest_api:
     host: "enterprise.example.com"
     port: 9443
     use_tls: true
     insecure: true  # Skip certificate validation (default: true)
   

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-collector --validate

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

gRPC Transport Error on Submission

Symptoms:

Error: transport error
Error: error trying to connect: ...

The collector connects to Redis and collects data successfully, but fails when submitting to the Radar server via gRPC.

Cause: The Radar gRPC endpoint uses TLS. If your environment uses a corporate proxy or private CA, the collector’s TLS library cannot verify the server certificate.

Solutions:

1. Kubernetes: Mount the corporate CA certificate into the container. See Kubernetes Deployment - TLS and Corporate CA Certificates.

2. Linux/systemd: Add the CA to the system trust store or set the SSL_CERT_FILE environment variable:

   export SSL_CERT_FILE=/path/to/corporate-ca-bundle.crt
   

3. Docker: Mount the CA certificate:

   docker run -v /path/to/ca-bundle.crt:/etc/ssl/certs/ca-certificates.crt:ro \
     ghcr.io/redis-field-engineering/radar-collector:alpine-latest \
     --config /etc/radar/radar-collector.yml
   

Debug Logging

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

# Debug level
RUST_LOG=debug radar-collector

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

Testing Connectivity

Redis Software

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. Collector version: radar-collector --version
2. Validation output: radar-collector --validate
3. Debug logs: RUST_LOG=debug radar-collector 2>&1 | head -100
4. Connection test results