date: 2020-08-29title: grafana安装、配置及升级 #标题
tags: grafana #标签
categories: 监控 # 分类

记录下grafana安装、配置及升级过程。

下载安装

  1. $ wget https://dl.grafana.com/oss/release/grafana-7.1.4-1.x86_64.rpm
  2. $ yum -y install grafana-7.1.4-1.x86_64.rpm

部分配置解释

  1. $ cat /etc/sysconfig/grafana-server   # 查看grafana相关数据存放目录
  2. GRAFANA_USER=grafana      # 系统用户
  4. GRAFANA_GROUP=grafana     # 组
  6. GRAFANA_HOME=/usr/share/grafana    # grafana的家目录，静态资源默认存放位置，升级时建议备份
  8. LOG_DIR=/var/log/grafana          # 日志目录
  10. DATA_DIR=/var/lib/grafana          # 数据目录，升级时建议备份
  12. MAX_OPEN_FILES=10000             # 最大可打开文件数
  14. CONF_DIR=/etc/grafana             # 配置文件目录，升级时建议备份
  16. CONF_FILE=/etc/grafana/grafana.ini       # 配置文件
  18. RESTART_ON_UPGRADE=true           # 更新时就重启
  20. PLUGINS_DIR=/var/lib/grafana/plugins      # 插件目录
  22. PROVISIONING_CFG_DIR=/etc/grafana/provisioning     
  23. # 通过读取配置文件的方式来配置datasource和dashboard
  24. # 而不是在grafana图形窗口中操作
  26. # Only used on systemd systems
  27. PID_FILE_DIR=/var/run/grafana     # 进程存放目录
  32. $ cat /etc/grafana/grafana.ini    # 查看部分重要配置文件
  34. # 注意修改数据存储路径后，需要将原来位置
  35. 数据同步到新的路径下。
  37. [paths]
  38. data = /data/grafana
  39. temp_data_lifetime = 24h
  40. logs = /var/log/grafana
  41. plugins = /data/grafana/plugins
  42. [server]
  43. http_port = 8000    # 监听端口
  44. # 以下两条在使用nginx反向代理grafana时需要配置，否则无需配置。
  45. root_url = %(protocol)s://%(domain)s:%(http_port)s/grafana
  46. serve_from_sub_path = true

注: 修改data或plugins默认存储路径时，除了改grafana.ini，还应该修改/etc/sysconfig/grafana-server和/etc/init.d/grafana-server（可选）使用systemctl restart grafana-server命令读取了/etc/sysconfig/grafana-server中变量；使用/etc/init.d/grafana-server restart重启时，当/etc/sysconfig/grafana-server不存在，则使用/etc/init.d/grafana-server中默认指定的。

调整/etc/sysconfig/grafana-server配置文件

  1. $ grep -v '^$' /etc/sysconfig/grafana-server
  2. GRAFANA_USER=grafana
  3. GRAFANA_GROUP=grafana
  4. GRAFANA_HOME=/usr/share/grafana
  5. LOG_DIR=/var/log/grafana
  6. DATA_DIR=/data/grafana     # 修改数据目录
  7. MAX_OPEN_FILES=10000
  8. CONF_DIR=/etc/grafana 
  9. CONF_FILE=/etc/grafana/grafana.ini
  10. RESTART_ON_UPGRADE=true
  11. PLUGINS_DIR=/data/grafana/plugins    #  修改插件目录
  12. PROVISIONING_CFG_DIR=/etc/grafana/provisioning
  13. # Only used on systemd systems
  14. PID_FILE_DIR=/var/run/grafana

创建所需目录并启动grafana

  1. $ mkdir -p /data/grafana/plugins
  2. $ chown -R grafana.grafana /data/grafana
  3. $ systemctl start grafana-server
  4. $ ss -lnput | grep 8000    # 确定端口在监听
  5. tcp    LISTEN     0      128    [::]:8000               [::]:*                   users:(("grafana-server",pid=7557,fd=9))

浏览器访问8000端口(默认用户名/密码为”admin/admin”):

grafana安装配置详解 - 图1

自行根据提示更改密码后，即可看到以下界面:
grafana安装配置详解 - 图2

