Документация Grafana Документация GlaberGraph Администрирование Управление плагинами Установка плагина

Установка плагина

Установка плагина через интерфейс Grafana

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

1. В Grafana перейдите в Administration > Plugins and data > Plugins в меню боковой навигации, чтобы увидеть все плагины.
2. Найдите плагин, который нужно установить.
3. Нажмите на логотип плагина.
4. Нажмите Install.

В зависимости от вашего окружения или конфигурации вы можете использовать следующие альтернативные способы установки плагина.

Установка плагина с помощью Grafana CLI

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

Установка плагина из ZIP-файла

Этот способ обычно используется для плагинов, недоступных в каталоге плагинов, или в средах без доступа к интернету.

Скачайте архив с файлами плагина и установите его, распаковав архив в каталог плагинов. Например:

Bash Copy

unzip my-plugin-0.2.0.zip -d YOUR_PLUGIN_DIR/my-plugin

Путь к каталогу плагинов задаётся в файле конфигурации. Дополнительные сведения см. в разделе Конфигурация.

Установка плагина через конфигурацию Grafana

Вы можете устанавливать плагины, добавив идентификатор плагина в раздел plugins.preinstall файла конфигурации Grafana. Это защищает плагин от случайного удаления и позволяет автоматически его обновлять. Дополнительные сведения см. в разделе Конфигурация.

Установка плагина в среде без доступа к интернету

Для установки плагинов обычно требуется подключение к интернету. Вы можете проверить, какие эндпоинты используются во время установки в вашем экземпляре, и добавить их в список разрешённых на своём экземпляре.

Если это невозможно, попробуйте установить плагин с помощью Grafana CLI или как ZIP-файл.

Вы можете получить любой плагин из API Grafana.com, воспользовавшись ссылкой для скачивания, указанной в API. Ниже приведён пример на основе плагинов grafana-lokiexplore-app.

1. Откройте https://grafana.com/api/plugins/grafana-lokiexplore-app и найдите раздел links
2. Найдите URL download, который выглядит примерно так: https://grafana.com/api/plugins/grafana-lokiexplore-app/versions/1.0.2/download
3. Используйте этот URL, чтобы скачать ZIP-файл плагина, который затем можно установить, как описано выше.

Установка плагинов с помощью Helm-чарта Grafana

С Helm-чартом Grafana вы можете устанавливать плагины одним из описанных в этом разделе способов. Все фрагменты YAML устанавливают версию 1.9.0 плагина Grafana OnCall App и плагин источника данных Redis. Когда установка завершится, появится сообщение, подтверждающее, что плагины успешно установлены.

Способ 1: использовать поле plugins

Добавьте плагины, которые нужно установить, в виде списка в файл values. Дополнительные сведения о конфигурации см. в справочнике по конфигурации Helm-чарта.

YAML Copy

plugins:
  - https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download;grafana-oncall-app
  - redis-datasource

Способ 2: использовать GF_PLUGINS_PREINSTALL_SYNC

Добавьте следующее в файл values.yaml:

YAML Copy

env:
  # Format: <plugin ID>@[<plugin version>]@<url to plugin zip>
  GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app@1.9.0@https://grafana.com/api/plugins/grafana-oncall-app/versions/v1.9.0/download

  # Or without version and URL (latest version will be used)
  # GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app

  # Multiple plugins (comma-separated)
  # GF_PLUGINS_PREINSTALL_SYNC: grafana-oncall-app,redis-datasource

Способ 3: использовать GF_PLUGINS_INSTALL (устарел начиная с v12.1.0)

Добавьте следующее в файл values.yaml:

YAML Copy

env:
  # Comma-separated list of plugin IDs
  GF_PLUGINS_INSTALL: grafana-oncall-app,redis-datasource