Skip to content

Grafana-插件

Grafana 的强大功能很大程度上得益于其丰富的插件生态系统。这些插件能帮你扩展数据源、增加可视化面板类型,甚至集成整个应用。

插件安装与管理

Grafana 提供了多种方式来安装和管理插件。

通过 Grafana CLI 安装(推荐)

bash
# 查看所有远程可用插件
grafana-cli plugins list-remote

# 安装指定插件(例如安装 Zabbix 应用插件)
grafana-cli plugins install alexanderzobnin-zabbix-app

# 安装指定版本的插件
grafana-cli plugins install <plugin-id> <version>

# 列出已安装的插件
grafana-cli plugins ls

# 更新所有已安装插件
grafana-cli plugins update-all

# 卸载插件
grafana-cli plugins remove <plugin-id>

# 完成安装或卸载后,通常需要重启 Grafana 服务才能生效
systemctl restart grafana-server

通过 Web 界面安装

对于一些环境,你也可以在 Grafana 的 Web 界面中管理插件:

  1. 登录 Grafana,导航到 Configuration -> Plugins and data -> Plugins
  2. 你可以查看所有插件(All)或已安装的插件(Installed)。
  3. 找到想要的插件后,点击 Install 即可[citation1]。

通过 ZIP 文件手动安装

