Диагностика

Симптом	Что проверить
Брокер не стартует	docker compose logs roxa — ошибки конфига, лицензии, бинда портов
Kafka-клиент не подключается извне	kafka_advertised_addr в serve.toml = адрес, видимый клиенту (не 127.0.0.1)
Kafka-клиент получает ошибку аутентификации	SASL/PLAIN включён? логин/пароль из [[auth.users]]? код 58 = неверные учётные данные
Нет сегментов в хранилище	бакет roxa создан? ключи S3 в serve.toml совпадают с MinIO/.env?
Растёт латентность produce	дашборд Grafana: лаг записи в S3 (roxa_segment_put_latency_seconds) — узкое место хранилища/сети
Метрики пустые	curl http://SERVER:9644/metrics | grep roxa_
Веб-консоль не видит брокер	broker в admin.toml; broker_user/password = [[auth.users]]

Логи

docker compose logs -f roxa        # брокер
docker compose logs -f roxa-admin  # веб-консоль

Уровень логирования: поле log в конфиге или переменная окружения RUST_LOG (например, RUST_LOG=debug).

Метрики

Prometheus-эндпоинт брокера: :9644/metrics. Ключевые серии: roxa_produce_latency_seconds, roxa_fetch_latency_seconds, roxa_segment_put_latency_seconds (+ счётчики запросов). В прод-стеке Grafana с дашбордом «Roxa — Overview» провижинится автоматически (:3000).

Не нашли ответ — напишите в поддержку: вопрос попадёт прямо к команде.