Инструменты Grafana#

Grafana - инструмент для визуализации данных из различных источников. Используется для представления в графическом виде данных временных рядов и текстовых данных и обладает высокой производительностью при работе с большими объемами данных.

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

Grafana взаимодействует со следующими источниками данных:

• Prometheus;

• Graphite;

• MySQL;

• InfluxDB;

• Elasticsearch;

• Loki и так далее.

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

• Graph – панель с графиками с возможностью комбинировать несколько метрик на одной панели;

• Gauge – панель в формате спидометра, есть возможность ограничить верхнее значение на шкале;

• Bar Gauge – панель с возможностью отображения метрик на вертикальной гистограмме;

• Table – панель с представлением в виде таблицы, на которой можно отображать значения нескольких метрик;

• Flame - панель, используемая для визуализации данных профилирования из Pyrscope и других источников данных непрерывного профилирования.

• Text – панель для отображения произвольного текста (подписи).

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

Функции визуализации графиков Grafana:

• многослойный режим: возможно отображение многослойного представления любого символа на графике Flame. В многослойном представлении все вызывающие объекты отображаются вверху, а все вызываемые объекты символа — внизу. Это полезно при необходимости видеть контекст символа;

• переключение цветовой схемы: возможно переключение цветовой схемы между цветовым градиентом на основе относительного значения символа или имени пакета символа;

• переключение выравнивания имен символов. Символы с длинными именами может быть трудно отличить, если они имеют одинаковый префикс. Grafana позволяет выравнивать текст по левому или правому краю для наблюдения важной части имени символа;

• улучшенная навигация: доступно выделение символа или включение для него многослойного режима из таблицы. Кроме того, новая строка состояния поверх графика показывает, какие представления включены.

Также Grafana поддерживает функцию отключения значения в визуализациях временных рядов, трендов и временных шкал состояния.

В Grafana реализована функция редактора виджетов. Чтобы увидеть редактор виджетов в Grafana, включите переключатель функции vizAndWidgetSplit.

Grafana обладает функцией связывания строк журнала Loki в Explore, позволяющей быстро переходить к конкретным записям журнала для точного анализа. Нажав кнопку Copy link для строки журнала, возможно создать и скопировать короткий URL-адрес, который обеспечивает прямой доступ к конкретной записи журнала в абсолютном диапазоне времени. При переходе по ссылке Grafana автоматически прокручивает соответствующую строку журнала и выделяет ее, что позволяет легко идентифицировать и сосредоточиться на соответствующей информации.

Grafana Correlations - функция, позволяющая устанавливать связи между любыми запросами к источникам данных и передавать данные, такие как пространство имен, host или значения меток.

Аутентификация и авторизация:

• No basic role - базовая роль без разрешений. Позволяет настроить индивидуальные разрешения RBAC для сервисных аккаунтов или пользователей;

• поддержка анонимного доступа для удобного контроля и мониторинга анонимного использования;

• удобный пользовательский интерфейс для настройки одноэтапной аутентификации (SSO) и Terraform ресурс для настройки OAuth-провайдеров.

В Grafana доступны опции для включения всей таблицы данных в PDF-отчеты, что значительно улучшает опыт создания отчетов.

Установка Grafana#

Для установки Grafana выполните следующие действия:

1. Создайте пространство имен для мониторинга:

   kubectl create namespace monitoring
   