在某些无法直接访问互联网的环境中,你可以手动下载和安装插件

  • 官网下载地址:https://grafana.com/grafana/plugins/
  • 将 ZIP 包上传到服务器,并解压到 Grafana 的插件目录(通常是 /var/lib/grafana/plugins
  • 重启 Grafana 服务

热门与实用插件推荐

插件名称类型功能描述
alexanderzobnin-zabbix-app应用插件集成 Zabbix 监控系统,提供现成的仪表盘和模板,用于监控基础设施和应用
grafana-clock-panel面板插件在仪表盘上显示一个可高度自定义的时钟,支持时间、倒计时、计时器等模式
grafana-piechart-panel面板插件提供比内置饼图更高级功能的饼图面板
grafana-kubernetes-app应用插件提供对 Kubernetes 集群的全面监控,包括集群、节点、Pod/容器和部署的仪表板
DevOpsProdigy KubeGraf应用插件提供高级的 Kubernetes 集群监控和可视化,能展示集群中主要服务的指标和特性
Pie Chart面板插件允许在仪表板上创建饼图,可视化不同类型资源(如Pods、Services等)的分布
Status Panel面板插件用于创建状态指示器,显示集群或特定资源的状态(如绿色正常,红色有问题)

Redis 插件

Grafana >=8.0.0

安装插件

bash
# 在线安装
grafana-cli plugins install redis-datasource
# 离线安装
## Github地址
wget https://github.com/RedisGrafana/grafana-redis-datasource/releases/download/v2.2.0/redis-datasource-2.2.0.zip
## Grafana地址
wget https://grafana.com/api/plugins/redis-datasource/versions/2.2.0/download

# 解压
unzip redis-datasource-2.2.0.zip -d /var/lib/grafana/plugins

# 重启
systemctl restart grafana-server

配置数据源

左侧菜单 —> Connections —> Data sources—>Add data source—>搜索Redis点击进入详情—>Install

  1. Name:数据源名称(例如:Redis)。
  2. 填写Address:Redis 服务器的地址和端口:redis://127.0.0.1:6379
  3. 如果 Redis 需要密码,在 Password 字段填写。
  4. 点击 "Save & Test" 测试连接并保存

Zabbix 插件

Grafana >=10.4.8

安装插件

bash
# 在线安装
grafana-cli plugins install alexanderzobnin-zabbix-app

# 离线安装
## Github地址
wget https://github.com/grafana/grafana-zabbix/releases/download/v5.0.1/alexanderzobnin-zabbix-app-5.0.1.linux_amd64.zip
## Grafana官方 
wget https://grafana.com/api/plugins/alexanderzobnin-zabbix-app/versions/5.0.1/download?os=linux&arch=amd64
# 解压
unzip alexanderzobnin-zabbix-app-5.0.1.linux_amd64.zip -d /var/lib/grafana/plugins

# 重启
systemctl restart grafana-server

配置数据源

提前在Zabbix创建API Token

左侧菜单 —> Connections —> Data sources—>Add data source—>搜索Zabbix点击进入详情—>Install

  • Name:默认Zabbix
  • URL:http://192.168.148.104/api_jsonrpc.phpZabbixAPI地址
  • Zabbix Connection:选择API Token
  • Trends:对于查询长时间范围的数据,Grafana 会使用 Zabbix 中的趋势数据(trends),这比查询历史数据(history)要快几个数量级。
  • Cache TTl:缓存存活时间。为了提升性能,可以设置一个较短的时间(如 30s)
  • Direct DB Connection(可选):为了使用某些高级功能(如模板变量),插件可以直接从 Zabbix 的数据库中读取数据。
    • SQL Data source: 选择你的数据库类型,通常是 MySQL/PostgreSQL。
    • SQL Host: Zabbix 数据库的地址和端口,例如 192.168.1.100:3306
    • SQL Database: 数据库名,默认是 zabbix
    • SQL User / SQL Password: 具有只读权限的数据库用户密码(非常重要:不要使用 root 用户!创建一个专用用户)。
  • Save & test

仪表盘展示

在 Grafana 中,点击 Create -> Import—>5363/8677—>数据源选择Zabbix

TencentCloud

安装

bash
# 在线安装
grafana-cli plugins install tencentcloud-monitor-app

# 离线安装
wget https://github.com/TencentCloud/tencentcloud-monitor-grafana-app/releases/download/v2.9.5/tencentcloud-monitor-app-2.9.5.zip
unzip -d tencentcloud-monitor-app-2.9.5.zip /var/lib/grafana/plugins

# 重启服务
systemctl restart grafana-server

配置数据源

鼠标悬浮左侧导航栏的 齿轮 图标,单击 Plugins 选项,进入 Plugins 管理页面,如果插件列表中正常展示 Tencent Cloud Monitor App 插件,表示插件安装成功。

进入应用详情页面,单击 Enable 按钮,启用成功后,即可在 Grafana 中使用腾讯云监控应用插件。

腾讯云监控应用插件通过调用 云监控 API 的方式获取各云产品的监控指标数据,通过以下步骤,配置相应云产品的数据源。

  1. 鼠标悬浮左侧导航栏的 齿轮 图标,单击【Data Sources】选项,进入数据源管理页面;
  2. 单击右上角的【Add data source】按钮,然后单击【Tencent Cloud Monitoring】数据源,进入数据源配置页面;
  3. Name数据源名称,可以是任意名称,默认为Tencent Cloud Monitoring`;
  4. SecretIdSecretKey` 是调用云监控 API 必需的安全证书信息,二者可以通过腾讯云控制台 云 API 密钥页面 获取;
  5. 选择需要获取监控数据的云产品;
  6. 单击【Save & Test】按钮,测试数据源的配置信息是否正确,配置成功后,即可以在 Dashboard 中使用该数据源。

aliyun-log-grafana-datasource-plugin

Grafana 对接阿里云日志服务

参考文档:https://help.aliyun.com/zh/sls/developer-reference/connect-log-service-to-grafana?spm=a2c4g.11186623.help-menu-28958.d_9_6_6.31ff512ebnfwHO&scm=20140722.H_60952._.OR_help-T_cn~zh-V_1

安装插件

bash
wget https://github.com/aliyun/aliyun-log-grafana-datasource-plugin/archive/refs/heads/master.zip
unzip aliyun-log-grafana-datasource-plugin-master.zip -d /var/lib/grafana/plugins

# 修改Grafana配置文件
- 使用YUM或RPM安装的Grafana:/etc/grafana/grafana.ini
- 使用.tar.gz文件安装的Grafana:*{PATH_TO}*/grafana-11.4.0/conf/defaults.ini

# 在配置文件的[plugins] 节点中,设置allow_loading_unsigned_plugins参数。
allow_loading_unsigned_plugins = aliyun-log-service-datasource

# 重启服务
systemctl restart grafana-server

添加数据源

  1. 登录Grafana。

  2. 在左侧菜单栏,选择Connections > Data Sources。

  3. Data Sources页签,单击Add data source

  4. Add data source页面,搜索log-service-datasource。找到后单击log-service-datasource

  5. 在打开的aliyun-log-service-datasource页面,配置以下信息。

    参数说明
    EndpointProject的服务入口,例如http://cn-qingdao.log.aliyuncs.com。请根据实际情况替换服务入口。更多信息,请参见服务接入点
    Project需要对接的日志服务Project的名称。
    AccessKeyIDAccessKey ID用于标识用户,更多信息,请参见访问密钥。建议您遵循最小化原则,按需授予RAM用户必要的权限。关于授权的具体操作,请参见创建RAM用户及授权RAM自定义授权示例
    AccessKeySecretAccessKey Secret是用户用于加密签名字符串和日志服务用来验证签名字符串的密钥,必须保密。
    Name输入数据源的名称。默认为:aliyun-log-service-datasource。
    Default默认打开。
    Default Logstore如果不填写 LogStore, 请确保你的填写的Ak具备当前Project的ListProject权限,
    RoleArn配置STS跳转时需要填写对应RAM角色Arn。
    HTTP headers支持自定义Headers,仅在数据源类型为MetricStore(PromQL)生效。具体配置参考时序存储FormValue配置项:查询加速 。Headers参数说明如下所示:x-sls-parallel-enable:是否开启并发计算,默认关闭。x-sls-parallel-time-piece-interval:按照时间区间进行分片的时间段单元,单位秒。支持的范围为[3600, 86400*30],默认21600(6小时)。x-sls-parallel-time-piece-count:按照时间区间进行分片的分片数,支持1-16,默认8。x-sls-parallel-count:全局并发数,支持2-64,默认8。x-sls-parallel-count-per-host:单机并发数,支持1-8,默认值为2。x-sls-global-cache-enable:是否开启全局缓存,默认关闭。
    Region支持 v4 签名,提供更高的安全性。
  6. 配置完成后,单击Save & Test

添加仪表盘

  1. 在左侧导航栏,单击Dashboards
  2. Dashboards面板中,单击**+ Created dashboard**。然后单击**+ Add visualization**
  3. Select data source页面,选择数据源为aliyun-log-service-datasource
  4. 添加可视化图表。
    • 数据源类型:数据源类型主要是两种语法区别SQL和 PromQL,再加上存储库的类型不同,有四种类型可选:ALL(SQL)Logstore(SQL)MetricStore(SQL)MetricStore(PromQL)
      • 日志库(Logstore)支持SQL查询与分析
      • 时序库(MetricStore)支持SQL + PromQL查询与分析
      • **MetricStore(PromQL)**支持添加custom Headers,具体在该数据源的配置界面进行添加。