Grafana 的安装与部署

• 官网地址：

  https://grafana.com

• Grafana有三个主要的版本：

  • Grafana OSS（开源版）：这是免费的版本，用户可以自由使用并根据自己的需求进行定制。
  • Grafana Enterprise（企业版）：这是付费的版本，提供了更多的功能和支持，通常用于大型企业或需要高级功能的场景。企业版包含了开源版的内容，并可以升级到完整的企业版功能。
  • Grafana Cloud（云版）：这是一个基于云的解决方案，提供了与开源版和企业版相似的功能，但部署在云端，并提供了额外的服务和支持。

1. 下载安装最新版本的 Grafana ：

• 方案一：

  • 下载链接： Grafana Download
  • 解压缩命令：tar -zxvf grafana-*.tar.gz
  • 将Grafana文件复制到生产服务器的合适位置：
  • 例如：/usr/local/bin/grafana

• 方案二： 使用命令一键安装 -RPM

  sudo yum install -y https://dl.grafana.com/oss/release/grafana-11.1.0-1.x86_64.rpm
  

  • 此时会自动创建 service 文件，通常位于： vim /usr/lib/systemd/system/grafana-server.service

  • RPM 安装默认使用的配置文件位于： /etc/grafana/grafana.ini , 如果需要自定义其他文件则使用启动参数 --config 指定文件即可

    • 当使用rpm包安装Grafana时，通常会发现两个与配置文件相关的文件：/usr/share/grafana/conf/defaults.ini 和 /etc/grafana/grafana.ini .
      • defaults.ini 是模板文件，通常不应被修改，用于参考和备份。
      • grafana.ini 是实际使用的配置文件，用于定制Grafana的行为。

2. 配置 Grafana 的配置文件，defaults.ini

# 例如： 指定Grafana的数据存储位置，以便存储用户数据和配置信息。 （如果不设置则默认使用 /var/lib/grafana/grafana.db ）
[paths]
data = /home/grafana/data
# 设置日志目录 （如果不设置则默认使用 /var/log/grafana）
logs = /home/grafana/logs

## 可选  - SMTP 服务器 （用于发送告警邮件）
[smtp]  
enabled = true  
host = smtp.feishu.cn:465  # 飞书SMTP服务器地址和端口  
user = [email protected]  # 你的飞书邮箱账号  
password = your_password  # 你的飞书邮箱密码或应用专用密码  
from_address = [email protected]  # 发件人邮箱地址  
from_name = Your Name  # 发件人姓名（可选）  
# 如果需要，还可以配置cert_file和key_file用于SSL/TLS证书验证，但通常这不是必需的

• Tips : 可以选择使用如QQ邮箱、Gmail等提供的SMTP服务，或者使用本地SMTP服务（如sendmail）。 注意：如果选择使用云服务商提供的SMTP服务，需要确保服务器可以访问到SMTP服务器的地址和端口（如QQ邮箱的smtp.qq.com:465）。

2. 启动Grafana服务，并访问Web界面。

   1. 直接启动

      • 启动命令：./bin/grafana-server

   2. 如果是RPM安装，则直接使用 grafana 服务

      sudo systemctl daemon-reload
      sudo systemctl start grafana-server
      sudo systemctl status grafana-server
      

      • 安装包信息：
        二进制文件： /usr/sbin/grafana-server
        init.d 脚本： /etc/init.d/grafana-server
        环境变量文件： /etc/sysconfig/grafana-server
        配置文件： /etc/grafana/grafana.ini
        启动项： grafana-server.service
        日志文件：/var/log/grafana/grafana.log
        默认配置的sqlite3数据库：/var/lib/grafana/grafana.db

   3. 【可选】如果需要自己安装配置 Grafana 服务 : 创建 /etc/systemd/system/grafana.service

      [Unit]
      Description=Grafana
      After=network.target
      
      [Service]
      Type=simple
      User=grafana
      Group=grafana
      WorkingDirectory=/path/to/grafana
      ExecStart=/usr/local/bin/grafana-server --config=/etc/grafana/grafana.ini
      Restart=always
      
      [Install]
      WantedBy=multi-user.target
      

      • 启动： sudo systemctl start grafana
      • 重启： sudo systemctl restart grafana
      • 设置开机自启命令：sudo systemctl enable grafana

   4. 访问web页面

      • http://localhost:3000
        • 3000为Grafana的默认侦听端口
        • 系统默认用户名和密码为 admin/admin ，第一次登陆系统会要求修改密码

   5. 查看日志：

      • journalctl -u grafana-server

      • 如果启动失败，需要进一步查看日志： 运行 journalctl -xe 即可查看。 或者用 tail -f /var/log/messages 也可以

        • 例如：

        Jun 26 17:14:22 iZwz977q9yphbab9v58w7lZ grafana[25542]: logger=featuremgmt t=2024-06-26T17:14:22.986538208+08:00 level=info msg=FeatureToggles lokiQueryHints=true prometheusMetricEncyclopedia=true influxdbBackendMig
        Jun 26 17:14:22 iZwz977q9yphbab9v58w7lZ grafana[25542]: Error: ✗ failed to connect to database: mkdir /home/data: permission denied
        Jun 26 17:14:22 iZwz977q9yphbab9v58w7lZ systemd[1]: grafana-server.service: main process exited, code=exited, status=1/FAILURE
        Jun 26 17:14:23 iZwz977q9yphbab9v58w7lZ systemd[1]: Failed to start Grafana instance.
        

3. 配置数据源，在Grafana仪表板将Prometheus作为数据源添加到Grafana。

Configuration -> Data Sources ->add data source -> Prometheus

4. Grafana 页面创建仪表板和图表，以可视化Prometheus收集的监控数据。

创建好数据源之后，就需要创建DashBoard（仪表盘），可以自定义，也可以导入你需要的仪表盘，官方也提供了很多的可选仪表盘。

• https://grafana.com/orgs/starsliao/dashboards
• https://grafana.com/grafana/dashboards/