Установка и настройка Grafana на Ubuntu

Grafana — популярный инструмент с открытым исходным кодом для интерактивной визуализации и анализа данных. Он позволяет объединять метрики и логи из разных источников (Prometheus, Graphite, Elasticsearch, PostgreSQL и др.), строить настраиваемые панели, задавать оповещения и делиться дашбордами.

В этом руководстве вы найдёте пошаговые инструкции по установке Grafana на Ubuntu тремя способами, управление службой, доступ к веб-интерфейсу, базовые шаги настройки, советы по безопасности, план отката и проверочные списки для администраторов и разработчиков.

Основная идея и варианты задачи

Основная задача: установить и запустить Grafana на сервере Ubuntu так, чтобы он был надёжно доступен, имел подключённые источники данных и защищён базовыми мерами безопасности.

Варианты решения:

• Установка из официального APT-репозитория (рекомендуется для автоматических обновлений).
• Установка с DEB-пакета (удобно для офлайн-серверов или конкретных версий).
• Установка из бинарного TAR.GZ (для портативных развёртываний или нестандартных путей).

Важно: команды в примерах выполняются от имени пользователя с sudo или root. Перед установкой сделайте резервную копию конфигураций и данных, если это обновление существующей инсталляции.

1. Установка Grafana из официального репозитория (APT)

Этот метод удобен для автоматического получения обновлений и интеграции с системой управления пакетами Ubuntu.

Шаги:

1. Установите необходимые пакеты-пререквизиты:

sudo apt install -y apt-transport-https software-properties-common

2. Скачайте GPG-ключ Grafana и сохраните его в системном хранилище ключей:

wget -q -O /usr/share/keyrings/grafana.key https://packages.grafana.com/gpg.key

3. Добавьте репозиторий. Для Enterprise-издания выполните:

echo deb [signed-by=/usr/share/keyrings/grafana.key] https://packages.grafana.com/enterprise/deb stable main | sudo tee -a /etc/apt/sources.list.d/grafana.list

Для OSS-издания выполните:

echo deb [signed-by=/usr/share/keyrings/grafana.key] https://packages.grafana.com/oss/deb stable main | sudo tee -a /etc/apt/sources.list.d/grafana.list

4. Обновите индекс пакетов и установите Grafana:

sudo apt update
sudo apt install grafana-enterprise        # для Enterprise
sudo apt-get install grafana              # для OSS

Примечание: используйте либо команду для Enterprise, либо для OSS в зависимости от лицензии.

Важно: после установки служба Grafana обычно не запускается автоматически — смотрите раздел управления службой ниже.

2. Установка через DEB-пакет

Если у вас нет доступа к интернет-репозиторию или нужна конкретная версия, можно установить DEB-пакет.

1. Скачайте нужную версию (пример для 9.1.5):

Enterprise:

wget https://dl.grafana.com/enterprise/release/grafana-enterprise_9.1.5_amd64.deb

OSS:

wget https://dl.grafana.com/oss/release/grafana_9.1.5_amd64.deb

2. Установите пакет:

sudo dpkg -i grafana*_amd64.deb

3. Если возникнут зависимости, исправьте их:

sudo apt-get install -f

Этот метод оставляет управление службой в systemd (как и при установке из репозитория).

3. Установка из бинарного TAR.GZ

Подходит для тестирования, контейнеризации вручную или развёртывания в нестандартном каталоге.

1. Скачайте TAR.GZ файл:

Enterprise:

wget https://dl.grafana.com/enterprise/release/grafana-enterprise-9.1.5.linux-amd64.tar.gz

OSS:

wget https://dl.grafana.com/oss/release/grafana-9.1.5.linux-amd64.tar.gz

2. Распакуйте архив:

sudo tar -zxvf grafana-*.tar.gz

3. Перейдите в папку с распакованной сборкой и запустите бинарный файл:

cd grafana-*
./bin/grafana-server web

Чтобы остановить процесс, нажмите Ctrl+C. Для продакшена рекомендуется создать systemd unit, чтобы сервис запускался как системная служба.

Управление службой Grafana (systemd)

При установке через APT/DEB Grafана интегрируется с systemd. Команды для повседневного управления:

