文档 Grafana 文档 设置 安装 Grafana Debian 或 Ubuntu

在 Debian 或 Ubuntu 上安装 Grafana

本主题解释了如何在 Linux Debian 或 Ubuntu 上安装 Grafana 依赖项、安装 Grafana，并在您的 Debian 或 Ubuntu 系统上启动 Grafana 服务器。

有多种方式可以安装 Grafana：使用 Grafana Labs APT 仓库、下载 .deb 包，或者下载二进制 .tar.gz 文件。请选择以下最适合您需求的一种方法。

以下视频演示了如何按照本文档中的说明在 Debian 和 Ubuntu 上安装 Grafana

从 APT 仓库安装

如果您从 APT 仓库安装，当您运行 apt-get update 时，Grafana 会自动更新。

请按照以下步骤从 APT 仓库安装 Grafana

1. 安装先决条件软件包

   bash 复制

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

2. 导入 GPG 密钥

   bash 复制

   sudo mkdir -p /etc/apt/keyrings/
   wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null

3. 要添加稳定版本仓库，请运行以下命令

   bash 复制

   echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] 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.gpg] 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

使用 deb 软件包安装 Grafana

如果您使用 deb 软件包手动安装 Grafana，那么每个新版本都需要手动更新 Grafana。

请按照以下步骤使用 deb 软件包安装 Grafana

1. 导航到 Grafana 下载页面。
2. 选择您要安装的 Grafana 版本。
   • 默认选择最新的 Grafana 版本。
   • 版本字段仅显示带标签的版本。如果您想安装每夜构建版本，请点击 Nightly Builds，然后选择一个版本。
3. 选择一个版本。
   • Enterprise（企业版）：这是推荐的版本。它在功能上与开源版本相同，但包含可以通过许可证解锁的功能，如果您选择这样做。
   • Open Source（开源版）：此版本在功能上与 Enterprise 版本相同，但如果您需要 Enterprise 功能，则需要下载 Enterprise 版本。
4. 根据您运行的系统，在下载页面上点击 Linux 或 ARM 选项卡。
5. 将下载页面上的代码复制并粘贴到您的命令行中运行。

以独立二进制文件形式安装 Grafana

请按照以下步骤使用独立二进制文件安装 Grafana

1. 导航到 Grafana 下载页面。

2. 选择您要安装的 Grafana 版本。

   • 默认选择最新的 Grafana 版本。
   • 版本字段仅显示带标签的版本。如果您想安装每夜构建版本，请点击 Nightly Builds，然后选择一个版本。

3. 选择一个版本。

   • 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. 创建 Grafana 服务器 systemd 单元文件

   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

    注意

    在此步骤中手动调用二进制文件会自动创建 /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 运行，请停止 Grafana 服务器的 systemd 服务

   shell 复制

   sudo systemctl stop grafana-server

2. 如果您配置了 Grafana 使用 init.d 运行，请停止 Grafana 服务器的 init.d 服务

   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

后续步骤

• 启动 Grafana 服务器