grafana.ini
Тема дорожной карты · Grafana
grafana.ini — основной конфигурационный файл self-hosted экземпляра Grafana, расположенный по умолчанию по пути /etc/grafana/grafana.ini в Linux или по пути, указанному в переменной окружения GF_PATHS_CONFIG. Файл организован в INI-секции — [server], [database], [security], [auth], [smtp] и другие — каждая из которых управляет отдельной подсистемой Grafana. Любую настройку в grafana.ini можно переопределить во время выполнения через переменную окружения по шаблону GF_<СЕКЦИЯ>_<КЛЮЧ> — например, GF_SERVER_HTTP_PORT=8080 переопределяет ключ http_port в секции [server], что особенно удобно при развёртывании в Docker и Kubernetes. Среди ключевых настроек, которые стоит изучить в первую очередь: root_url (публичный URL, по которому доступна Grafana), secret_key (используется для подписи сессий и должен быть уникальным для каждой инсталляции) и allow_sign_up (установите в false, чтобы запретить самостоятельную регистрацию). Изменения в grafana.ini требуют перезапуска сервиса — выполните systemctl restart grafana-server или перезапустите контейнер, — после чего Grafana применит новую конфигурацию при старте.
Как это работает
grafana.ini: Docker-образ (grafana/grafana), Helm chart (в kube-prometheus-stack или standalone), или distro-пакеты. Конфиг в grafana.ini (auth, database, smtp, log levels). State в SQLite по дефолту; переход на Postgres/MySQL — для multi-replica HA. Плагины через grafana-cli plugins install <name>. Provisioning (datasources, dashboards) через YAML-файлы в provisioning/ для воспроизводимых setup.
Когда применять
Docker-образ — для dev + маленького prod (с persistent volume для grafana.db + data/). Postgres + несколько реплик за load balancer — для production HA. Provisioning — для version-control datasources + ключевых дашбордов. [security]-блок: смените admin-пароль, задайте secret_key, отключите signup.
Типичные ошибки
Ловушки grafana.ini: нет бекапа grafana.db (потеря дашбордов при рестарте); несколько реплик Grafana с общей SQLite (file-lock-проблемы — Postgres для HA); коммит grafana.ini с секретами в git (env vars + secret-store).