Часто встречающиеся проблемы и пути их устранения#

Пользователь не может войти в систему#

Симптомы:
Ошибка при входе: Authentication failed, Invalid credentials, User not found или перенаправление на страницу входа без ошибки.

Возможные причины:

  • Проблемы с подключением к IAM Proxy или KeyCloak.SE.

  • Устаревший или отозванный токен.

  • Пользователь не активен или заблокирован.

  • Некорректные настройки аутентификации в sbt_inventory.yaml.

Решение:

  1. Проверить доступность IAM Proxy:

    bash curl -k https://iam-proxy-host:port/health

  2. Убедиться, что в sbt_inventory.yaml включена аутентификация:

    [auth.osa] enabled = true

  3. Проверить логи GRAF:

    bash journalctl -u grafana-server --since "5 minutes ago" | grep -i auth

  4. Убедиться, что пользователь существует и активен в KeyCloak.SE.

Панели не отображают данные#

Симптомы:
Графики пустые, таблицы показывают «No data».

Возможные причины:

  • Недоступен источник данных (Prometheus, Loki, Tempo).

  • Ошибки в запросах (некорректные метрики, лейблы).

  • Отсутствует доступ к данным из-за политик ABAC.

  • Неправильно указан временной диапазон.

Решение:

  1. Перейти в Connections → Data Sources и проверить статус подключения.

  2. Нажать Save & Test для каждого источника.

  3. Открыть вкладку Explore и проверить наличие метрик по имени.

  4. Убедиться, что пользователь имеет права на доступ к данным (проверить роли и политики).

  5. Проверить, что временной диапазон на панели соответствует периоду доступности данных.

GRAF не запускается или падает при старте#

Симптомы:
Сервис не стартует, в логах — ошибки инициализации.

Возможные причины:

  • Ошибки в sbt_inventory.yaml или sbt_inventory.yml.

  • Недостаточно прав на файлы.

  • Проблемы с подключением к БД (PostgreSQL).

  • Порт 3000 занят.

Решение:

  1. Проверить синтаксис конфигурационных файлов.

  2. Убедиться, что пользователь grafanase имеет права на /opt/grafana/.

  3. Проверить, не занят ли порт:

    bash netstat -tulnp | grep 3000

  4. Проверить подключение к БД:

    bash psql -h  -U  -d  -c "SELECT 1"

  5. Запустить вручную с выводом логов:

    bash sudo -u grafanase grafana-server --config=/opt/grafana/config/grafana.ini

Сертификаты не загружаются из SecMan#

Симптомы:
Ошибки TLS, «Failed to unwrap token», «Permission denied».

Возможные причины:

  • Некорректный role_id или secret_id.

  • Пути к секретам не существуют в SecMan.

  • Проблемы с сетевым доступом к SecMan.

  • Истек срок действия wrapped-токена.

Решение:

  1. Проверить доступность SecMan.

  2. Убедиться, что role_id и secret_id актуальны.

  3. Проверить, что пути в __$secman{...} существуют.

  4. Проверить логи GRAF.

Высокое потребление памяти или CPU#

Симптомы:
GRAF потребляет >80% CPU или памяти, работает медленно.

Возможные причины:

  • Большое количество активных панелей или алертов.

  • Частые запросы с мелким интервалом.

  • Утечка памяти в плагине.

Решение:

  1. Оптимизировать запросы — увеличить min interval.

  2. Включить кэширование на стороне Prometheus.

  3. Ограничить количество одновременных запросов:

    ini [analytics] report_usage = false

  4. Проверить, не вызвана ли нагрузка конкретной панелью — отключить подозрительные.

  5. Обновить GRAF до актуальной версии.