配置nginx代理grafana

  1. $ wget -O /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo
  2. $ yum -y install nginx
  3. $ vim /etc/nginx/nginx.conf      # 编辑nginx的server字段如下
  5.     server {
  6.         listen       8082;
  7. # 此处的location匹配的子目录最好和grafana的root_url 指定的一致
  8. # 不一致应该也没关系，下面proxy_pass指定的url后面加 ‘ / ’ 号应该也可以，没试
  9.         location /grafana {   
  10.             proxy_pass http://192.168.20.2:8000;
  11.         }

浏览器访问 http://你的IP:8082/grafana，看到如下界面，表示正常:

grafana安装配置详解 - 图3

升级grafana

仅供参考

  1. #升级前要先备份相关目录
  2. # cp -rp /var/lib/grafana /var/lib/grafana_$(date +%Y%m%d%H%M)
  3. # cp -rp /usr/share/grafana /usr/share/grafana_$(date +%Y%m%d%H%M)
  4. # cp -rp /etc/grafana /etc/grafana_$(date +%Y%m%d%H%M)
  5. 开始升级
  6. # yum -y install https://dl.grafana.com/oss/release/grafana-x.x.x-1.x86_64.rpm
  7. # 安装成功后，根据实际情况，将数据目录更改为升级之前的目录
  9. # 重启，完成升级操作。
  10. # systemctl restart grafana-server

忘记admin密码重置命令

  1. $  grafana-cli admin reset-admin-password pwd@123
  2. INFO[08-28|23:31:05] Connecting to DB                         logger=sqlstore dbtype=sqlite3
  3. INFO[08-28|23:31:05] Starting DB migration                    logger=migrator
  5. Admin password changed successfully ✔

grafana-cli 命令使用注意事项

grafana-cli可以用来安装各种插件以及重置admin密码等操作，但grafana-cli这个命令只是一个脚本而已，建议阅读下此脚本，如下:

  1. $ which grafana-cli
  2. /usr/sbin/grafana-cli
  3. [31::root@lv::~]# >>$ cat /usr/sbin/grafana-cli
  4. #! /usr/bin/env bash
  6. DEFAULT=/etc/default/grafana
  7. GRAFANA_HOME=/usr/share/grafana
  8. CONF_DIR=/etc/grafana
  9. DATA_DIR=/var/lib/grafana
  10. PLUGINS_DIR=/var/lib/grafana/plugins
  11. LOG_DIR=/var/log/grafana
  13. CONF_FILE=$CONF_DIR/grafana.ini
  14. PROVISIONING_CFG_DIR=$CONF_DIR/provisioning
  16. EXECUTABLE=$GRAFANA_HOME/bin/grafana-cli
  17.        ............  # 省略部分内容

可以看到此脚本中也指定了不少目录，所以如果要使用此命令，请将命令中指定的数据、插件等目录，改为和配置文件中一致，否则使用此命令安装插件后，插件所在目录，和配置文件中指定的不一致。

安装插件

在线安装（比较慢）

  1. $ grafana-cli plugins list-remote    # 列出远端所有可安装插件
  2. $ grafana-cli plugins install yeya24-chaosmesh-datasource    # 随便安装一个

离线安装（八仙过海，各显神通吧）

访问官方插件地址如下，就是所有插件:

grafana安装配置详解 - 图4

grafana-cli plugins选项

  1. $ grafana-cli plugins --help 
  2. NAME:
  3.    Grafana CLI plugins - Manage plugins for grafana
  5. USAGE:
  6.    Grafana CLI plugins command [command options] [arguments...]
  8. COMMANDS:
  9.    install                  install <plugin id> <plugin version (optional)>
  10.    list-remote              list remote available plugins
  11.    list-versions            list-versions <plugin id>
  12.    update, upgrade          update <plugin id>
  13.    update-all, upgrade-all  update all your installed plugins
  14.    ls                       list all installed plugins
  15.    uninstall, remove        uninstall <plugin id>
  16.    help, h                  Shows a list of commands or help for one command
  18. OPTIONS:
  19.    --help, -h     show help (default: false)
  20.    --version, -v  print the version (default: false)