插件 〉Redis
Redis
Grafana 的 Redis 数据源
简介
Grafana 的 Redis 数据源是一个插件,允许用户连接到任何本地和云端的 Redis 数据库。它提供开箱即用的预定义仪表盘,并允许您构建自定义仪表盘来监控 Redis 和应用程序数据。
演示
演示可在 demo.volkovlabs.io 上获取
要求
- Redis 数据源 2.X 需要 Grafana 8.0+。
- Redis 数据源 1.X 需要 Grafana 7.1+。
Redis 应用程序插件
您可以添加任意数量的数据源以支持多个 Redis 数据库。 Redis 应用程序插件 有助于管理各种 Redis 数据源并提供自定义面板。
Redis Explorer 插件
Redis Explorer 插件 使用 REST API 连接到 Redis Enterprise 软件集群。它提供应用程序页面以添加托管数据库的 Redis 数据源和仪表盘以查看集群配置。
入门
Redis 数据源可以从 Grafana 市场安装,也可以使用 grafana-cli
工具从命令行安装
grafana-cli plugins install redis-datasource
有关 Docker 指令和在没有互联网访问权限的情况下进行安装,请参阅 快速入门 页面。
配置
数据源允许使用 TCP 端口、Unix 套接字、集群、哨兵连接到 Redis,并支持 SSL/TLS 身份验证。有关详细信息,请参阅 配置 页面。
文档
请参阅 文档 了解有关插件和功能的更多信息。
支持的命令
您可以在 命令 部分找到所有支持的命令列表以及如何使用它们以及示例。
开发
开发 Redis 数据源 页面提供了有关构建数据源的说明。
您是否对最新功能和更新感兴趣?开始使用 nightly 构建的 Redis 应用程序插件的 Docker 镜像,包括 Redis 数据源。
反馈
我们乐于倾听用户、开发人员和整个社区对该插件的意见。以下是一些与我们联系的方式
- 通过 GitHub 问题 提出问题、请求新功能和提交错误。
- 为存储库加星标以表示您的支持。
贡献
- 派生存储库。
- 找到要处理的问题并提交拉取请求。
- 找不到问题?查找文档、错误、错别字和缺少的功能。
许可证
- 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 插件目录中;默认目录为 /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 添加到自述文件 (#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
- 如果未指定开始/结束时间,则基于所选时间范围的 XRANGE 命令。使用 '-' 作为开始时间和 '+' 作为结束时间以显示所有结果。
功能/增强功能
- 升级到 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 尚未下载时 RedisGears rg.dumpreqs 命令,因此轮子不可用 (#219)
- SCARD 不再显示键字段 (#233)
1.5.0 (2021-07-06)
重大更改
- HGET 返回字段,其值命名为请求的字段,而不是“Value”,类似于 HMGET 和 HGETALL。
- 流字段
time
已从前端移动到后端。字段名称重命名为 "#time" 以避免与返回的字段混淆。
功能/增强功能
- 将 Redis Explorer 添加到自述文件以及轻微的 docker 更新 (#195)
- Grafana-Redis-Datasource 的警报 #166
- 添加对 Sentinel ACL 用户和密码身份验证的支持,与 Redis 分开 #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 功能的支持;使用 failedCalls 和 rejectedCalls 扩展了 commandstats 字段 #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.QUERY、GRAPH.SLOWLOG) #157
错误修复
- 在 Grafana docker 中遇到内存泄漏,似乎源于此插件 #116
- 当一个 Redis 数据源不可访问时,所有 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 问题 #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
- 更新桶的类型 (string->number) 并为聚合和信息部分添加类型值 #108
- 为 React 数据源添加测试 #113
- 在查询编辑器中将桶更新为时间桶 #114
- 在流式传输时检查字符串值是否为数字 #115
- 添加测试覆盖率 #117
- 在没有返回值时添加空数组,类似于 redis-cli #120、#121
- 添加用于后端测试的测试数据 #122
错误修复
- 修复了 sentinel 的“NOAUTH 身份验证需要”错误 #109
- 为 TS.RANGE 命令添加值标签,类似于 TS.MRANGE #110
- 更新数据源的默认配置参数 #111
- 将键更新为 KeyName 以避免在“探索”选项卡中发生冲突 #112
1.2.1 (2020-10-24)
功能/增强功能
- 支持通过 Unix 套接字连接到 Redis #58
- 支持 Redis 6 ACL 身份验证 #60
- 将 Grafana 依赖项更新到 7.2.0 #66
- 更新和优化 Grafana 7.2.0 的仪表板 #67
- 为命令统计添加流 #68
- 为 SLOWLOG GET 添加大小参数 #79
- 将 GitHub 组织更新为 RedisGrafana #80
错误修复
- Linux 上 ARM 的插件健康检查失败 #61
- 时间序列数据时间戳截断到秒 #64
1.2.0 (2020-08-26)
功能/增强功能
- 在自述文件中添加了 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 集群支持并更新监控仪表板 #52
- 连接到 Kubernetes 中部署的 Redis (Sentinel) 出现问题 #38
- MRANGE:添加填充零选项 #53
- 添加流功能以可视化 INFO 命令 #57
错误修复
- Slowlog 返回 Redis 3.0.6 的“无数据” #33
- 修复后端 lint 问题 #41
- 当标签中有空格时,ts.mrange 返回无数据 #44
1.1.2 (2020-07-29)
功能/增强功能
- 从自述文件中删除开发术语 #30
- Redis 数据源未签名。K8S+Helm 安装 #29
1.1.1 (2020-07-28)
功能/增强功能
- 将屏幕截图添加到 plugin.json 并更新到自述文件
- 将 CHANGELOG 添加到插件页面上显示
1.1.0 (2020-07-24)
功能/增强功能
- 更新到 Grafana 7.1.0 和最新版本的 Radix #27
- 将仪表板作为数据源的一部分添加 #25
- 将字段配置单元添加到响应 #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 监控仪表板。