Перезагрузить конфигурацию демонов и запустить сервис:

sudo systemctl daemon-reload
sudo systemctl start grafana-server

Проверить статус:

sudo systemctl status grafana-server

Включить автозапуск при старте системы:

sudo systemctl enable grafana-server.service

Если вы запускали Grafana из распакованного архива, используйте запуск бинаря как показано выше либо напишите unit-файл systemd, который будет запускать ./bin/grafana-server web от отдельного пользователя.

Важно: убедитесь, что пользователь, от которого запускается сервис, имеет доступ к папкам с данными и логами (/var/lib/grafana по умолчанию).

Доступ к веб-интерфейсу Grafana

По умолчанию Grafana слушает HTTP на порту 3000. Если у вас включён UFW (фаервол Ubuntu), откройте порт:

sudo ufw allow 3000/tcp

Откройте в браузере адрес:

http://:3000

Стандартные учётные данные при первой загрузке:

Email или имя пользователя: admin Пароль: admin

После первого входа система попросит сменить пароль.

Базовая настройка: источник данных и дашборд

Ниже — сокращённый чеклист для быстрой настройки после первого входа.

Добавление источника данных

1. Войдите в Grafana.
2. На левой боковой панели кликните значок «Configuration» (иконка шестерёнки) — на русском интерфейсе это «Настройки».
3. Выберите «Data sources» (Добавить источник данных) и нажмите «Add data source».
4. Выберите тип источника (Prometheus, Graphite, Elasticsearch, PostgreSQL и т.д.).
5. Заполните поля: URL/хост, порт, параметры аутентификации, TLS (если требуется).
6. Нажмите «Save & test». Если вы видите сообщение «Database Connection OK» или «Data source is working», подключение успешно.

Критерии приёмки:

• Источник данных отвечает на тестовый запрос.
• Конфигурация сохранена и отображается в списке.
• При использовании секретов они сохранены в vault/ключнице (см. раздел безопасности).

Создание нового дашборда

1. Наведите курсор на значок «Dashboards» в левой панели и выберите «New dashboard».
2. Нажмите «Add a new panel».
3. Вкладке «Query» выберите ранее добавленный источник данных.
4. Настройте запрос, проверьте результат на графике.
5. В правой панели выберите тип визуализации (Graph, Gauge, Table и т.д.) и укажите название панели.
6. Нажмите «Apply», затем «Save» для сохранения дашборда. Дайте имя и при необходимости выберите папку.

Критерии приёмки:

• Панель отображает ожидаемые метрики.
• Дашборд корректно сохраняется и доступен другим пользователям с нужными правами.

Безопасность и лучшие практики

Минимальный набор действий для безопасного развёртывания Grafana:

• Смените дефолтный пароль admin сразу после первого входа.
• Ограничьте доступ к порту 3000 брандмауэром (UFW, security groups в облаке).
• Разверните Grafana за обратным прокси (nginx, HAProxy) с TLS (Let’s Encrypt).
• Включите аутентификацию через внешние источники (LDAP, OAuth, SSO) для централизованного управления доступом.
• Храните секреты и подключения в защищённом хранилище (Vault или KMS).
• Регулярно обновляйте Grafana и плагины; следите за CVE-уведомлениями.
• Ограничьте права пользователей: используйте роли Viewer/Editor/Admin по необходимости.

Пример настроек nginx как обратного прокси с TLS — краткая подсказка (не полная конфигурация):

