2. Grafana 安装

本章节将指导你如何使用 Docker、Kubernetes 或在本地环境安装和设置 Grafana。

2.1 安装选项

Grafana 提供了多种安装和部署选项，以满足不同的需求和环境：

• 本地安装 (Local Install)：

  • 直接在你的操作系统上安装 Grafana。
  • 适合开发和本地测试环境。
  • 支持主流操作系统，包括 Windows, macOS, 和各种 Linux 发行版。

• Docker 部署 (Docker Deployment)：

  • 推荐方式。通过容器化技术进行部署，实现快速、便携且环境隔离。
  • 简化了升级和管理过程。

• 基于云的服务 (Cloud Services)：

  • 例如 Grafana Cloud，提供托管和可扩展的解决方案，免去了自行维护的麻烦。

2.2 系统要求

在安装 Grafana 之前，请确保你的系统满足以下基本要求：

• 支持的操作系统:

  • Debian/Ubuntu
  • RHEL/Fedora
  • SUSE/openSUSE
  • macOS
  • Windows

• 硬件建议:

  • 最低内存: 512 MB
  • 最低 CPU: 1 核

• 数据库:

  • Grafana 需要一个数据库来存储其配置数据（如用户、数据源和仪表板）。
  • 支持 SQLite 3, MySQL 8.0+, PostgreSQL 12+。
  • 默认使用嵌入式的 SQLite 数据库，无需额外配置，非常方便。

• 支持的 Web 浏览器:

  • Chrome/Chromium (最新版)
  • Firefox (最新版)
  • Safari (最新版)
  • Microsoft Edge (最新版)

2.3 在 openEuler 24.03 (LTS-SP1)系统上使用 Docker 部署

系统配置

[root@localhost docker]# cat /etc/os-release
NAME="openEuler"
VERSION="24.03 (LTS-SP1)"
ID="openEuler"
VERSION_ID="24.03"
PRETTY_NAME="openEuler 24.03 (LTS-SP1)"
ANSI_COLOR="0;31"

安装部署

你可以选择使用 Docker Compose (推荐) 或独立的 docker run 命令来部署 Grafana。两种方法都将使用 grafana/grafana-enterprise 镜像，并将数据持久化到本地的 ./data 目录。

方法一：使用 Docker Compose (推荐)

Docker Compose 使用 YAML 文件来定义和运行多容器 Docker 应用程序，非常适合管理应用的配置。

docker cp grafana:/etc/grafana ./conf
docker cp grafana:/var/lib/grafana ./data

"udp://10.101.103.227", "udp://10.101.103.226", "udp://10.101.103.225", "udp://10.101.103.224",

labels =

path = ["/docker/categraf/categraf-v0.4.13-linux-amd64/mibs/huawei/switch"]

1. 创建 docker-compose.yaml 文件: 在你的工作目录 (例如 /docker/grafana/) 中创建 docker-compose.yaml 文件，并填入以下内容：

   services:
     grafana:
       image: grafana/grafana-oss:main-ubuntu
       container_name: grafana
       restart: unless-stopped
       # 如果以root身份运行，请将user设置为'0'
       # 否则，请使用 `id -u` 命令查找当前用户的ID
       user: "0"
       ports:
         - "3000:3000"
       # 将容器内的 /var/lib/grafana 目录挂载到宿主机的 ./data 目录
       # 这可以确保Grafana数据（如仪表板、数据源配置）在容器重启后依然存在
       volumes:
         - "./data:/var/lib/grafana"

2. 启动服务: 在 docker-compose.yaml 文件所在的目录中，运行以下命令启动 Grafana 服务：

   docker compose -f ./docker-compose.yaml up -d

方法二：使用独立的 Docker 命令

这是一种更直接的方式，通过单条命令启动容器。

1. 执行 docker run 命令: 在你的工作目录 (例如 /docker/grafana/) 中执行以下命令：

   docker run -d --name grafana \
     --restart unless-stopped \
     -u 0 \
     -p 3000:3000 \
     -v ./data:/var/lib/grafana \
     -v ./etc:/etc/grafana \
     grafana/grafana-oss:main-ubuntu

   命令解析:

   • -d: 后台运行容器。
   • --name grafana: 指定容器名称为 grafana。
   • --restart unless-stopped: 容器退出时自动重启，除非手动停止。
   • -u 0: 以 root 用户 (UID 0) 运行容器内的进程，确保对挂载目录有写入权限。
   • -p 3000:3000: 将宿主机的 3000 端口映射到容器的 3000 端口。
   • -v ./data:/var/lib/grafana: 将当前目录下的 data 文件夹挂载到容器的 /var/lib/grafana，用于持久化数据。
   • grafana/grafana-enterprise: 指定使用的 Docker 镜像。

2.4 首次访问 Grafana

安装并运行 Grafana 后，你可以通过浏览器进行访问：

• 访问地址: http://localhost:3000 (如果 Grafana 运行在远程服务器上，请将 localhost 替换为服务器的 IP 地址)
• 默认用户名: admin
• 默认密码: admin

 首次登录后，Grafana 会要求你修改默认密码以增强安全性。

2.5 更多信息

有关更详细的安装说明或针对特定系统的安装指南，请参考官方文档：

• Grafana 官方安装文档: https://grafana.com/docs/grafana/latest/setup-grafana/installation/