插件 〉Redis
Redis
适用于 Grafana 的 Redis 数据源
简介
适用于 Grafana 的 Redis 数据源是一个插件,允许用户连接到任何本地部署和云端的 Redis 数据库。它提供开箱即用的预定义仪表盘,并允许您构建自定义仪表盘来监控 Redis 和应用程序数据。
演示
演示可在以下链接查看:demo.volkovlabs.io
要求
- Redis Data Source 2.X 需要 Grafana 8.0+。
- Redis Data Source 1.X 需要 Grafana 7.1+。
Redis 应用插件
您可以添加任意数量的数据源来支持多个 Redis 数据库。Redis 应用插件有助于管理各种 Redis 数据源并提供自定义面板。
Redis Explorer 插件
Redis Explorer 插件使用 REST API 连接到 Redis Enterprise 软件集群。它提供了应用页面用于添加托管数据库的 Redis 数据源,以及用于查看集群配置的仪表盘。
入门
可以从 Grafana Marketplace 安装 Redis 数据源,或使用 grafana-cli
工具从命令行安装
grafana-cli plugins install redis-datasource
有关 Docker 说明和无网络访问的安装,请参阅快速入门页面。
配置
数据源允许使用 TCP 端口、Unix socket、Cluster、Sentinel 连接到 Redis,并支持 SSL/TLS 认证。有关详细信息,请参阅配置页面。
文档
请参阅文档,了解更多关于插件和功能的信息。
支持的命令
您可以在命令部分找到所有支持的命令列表以及如何使用它们的示例。
开发
开发 Redis 数据源页面提供构建数据源的说明。
您对最新功能和更新感兴趣吗?启动包含 Redis 数据源的 Redis 应用插件夜间构建Docker 镜像。
反馈
我们很高兴听到用户、开发者以及所有对这个插件感兴趣的社区成员的声音。以下是与我们联系的各种方式
- 通过GitHub issues提问、请求新功能和提交错误报告。
- 给仓库加星标,以示支持。
贡献
- Fork 仓库。
- 找一个问题来解决并提交 pull request。
- 找不到问题?寻找文档、错误、拼写错误和缺失的功能。
许可证
- Apache 许可证版本 2.0,请参阅 LICENSE。
在 Grafana Cloud 上安装 Redis
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一次点击;更新也一样。很酷,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
更多信息,请参阅插件安装文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但当有更新可用时,您会在 Grafana 中收到通知。
1. 安装数据源
使用 grafana-cli 工具从命令行安装 Redis
grafana-cli plugins install
插件将安装到您的 grafana plugins 目录;默认路径为 /var/lib/grafana/plugins。更多关于 cli 工具的信息。
2. 配置数据源
从 Grafana 主菜单访问,新安装的数据源可以在数据源部分立即添加。
接下来,点击右上角的“添加数据源”按钮。数据源将可在“类型”下拉框中选择。
要查看已安装的数据源列表,请点击主菜单中的“插件”项。核心数据源和已安装的数据源都会显示。
更新日志
2.2.0 (2023-07-12)
功能 / 改进
- 将 FT.SEARCH 命令添加到数据源 (#297)
- 为 TS.MRANGE 命令添加了 GROUPBY 参数 (#304)
- 升级了 Grafana Go SDK 版本 (#302)
- 为 TS.MRANGE/TS.RANGE 添加了新的聚合器 (#260)
错误修复
- 修复了 JSON.GET 中非字符串标量的问题 (#301)
- 各种安全补丁 (#258, #267, #281, #307)
2.1.2 (2023-06-12)
错误修复
- 修复连接到 Redis 7 集群实例的问题 (#284)
2.1.1 (2022-01-18)
功能 / 改进
- 升级到 Grafana 8.3.4
2.1.0 (2022-01-17)
功能 / 改进
- 升级到 Grafana 8.2.5 (#237)
- 升级到 Grafana 8.3.0 (#244)
- 更新组件命名 (#247)
- 将 RedisGears PYEXECUTE 函数添加到查询编辑器 (#248)
- 将 Grafana Marketplace 添加到 README (#249)
- 更新 follows-redirect 包 (#253)
错误修复
- Grafana 模板变量对默认数据源不起作用 (#242)
- 修复 JSON.GET:接口转换:interface {} 是 string (#246)
2.0.0 (2021-11-10)
重大变更
- 支持 Grafana 8.0+,对于 Grafana 7.X 请使用版本 1.5.0
- 如果在未指定 Start/End 的情况下,XRANGE 命令基于选定的时间范围。使用 '-' 作为 Start 和 '+' 作为 End 来显示所有结果。
功能 / 改进
- 升级到 Grafana 8.0.6 (#212)
- 允许每个面板执行多个流式查询 (#213)
- 更新 Grafana SDK 0.110 (#214)
- 更新到 Grafana 8.1.4 (#217)
- 更新到 Grafana 8.2.1 (#220)
- 更新到 Grafana 8.2.2 (#223)
- 使用时间范围进行 XRANGE 过滤 (#176)
- 在查询编辑器中禁用命令行接口 (#226)
- 支持 ZRANGE 命令 (#182)
- 升级 Grafana 8.2.3 和后端依赖项 (#228)
- 支持从 RedisJSON 数据源获取数据(JSON.GET, JSON.TYPE, JSON.ARRLEN, JSON.OBJLEN, JSON.OBJKEYS)(#229)
- Redis Enterprise 在 commandstats 中引入了新的字段 calls_master (#232)
错误修复
- 修复当 Requirement 未下载导致 wheels 不可用时 RedisGears rg.dumpreqs 命令的问题 (#219)
- SCARD 不再显示 key 字段 (#233)
1.5.0 (2021-07-06)
重大变更
- HGET 返回的字段值名称与请求的字段名称一致,而不是类似于 HMGET 和 HGETALL 的“Value”。
- 流式字段
time
从前端移至后端。字段名称重命名为“#time”,以避免与返回字段混淆。
功能 / 改进
- 将 Redis Explorer 添加到 README 并进行少量 docker 更新 (#195)
- Grafana-Redis-Datasource 的警报 #166
- 添加对独立于 Redis 的 Sentinel ACL 用户和密码认证的支持 #197
- 添加对 RedisGraph 查询节点计数的支持 (#199)
- 添加 GRAPH.EXPLAIN 和 GRAPH.PROFILE 命令 (#200)
- 添加 GRAPH.CONFIG 并重构 RedisGraph (#201)
- 重构 RedisTimeSeries 和 RedisGears 命令 (#202)
- 升级 Grafana 7.5.7 和后端依赖项 (#203)
- 为 v8 添加流式仪表盘并更新 #time 流式字段 (#204)
- 添加 TS.MGET 命令 (#209)
- 重构 Redis 命令 (#210)
错误修复
- 修复变量的 NaN 问题 (#206)
1.4.0 (2021-05-08)
功能 / 改进
- 更新 Grafana SDK 0.88 和其他后端依赖项 (#170)
- 为 Streams XRANGE 添加 $time 字段 (#175)
- 添加 RG.PYDUMPREQS 命令并修复集成测试 (#183)
- 将集成测试添加到 CI (#184)
- 升级 Grafana 依赖项到 7.5.4 (#185)
- 更新仪表盘到 7.5.4 并添加数据源变量 (#186)
- 更新后端依赖项并解决 linting 问题 (#187)
- 更新文档 (#188)
错误修复
- TLS 客户端证书不起作用 (#177)
1.3.1 (2021-02-04)
功能 / 改进
- 为 Golang 后端添加单元测试 #119
- 从自定义面板的响应中移除“未知命令”错误 #125
- 更新 Radix 到 3.7.0 和其他后端依赖项 #128
- Redis 客户端、单元测试重构和新的单元测试。#129
- 实现类似于 Redis-cli 的 CLI 模式 #135
- 添加了对 Redis 6.2 中 errorstats 功能的支持;扩展了 commandstats 字段,包含 failedCalls 和 rejectedCalls #137
- 添加命令以支持面板显示最大的键 (TMSCAN) #133
- 添加 RedisGears 命令 (RG.PYSTATS, RG.DUMPREGISTRATIONS, RG.PYEXECUTE) #136
- 实现 XRANGE 和 XREVRANGE 命令 #148
- 添加客户端类型工具提示 #149
- 重构查询编辑器 #151
- 添加处理流式数据源不同帧类型的能力 #152
- 更新 RedisTimeSeries 标签过滤器工具提示 #155
- 更新 Grafana 7.4 流式加载状态 #158
- 更新 Grafana SDK 0.86 以修复竞争条件 #160
- 添加 Redis Graph 模块 (GRAPH.QUERY, GRAPH.SLOWLOG) #157
错误修复
- Grafana docker 似乎因该插件而出现内存泄漏 #116
- 当其中一个 Redis 数据源不可达时,所有数据源都超时 #73
1.3.0 (2021-01-05)
重大变更
- HGETALL 返回类似于 HGET、HMGET 的哈希字段行,以支持流式传输。以前每个哈希字段都作为一行返回。
- RedisTimeSeries TS.RANGE 和 TS.MRANGE 的时间桶已从字符串更新为整数。要修复仪表盘 JSON
- 搜索
"bucket"="X"
- 移除引号
- 搜索
- RedisTimeSeries TS.RANGE 命令已更新,具有类似于 TS.MRANGE 的图例和值覆盖。以前的
legend
定义了字段名称。 - GET, HGET, SMEMBERS 等命令的
key
参数已更新为keyName
以避免冲突。要修复仪表盘 JSON- 搜索
"key"="X"
- 替换为
"keyName"="X"
- 搜索
功能 / 改进
- 更新描述和 GitHub issues #83
- 添加 RediSearch FT.INFO 命令 #97
- 添加 HMGET 命令 #98
- 更新发布工作流 #99
- 更新 Grafana 依赖项到 7.3.5 #100
- 更新 Grafana SDK 0.80.0 #101
- 更新数据源图标并重构 #102
- 更新 HGET 命令的字段名称以与 HMGET 对齐 #103
- 更新 HGETALL 命令以返回字段并支持类似于 HGET, HMGET 的流式传输 #104
- 为 React 配置和查询编辑器添加测试 #105
- 移除 CircleCI 并迁移到 Github Actions #106
- 更新 Bucket 类型 (string->number) 并为聚合和信息部分添加类型值 #108
- 为 React 数据源添加测试 #113
- 在查询编辑器中将 Bucket 更新为 Time Bucket #114
- 在流式传输时检查字符串值是否为数字 #115
- 添加测试覆盖率 #117
- 在没有返回值时添加空数组,类似于 redis-cli #120, #121
- 为后端测试添加测试数据 #122
错误修复
- 修复 sentinel 出现的“NOAUTH Authentication required”错误 #109
- 为 TS.RANGE 命令添加类似于 TS.MRANGE 的 Value Label #110
- 更新数据源的默认配置参数 #111
- 将 Key 更新为 KeyName 以避免在 Explore 标签页中发生冲突 #112
1.2.1 (2020-10-24)
功能 / 改进
- 支持通过 Unix Socket 连接到 Redis #58
- 支持 Redis 6 ACL 认证 #60
- 更新 Grafana 依赖项到 7.2.0 #66
- 更新并优化适用于 Grafana 7.2.0 的仪表盘 #67
- 为命令统计信息添加流式传输 #68
- 为 SLOWLOG GET 添加 Size 参数 #79
- 将 GitHub 组织更新为 RedisGrafana #80
错误修复
- Linux ARM 上的插件健康检查失败 #61
- 时间序列数据时间戳被截断为秒 #64
1.2.0 (2020-08-26)
功能 / 改进
- 在 README 中添加了 docker 命令行启动选项 #31
- 如何在同一个 Redis 单节点中查询特定数据库 #34
- 更新 docker-compose 以从仓库加载数据源并添加开发文件 #39
- 应用模板变量时使用“ScopedVars” #37 (修复 #36)
- 重构以支持新命令和模块 #42
- 添加对 TS.GET、TS.INFO 和 TS.QUERYINDEX 命令的支持 #45
- 添加 Redis 仪表盘以支持多个 Redis 实例 #49
- arm64 架构缺少插件可执行文件 #48 (Grafana SDK: https://github.com/grafana/grafana-plugin-sdk-go/pull/221)
- 对于时间序列
TS.RANGE
查询中计数为 0 的所有时间桶返回 0 #50 - 添加 Redis Cluster 支持并更新监控仪表盘 #52
- 连接部署在 Kubernetes (Sentinel) 中的 Redis 问题 #38
- MRANGE:添加填充零选项 #53
- 添加流式功能以可视化 INFO 命令 #57
错误修复
- 对于 Redis 3.0.6,Slowlog 返回“无数据” #33
- 修复后端 lint 问题 #41
- 当标签内有空格时,ts.mrange 不返回数据 #44
1.1.2 (2020-07-29)
功能 / 改进
- 从 README 中移除开发者术语 #30
- Redis 数据源未签名。K8S+Helm 安装 #29
1.1.1 (2020-07-28)
功能 / 改进
- 将截图添加到 plugin.json 并在 README 中更新
- 添加 CHANGELOG 以在插件页面显示
1.1.0 (2020-07-24)
功能 / 改进
- 更新到 Grafana 7.1.0 和最新版 Radix #27
- 将仪表盘作为数据源的一部分添加 #25
- 向响应添加 Field config units #26
1.0.0 (2020-07-13)
功能 / 改进
- 基于 Grafana 7.0.5 的初始版本。
- 允许配置密码、TLS 和高级设置。
- 支持 Redis 命令:CLIENT LIST, GET, HGET, HGETALL, HKEYS, HLEN, INFO, LLEN, SCARD, SLOWLOG GET, SMEMBERS, TTL, TYPE, XLEN。
- 支持 RedisTimeSeries 命令:TS.MRANGE, TS.RANGE。
- 提供 Redis 监控仪表盘。