server {
    listen 80;
    server_name grafana.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name grafana.example.com;

    ssl_certificate /etc/letsencrypt/live/grafana.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/grafana.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Важно: настройте headers и доверенные прокси в конфигурации Grafana при использовании обратного прокси.

План отката и удаление

Если нужно удалить Grafana или откатиться:

1. Остановите сервис:

sudo systemctl stop grafana-server

2. Удаление при установке через APT/DEB:

sudo apt purge grafana
sudo apt autoremove

3. При установке из TAR удалите каталог и архивы (проверьте пути перед выполнением):

sudo rm -r grafana-* grafana-*.tar.gz

4. Восстановление конфигурации: держите резервные копии /etc/grafana и /var/lib/grafana (данные и плагины). Для отката установите требуемую версию пакета DEB или восстановите директорию из резервной копии.

Критерии успешного отката:

• Сервис не запущен в новой версии.
• Восстановленная версия Grafana стартует и читает старые данные.

Отладка и часто встречаемые проблемы (Runbook)

Проблема: Grafana не стартует. Действия:

• Просмотрите логи:

sudo journalctl -u grafana-server -b --no-pager

• Проверьте права на /var/lib/grafana и /var/log/grafana:

ls -la /var/lib/grafana /var/log/grafana
sudo chown -R grafana:grafana /var/lib/grafana /var/log/grafana

• Если конфигурация была изменена, откатите /etc/grafana/grafana.ini или проверьте синтаксис.

Проблема: 502 Bad Gateway через обратный прокси. Действия:

• Проверьте, слушает ли Grafana порт 3000:

sudo ss -ltnp | grep 3000

• Убедитесь, что proxy_pass ссылается на правильный адрес и порт.

Проблема: источник данных не подключается. Действия:

• Тестируйте соединение с хоста Grafana (curl/telnet).
• Проверьте настройки аутентификации и TLS.

Когда Grafana может не подойти (контрпримеры)

• Если требуется исключительно визуализация на стороне клиента без сервера — можно использовать клиентские библиотеки JS (Chart.js, D3).
• Если нужен простой одноразовый отчёт в Excel/CSV невысокой частоты — Grafana может быть избыточной.
• Если архитектура ориентирована на OLAP-аналитику с агрегациями больших таблиц — специализированные BI-инструменты (Metabase, Superset, коммерческие BI) могут дать более богатые средства моделирования.

Альтернативы и краткое сравнение

• Prometheus + Grafana — стандарт для мониторинга метрик; Prometheus служит хранилищем.
• Metabase — проще для бизнес-аналитиков и SQL-запросов.
• Apache Superset — мощнее для аналитики и визуализаций SQL-источников.
• Kibana — лучше для глубокого анализа логов с Elasticsearch.

Выбор зависит от типа данных (метрики vs логи vs реляционные), частоты обновления и навыков команды.

Ролевые чеклисты

Администратор (DevOps):

• Установить Grafana и настроить systemd unit.
• Настроить обратный прокси и TLS.
• Настроить бэкапы /etc/grafana и /var/lib/grafana.
• Настроить мониторинг состояния сервиса и оповещения.

Разработчик/Инженер SRE:

• Добавить источник данных (Prometheus/DB).
• Написать базовые запросы и панели для ключевых метрик.
• Настроить алерты (thresholds) и тестовые уведомления.

Бизнес-аналитик:

• Определить ключевые метрики и цели дашборда.
• Создать визуализации и поделиться дашбордом с командой.
• Протестировать права доступа для конечных пользователей.

Мини-методология развёртывания Grafana (шаги)

1. Планирование: определите источники данных, объём метрик и требования по доступу.
2. Подготовка: выделите VM/контейнер, настройте сеть и SSL.
3. Развёртывание: используйте APT для стабильной установки или DEB для контрольной версии.
4. Настройка: подключите источники, создайте дашборды и алерты.
5. Операции: автоматизируйте бэкапы, обновления и мониторинг самой Grafana.

Краткий словарь (1 строка)

Grafana — сервер визуализации метрик и логов с веб-интерфейсом и поддержкой множества источников данных.

Факто-бокс: ключевые цифры и пути (ориентировочно)

• Порт по умолчанию: 3000
• Конфигурация: /etc/grafana/grafana.ini
• Данные и плагины: /var/lib/grafana
• Логи: /var/log/grafana
• Сервис systemd: grafana-server

Резюме

Grafana — гибкий инструмент для визуализации метрик и логов. На Ubuntu вы можете установить его через официальный APT-репозиторий, DEB-пакет или распаковку TAR.GZ. После установки важно защитить интерфейс HTTPS, интегрировать аутентификацию и настроить резервное копирование. Если Grafana не подходит по требованиям, рассмотрите Metabase, Superset или Kibana в зависимости от типа данных.

Дополнительные ресурсы: официальная документация Grafana (https://grafana.com/docs) и репозитории пакетов для вашей версии Ubuntu.