Установка Grafana в Debian или Ubuntu

Эта тема объясняет, как установить зависимости Grafana, установить Grafana в Linux Debian или Ubuntu и запустить сервер Grafana в вашей системе Debian или Ubuntu.

Есть несколько способов установить Grafana: с помощью репозитория APT Grafana Labs, загрузив пакет .deb или загрузив бинарный файл .tar.gz. Выберите только один из приведённых ниже методов, который лучше всего подходит вашим потребностям.

Note

Если вы устанавливаете через пакет .deb или файл .tar.gz, вы должны вручную обновлять Grafana для каждой новой версии.

Следующее видео демонстрирует, как установить Grafana в Debian и Ubuntu, как описано в этом документе:

Установка из репозитория APT

Если вы устанавливаете из репозитория APT, Grafana автоматически обновляется при выполнении apt-get update.

Версия Grafana Пакет Репозиторий
Grafana Enterprise grafana-enterprise https://apt.grafana.com stable main
Grafana Enterprise (Beta) grafana-enterprise https://apt.grafana.com beta main
Grafana OSS grafana https://apt.grafana.com stable main
Grafana OSS (Beta) grafana https://apt.grafana.com beta main

Note

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

Выполните следующие шаги, чтобы установить Grafana из репозитория APT:

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

    Bash
    sudo apt-get install -y apt-transport-https wget gnupg
  2. Импортируйте ключ GPG:

    Bash
    sudo mkdir -p /etc/apt/keyrings
    sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
    sudo chmod 644 /etc/apt/keyrings/grafana.asc
  3. Чтобы добавить репозиторий для стабильных релизов, выполните следующую команду:

    Bash
    echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
  4. Чтобы добавить репозиторий для бета-релизов, выполните следующую команду:

    Bash
    echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com beta main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
  5. Выполните следующую команду, чтобы обновить список доступных пакетов:

    Bash
    # Updates the list of available packages
    sudo apt-get update
  6. Чтобы установить Grafana OSS, выполните следующую команду:

    Bash
    # Installs the latest OSS release:
    sudo apt-get install grafana
  7. Чтобы установить Grafana Enterprise, выполните следующую команду:

    Bash
    # Installs the latest Enterprise release:
    sudo apt-get install grafana-enterprise

Установка Grafana с помощью пакета deb

Если вы устанавливаете Grafana вручную с помощью пакета deb, вы должны вручную обновлять Grafana для каждой новой версии.

Выполните следующие шаги, чтобы установить Grafana с помощью пакета deb:

  1. Перейдите на страницу загрузки Grafana.
  2. Выберите версию Grafana, которую хотите установить.
    • Самая последняя версия Grafana выбрана по умолчанию.
    • Поле Version отображает только помеченные релизы. Если вы хотите установить ночную сборку, нажмите Nightly Builds, а затем выберите версию.
  3. Выберите Edition.
    • Enterprise: это рекомендуемая версия. Она функционально идентична версии с открытым исходным кодом, но включает функции, которые вы можете разблокировать с помощью лицензии, если пожелаете.
    • Open Source: эта версия функционально идентична версии Enterprise, но вам нужно будет загрузить версию Enterprise, если вы хотите функции Enterprise.
  4. В зависимости от того, какая система у вас работает, нажмите вкладку Linux или ARM на странице загрузки.
  5. Скопируйте и вставьте код со страницы загрузки в вашу командную строку и выполните.

Установка Grafana как автономного бинарного файла

Выполните следующие шаги, чтобы установить Grafana с помощью автономных бинарных файлов:

  1. Перейдите на страницу загрузки Grafana.

  2. Выберите версию Grafana, которую хотите установить.

    • Самая последняя версия Grafana выбрана по умолчанию.
    • Поле Version отображает только помеченные релизы. Если вы хотите установить ночную сборку, нажмите Nightly Builds, а затем выберите версию.
  3. Выберите Edition.

    • Enterprise: это рекомендуемая версия. Она функционально идентична версии с открытым исходным кодом, но включает функции, которые вы можете разблокировать с помощью лицензии, если пожелаете.
    • Open Source: эта версия функционально идентична версии Enterprise, но вам нужно будет загрузить версию Enterprise, если вы хотите функции Enterprise.
  4. В зависимости от того, какая система у вас работает, нажмите вкладку Linux или ARM на странице загрузки.

  5. Скопируйте и вставьте код со страницы загрузки в вашу командную строку и выполните.

  6. Создайте учётную запись пользователя для Grafana в вашей системе:

    shell
    sudo useradd -r -s /bin/false grafana
  7. Переместите распакованный бинарный файл в /usr/local/grafana:

    shell
    sudo mv <DOWNLOAD PATH> /usr/local/grafana
  8. Измените владельца /usr/local/grafana на пользователей Grafana:

    shell
    sudo chown -R grafana:users /usr/local/grafana
  9. Создайте файл модуля systemd для сервера Grafana:

    shell
    sudo touch /etc/systemd/system/grafana-server.service
  10. Добавьте следующее в файл модуля в выбранном вами текстовом редакторе:

    ini
    [Unit]
    Description=Grafana Server
    After=network.target
    
    [Service]
    Type=simple
    User=grafana
    Group=users
    ExecStart=/usr/local/grafana/bin/grafana server --config=/usr/local/grafana/conf/grafana.ini --homepath=/usr/local/grafana
    Restart=on-failure
    
    [Install]
    WantedBy=multi-user.target
  11. Используйте бинарный файл, чтобы вручную запустить сервер Grafana:

    shell
    /usr/local/grafana/bin/grafana server --homepath /usr/local/grafana

    Note

    Ручной вызов бинарного файла на этом шаге автоматически создаёт каталог /usr/local/grafana/data, который должен быть создан и настроен, прежде чем установку можно будет считать завершённой.

  12. Нажмите CTRL+C, чтобы остановить сервер Grafana.

  13. Снова измените владельца /usr/local/grafana на пользователей Grafana, чтобы применить владение к только что созданному каталогу /usr/local/grafana/data:

    shell
    sudo chown -R grafana:users /usr/local/grafana
  14. Настройте сервер Grafana на запуск при загрузке с помощью systemd.

Удаление в Debian или Ubuntu

Выполните любой из следующих шагов, чтобы удалить Grafana.

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

  1. Если вы настроили Grafana на работу с systemd, остановите службу systemd для сервера Grafana:

    shell
    sudo systemctl stop grafana-server
  2. Если вы настроили Grafana на работу с init.d, остановите службу init.d для сервера Grafana:

    shell
    sudo service grafana-server stop
  3. Чтобы удалить Grafana OSS:

    shell
    sudo apt-get remove grafana
  4. Чтобы удалить Grafana Enterprise:

    shell
    sudo apt-get remove grafana-enterprise
  5. Необязательно: чтобы удалить репозиторий Grafana:

    Bash
    sudo rm -i /etc/apt/sources.list.d/grafana.list

Дальнейшие шаги