2. Создайте файл манифеста grafana.yaml:

   grafana.yaml

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: grafana-pv
      labels:
        type: local
    spec:
      capacity:
        storage: 10Gi
      accessModes:
        - ReadWriteOnce
      local:
        path: /mnt
      nodeAffinity:
        required:
          nodeSelectorTerms:
          - matchExpressions:
            - key: kubernetes.io/hostname
              operator: In
              values:
              - worker2
    ---
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: grafana-pvc
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: 1Gi
    ---
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      labels:
        app: grafana
      name: grafana
    spec:
      selector:
        matchLabels:
          app: grafana
      template:
        metadata:
          labels:
            app: grafana
        spec:
          securityContext:
            fsGroup: 472
            supplementalGroups:
              - 0
          containers:
            - name: grafana
              image: <path>/2.1.0/dapp-grafana-9-5/grafana:9.5.17 # Адрес репозитория приведен в качестве примера и должен быть заменен на актуальный.
              imagePullPolicy: IfNotPresent
              ports:
                - containerPort: 3000
                  name: http-grafana
                  protocol: TCP
              readinessProbe:
                failureThreshold: 3
                httpGet:
                  path: /robots.txt
                  port: 3000
                  scheme: HTTP
                initialDelaySeconds: 10
                periodSeconds: 30
                successThreshold: 1
                timeoutSeconds: 2
              livenessProbe:
                failureThreshold: 3
                initialDelaySeconds: 30
                periodSeconds: 10
                successThreshold: 1
                tcpSocket:
                  port: 3000
                timeoutSeconds: 1
              resources:
                requests:
                  cpu: 250m
                  memory: 750Mi
              volumeMounts:
                - mountPath: /var/lib/grafana
                  name: grafana-pv
          volumes:
            - name: grafana-pv
              persistentVolumeClaim:
                claimName: grafana-pvc
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: grafana
    spec:
      ports:
        - port: 3000
          protocol: TCP
          targetPort: http-grafana
          nodePort: 31000
      selector:
        app: grafana
      sessionAffinity: None
      type: NodePort
      
   

3. Выполните команду:

   kubectl apply -f ./grafana.yaml
   

4. Проверьте статус выполнения команды из шага 3:

   kubectl rollout status deployment.apps/grafana -n monitoring
   

   Проверьте, что в выводе содержится статус successfully rolled out.

5. Перенаправьте порт для сервиса Grafana на localhost:

   kubectl port-forward svc/grafana -n monitoring --address localhost 3000:3000
   

6. Выполните команду:

   curl -L localhost:3000
   

7. Откройте в браузере http://localhost:3000 и выполните аутентификацию и авторизацию в Grafana с логином и паролем, по умолчанию admin/admin.

8. Убедитесь, что на следующей странице есть поле newPassword и смените пароль.

Сценарии использования Grafana#

Совместная работа с VictoriaMetrics#

Для данного сценария необходимо установить инструменты VictoriaMetrics и выполнить шаги 14-20 в соответствии со сценариями настоящего руководства администратора, раздел Victoriametrics.

Добавление источника данных посредством web-интерфейса#

Добавление источника данных предшествует созданию панели мониторинга.

Чтобы добавить источник данных, выполните последовательность:

1. Нажмите Connections в меню слева.

2. Введите имя конкретного источника данных в диалоговом окне поиска.

3. Отфильтруйте по источнику данных Data source, чтобы видеть только источники данных.

4. Нажмите источник данных, который необходимо добавить.

5. Настройте источник данных, следуя инструкциям, специфичным для этого источника данных.

6. Настройте разрешения для источника данных, чтобы разрешить или запретить определенным пользователям возможность запрашивать или редактировать источник данных. Конфигурация каждого источника данных включает вкладку «Разрешения», на которой возможно ограничение разрешения источника данных определенными пользователями, командами или ролями.

Совместная работа с Jaeger#

Предварительные условия совместной работы с Jaeger#

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

Добавление источника данных в Grafana приведено в сценарии Совместная работа с VictoriaMetrics. Добавлять источники данных могут только пользователи с ролью администратора DropApp. Администратор также может настроить источник данных через YAML с помощью системы обеспечения Grafana.

Добавив источник данных, настройте его так, чтобы пользователи экземпляра Grafana могли создавать запросы в редакторе запросов. Когда пользователи создают информационные панели и используют Explore.

Настройка источника данных#

Чтобы настроить основные параметры источника данных, выполните следующие действия:

1. Нажмите Подключения в меню слева.

2. В разделе Ваши подключения нажмите Источники данных.

3. Введите Jaeger в строку поиска.

4. Выберите Jaeger. Отобразится вкладка Настройки источника данных.

5. Установите основные параметры конфигурации источника данных:

Плагины#

Начиная с версии 5.1.0, в состав Grafana добавлены плагины, приведенные в таблице: