Установка и первый запуск¶

В этой главе мы реально запустим Grafana. Всё, что было раньше — подготовка.

Способ 1: Docker (быстрый старт, рекомендуемый)¶

Самый простой способ запустить Grafana — контейнер. Установите Docker Desktop / Docker Engine с вашим менеджером пакетов.

docker run -d \
  --name=grafana \
  -p 3000:3000 \
  grafana/grafana-enterprise:13.1.3

После запуска открываем браузер: http://localhost:3000. Данные по умолчанию: логин admin, пароль admin, после входа Grafana попросит сменить пароль.

Данные Grafana (внутри контейнера) хранятся внутри контейнера по пути /var/lib/grafana. Если просто запустить контейнер — все дашборды исчезнут при удалении контейнера. Исправим это в Docker Compose.

Способ 2: Docker Compose (рекомендуется для тестового стенда)¶

Создайте папку grafana и внутри неё файл docker-compose.yml:

version: "3.8"

services:
  grafana:
    image: grafana/grafana-enterprise:13.1.3
    container_name: grafana
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_USER=admin
      - GF_SECURITY_ADMIN_PASSWORD=admin
    volumes:
      - ./data:/var/lib/grafana   # постоянное хранилище

Запускаем:

docker compose up -d

Теперь даже после перезагрузки контейнера данные дашбордов сохранятся в локальной папке ./data.

Настройка первого источника данных: Prometheus и TestData DB¶

После открытия главной страницы нажимаем в левое меню Connections → Data sources → Add data source.

Prometheus (тестовый, с демо-данными)¶

Prometheus уже поднимается с демо-данными через docker compose. Если у вас нет демо-Prometheus, используйте команду:

docker compose -f https://github.com/grafana/grafana/blob/main/docker-compose/docker-compose.yaml up -d

Но для первого знакомства можно использовать встроенный TestData DB источник:

TestData DB¶

Встроенный источник данных Grafana, не требует дополнительных контейнеров. Добавляем через Connections → Data sources → поиск «TestData DB».

После добавления в поле настройки сценария (Scenario) выберите, например, CSVMetricValues (или CSV Content). Используйте любые метрики из выпадающего списка.

Для тестового графика выберите Scenario: CSVMetricValues. Позже, в главе 7, мы используем именно его.

Конфигурационный файл grafana.ini¶

Все параметры Grafana настраиваются в grafana.ini (находится по пути /etc/grafana/grafana.ini внутри контейнера). В Docker Compose эти параметры переопределяются через переменные окружения с префиксом GF_.

Примеры переменных (в Compose):

GF_SERVER_HTTP_PORT: 3000
GF_SECURITY_ADMIN_USER: admin
GF_SECURITY_ADMIN_PASSWORD: supersecret
GF_SERVER_ROOT_URL: "%(protocol)s://%(domain)s:%(http_port)s/grafana/"
GF_AUTH_GITHUB_ENABLED: true
GF_AUTH_GITHUB_CLIENT_ID: oauth-client-id
GF_AUTH_GITHUB_CLIENT_SECRET: oauth-client-secret

Если вам нужен файл grafana.ini на хосте, прокидывайте его в контейнер как volume:

volumes:
  - ./grafana.ini:/etc/grafana/grafana.ini

Все доступные переменные есть в документации: Configuration file | Grafana Labs.

Способ 3: Бинарники (реальные сервера)¶

Скачайте .deb или .rpm пакет со страницы grafana.com/download. Или для macOS:

brew install grafana

Способ 4: Helm-чарт (Kubernetes)¶

Рекомендуемый официальный чарт от Grafana:

helm repo add grafana https://grafana.github.io/helm-charts
helm repo update
helm install grafana grafana/grafana

После запуска¶

Откройте http://localhost:3000. Залогиньтесь (admin/admin). Появится Home Dashboard.

Ваша Grafana готова. Переходим к изучению интерфейса.

Далее: Интерфейс Grafana 13.1.3