KafkaIQ

10.10.3 – Troubleshooting REST Proxy

Module: Section 10 – Kafka Ecosystem & Tools
Section: 10.10 – REST Proxy Operations & Ecosystem Tools
Goal: Diagnose and resolve REST Proxy issues

Common Issues

1. Connection Refused

Symptom: Connection refused to localhost:8082

Solution: Verify REST Proxy is running

curl http://localhost:8082/

2. Kafka Connection Error

Symptom: Error connecting to Kafka

Solution: Check bootstrap.servers configuration

bootstrap.servers=kafka:9092  # ✅ Correct
bootstrap.servers=localhost:9092  # ❌ Wrong if in Docker

3. Schema Registry Error

Symptom: Schema not found

Solution: Verify Schema Registry URL

schema.registry.url=http://localhost:8081

4. Consumer Timeout

Symptom: Consumer instance has expired

Solution: Increase timeout

consumer.instance.timeout.ms=300000  # 5 minutes

Debug Logging

log4j.logger.io.confluent.kafkarest=DEBUG

Key Takeaways

  1. Connection: Verify REST Proxy is running
  2. Kafka: Check bootstrap.servers config
  3. Schema Registry: Verify URL configuration
  4. Timeouts: Increase consumer instance timeout

What's Next?

Next Module: 10.10.4 – Kafka UI & Monitoring Tools