插件〉Infinity

数据源

grafana

Infinity

文档 →

概览
安装
更新日志
相关内容
文档 →

Grafana Infinity 数据源

可视化来自 JSON, CSV, XML, GraphQL 和 HTML 端点的数据。

文档

详细文档和示例可在插件网站中找到

关于如何使用 JSON API 的文档 - 文档

演示视频

已知限制

后端功能，例如警报、记录的查询、企业查询缓存、公开仪表盘，只有在查询中选择了 backend 解析器选项时才可用。

在 Grafana Cloud 上安装 Infinity

欲了解更多信息，请访问关于插件安装的文档。

更新日志

3.2.1

🎉 新功能：支持 Azure 美国政府云和 Azure 中国云类型，并带有 Azure blob 存储账户认证

🚀 改进：改进健康检查错误处理

🐛 Bug 修复：修复设置全局查询时出错的问题

🐛 Bug 修复：修复确定 dataframe 类型时出现的错误（以前在结果只有一行时会导致警报和记录的查询出现问题）

⚙️ 日常维护：更新了 TlsConfigEditor 中已废弃的旧组件和工具类

⚙️ 日常维护：更新了过时的依赖项

⚙️ 日常维护：替换绝对导入为使用别名导入

3.2.0

🚀 新功能：在 infinityRunQueriesInParallel 功能标志后添加并发查询执行支持

🐛 Bug 修复：移除配置编辑器中的 props 变异

3.1.0

🚀 新功能：通过 grafana 配置（ini 文件）设置后端分页最大页面大小

🐛 Bug 修复：修复 3.0.0 之前创建的查询的默认解析器

🐛 Bug 修复：修复分页输入字段的最小值

3.0.0

🚀 新功能：通过数据源配置 allowDangerousHTTPMethods 支持额外的 HTTP 方法（PATCH、PUT 和 DELETE）

🚀 新功能：通过数据源设置支持将 grafana 元数据（如用户 ID、数据源 UID）作为请求头/查询参数传递到底层 API

🚀 改进：将后端解析器设置为新查询的默认解析器。使用前端解析器的现有查询应像以前一样工作。如果出现问题，将解析器设置为 Frontend 可能有助于解决。

🚀 改进：默认添加了对外请求的 gzip 压缩支持。修复了 #1003

🚀 改进：为符合 dataplane 的数字数据 frame 添加了 frame 类型。这将有助于我们在警报、记录的查询、SSE 等中正确处理结果。

🎉 日常维护：重大变更：插件现在需要 Grafana 10.4.8 或更高版本

3.0.0-beta.2

🚀 新功能：通过数据源配置 allowDangerousHTTPMethods 支持额外的 HTTP 方法（PATCH、PUT 和 DELETE）

🚀 改进：将后端解析器设置为新查询的默认解析器。使用前端解析器的现有查询应像以前一样工作。如果出现问题，将解析器设置为 Frontend 可能有助于解决。⚙️ 日常维护：更新前端和后端依赖项

3.0.0-beta.1

🚀 新功能：通过数据源设置支持将 grafana 元数据（如用户 ID、数据源 UID）作为请求头/查询参数传递到底层 API

🚀 改进：默认添加了对外请求的 gzip 压缩支持。修复了 #1003

🚀 改进：为符合 dataplane 的数字数据 frame 添加了 frame 类型。这将有助于我们在警报、记录的查询、SSE 等中正确处理结果。

🎉 日常维护：重大变更：插件现在需要 Grafana 10.4.8 或更高版本

2.12.2

🐛 构建和发布管道使用最新的 go lang 版本 1.23.5，其中包含对 crypto/x509 和 net/http 包的安全修复（CVE-2024-45341 和 CVE-2024-45336）。更多详细信息可在此处找到此处

🐛 Bug 修复：修复无效查询的错误源

⚙️ 日常维护：将后端插件 SDK github.com/grafana/grafana-plugin-sdk-go 从 0.261.0 更新到 0.263.0

2.12.1

⚙️ 日常维护：将 cross-spawn 更新到 7.0.6

2.12.0

🚀 改进：将追踪注入 req.head (#1088)

⚙️ 日常维护：将 nanoid 从 3.3.7 更新到 3.3.8

⚙️ 日常维护：将后端插件 SDK github.com/grafana/grafana-plugin-sdk-go 从 0.259.0 更新到 0.261.0

🐛 Bug 修复：修复文本区域的高度

2.11.4

🐛 Bug 修复：修复无效查询的错误源

🐛 Bug 修复：修复了查询中没有 url 时，base url 未按预期工作的问题。修复了 #908

⚙️ 日常维护：迁移全局查询编辑器中的旧表单组件

2.11.3

🐛 Bug 修复：修复准备请求时抛出 panic 的问题

🐛 Bug 修复：修复了 gitlab url 规范化不正确的问题

⚙️ 日常维护：将 jsonpath-plus 更新到 10.2.0

2.11.2

⚙️ 日常维护：将后端插件 SDK github.com/grafana/grafana-plugin-sdk-go 从 0.255.0 更新到 0.258.0

⚙️ 日常维护：将前端依赖项 jsonpath-plus 从 10.0.1 更新到 10.1.0

⚙️ 日常维护：将前端间接依赖项 uplot 更新到 1.6.31

2.11.1

🐛 Bug 修复：修复 ErrExpressionNotFoundInFields 和 ErrInvalidFilterExpression 的下游错误

⚙️ 日常维护：将 github.com/grafana/grafana-plugin-sdk-go 版本提升至 0.255.0 (从 0.248.0)

⚙️ 日常维护：将 jsonpath-plus 版本提升至 10.0.1

2.11.0

🚀 改进：移除 base URL 弃用

🐛 Bug 修复：修复 x-id-token 请求头的 forward oauth 问题

2.10.0

🚀 改进：移除 base URL 弃用并将其移至 URL、Headers 和 Params

🐛 Bug 修复：修复已识别下游错误的错误源

⚙️ 日常维护：将 github.com/grafana/grafana-plugin-sdk-go 版本提升至 0.248.0 (从 0.241.0)

⚙️ 日常维护：将 path-to-regexp 版本提升至 1.9.0 (从 1.8.0)

2.9.6

🐛 Bug 修复：修复无效 JSONata 错误的错误源

⚙️ 日常维护：将 github.com/grafana/grafana-plugin-sdk-go 版本提升至 0.245.0 (从 0.241.0)

⚙️ 日常维护：将非错误日志行的级别从 error 更新为 debug

⚙️ 日常维护：将 webpack 版本提升至 5.94.0 (从 5.86.0)

⚙️ 日常维护：将 micromatch 版本提升至 4.0.8 (从 4.0.7)

2.9.5

⚙️ 日常维护：Rudderstack 事件触发已更新

2.9.4

🐛 Bug 修复：修复查询取消问题

⚙️ 日常维护：添加 vscode 调试器配置

2.9.3

🐛 日常维护：更新了错误源捕获

2.9.2

🚀 日常维护：日志记录改进

2.9.1

🚀 日常维护：将 grafana-plugin-sdk-go 从 v0.239.0 升级到 v0.240.0

2.9.0

🚀 UQL：将 uql 库更新到 0.0.23

🚀 日常维护 将后端 framer 库从 yesoreyeram/grafana-plugins 替换为 grafana/infinity-libs

⚙️ 日常维护：将错误源添加到错误响应中

⚙️ 日常维护：将 grafana-plugin-sdk-go 从 v0.231.0 升级到 v0.239.0

🐛 Bug 修复：修复使用查询历史时显示正确 URL 的问题

2.8.0

⚙️ 日常维护：后端 datasource.serve 方法迁移到 datasource.manage 方法

🐛 Bug 修复：修复变量编辑器中过滤器不工作的问题

2.7.1

🚀 时间宏：添加了自定义时间宏 ${__timeFrom} 和 ${__timeTo}。在此处阅读更多相关信息此处。

2.7.0

🚀 URL 参数编码：添加支持在 URL 中使用 %20 编码空格字符而不是 +。（实验性功能）

🚀 功能：后端 summarize 选项的别名支持

🐛 变量编辑器：修复变量编辑器中列选择器不工作的问题

⚙️ 日常维护：后端二进制文件现已使用 golang 1.22.3 编译

2.6.3

🐛 日常维护 更新依赖项

2.6.2

🚀 安全仪表盘中阻止/允许/警告敏感查询的新设置。在此处阅读更多相关信息文档。

2.6.1

🐛 日常维护 UQL 依赖项已从 0.0.21 更新到 0.0.22

📜 文档文档网站更新，包含 play.grafana 链接

2.6.0

⚙️ 日常维护：将 grafana-plugin-sdk-go 升级到 v0.220.0

🚀 改进：改进了 Azure blob 存储连接的健康检查

🚀 功能：支持 Azure blob 存储容器和 blob 名称中的变量

🐛 Bug 修复：修复了自 2.5.0-beta.1 版本以来 AWS 认证不工作的问题

2.5.0

🚀 PDC：添加了对 grafana 私有数据源连接 (PDC) 的支持

🛡️ 安全后端二进制文件使用 go 1.22.1 编译，其中包含之前版本的安全补丁

⚙️ 依赖项更新：NodeJS 开发依赖项从 Node 18 更新到 Node 20

⚙️ 依赖项更新：更新了后端依赖项和插件 SDK

⚙️ 日常维护：将 gorilla mux 库替换为标准库中的 http.ServeMux

⚙️ 日常维护：移除未使用的 graphql 和 open-api 资源调用

2.5.0-beta.1

🚀 日常维护：更新了健康检查消息，包含自定义健康检查设置的详细信息

🚀 认证：将摘要认证后端 SDK 从 github.com/xinsnake/go-http-digest-auth-client 更新到 github.com/icholy/digest

🐛 分析：更新了 rudderstack 分析事件

🐛 Bug 修复：修复了启用沙盒时查询列编辑器无法使用的问题

⚙️ 日常维护：将 grafana 插件 SDK 从 v0.197.0 更新到 v0.206.0

2.4.0

🚀 日常维护：最低支持的 grafana 版本更新到 9.5.15

🚀 变量：在后端解析器根选择器中添加了对变量的支持

🐛 变量：改进了变量查询多于 1 列时的变量处理支持

🐛 Bug 修复：修复了嵌套变量查询未传递变量值的问题

⚙️ 日常维护：将 grafana 插件 SDK 从 v0.193.0 更新到 v0.197.0

⚙️ 日常维护：插件构建系统从 @grafana/toolkit 迁移到 @grafana/create-plugin

⚙️ 日常维护：NodeJS 开发依赖项从 Node 16 更新到 Node 18

2.3.1

⚙️ 日常维护：更新了后端依赖项

⚙️ 日常维护：使用 Grafana Labs 签名而不是 Community 签名对插件进行签名

⚙️ 日常维护：通过 drone ci 构建和发布，而不是 github actions

2.3.0

🎉 Infinity 数据源插件现已由 Grafana Labs 正式维护。在此处阅读更多相关信息博客文章

2.2.1

⚙️ 日常维护：添加了分布式追踪和情境化日志记录

🐛 UI 移除 graphql 变量编辑器样式

2.2.0

🚀 代理：支持配置每个数据源的代理 URL

🚀 GraphQL：添加了对 GraphQL 变量的支持

🐛 OAuth2：修复 OAuth2 配置 UI 崩溃问题

2.1.0

🚀 OAuth2：添加了在客户端凭据中设置认证样式的功能

🚀 Azure blob 存储：支持从 Azure Blob Storage 读取内容

🚀 日志：添加了对以 logs 格式可视化数据的支持

🚀 追踪：添加了对以 trace 格式可视化数据的支持

🚀 宏：在使用后端解析器时，在计算列和过滤器表达式中添加了对宏的支持

🚀 URL：添加了对 gitlab blob 到原始 URL 转换的支持

🚀 URL：添加了对 bitbucket blob 到原始 URL 转换的支持

🚀 解析器：在默认解析器和后端解析器中添加了对显式布尔值解析的支持

🚀 配置编辑器：在某些认证类型中添加了预览 / 示例请求

🛡️ 安全：后端二进制文件使用 golang 1.21.3 编译，其中包含之前版本的安全修复

🐛 UI：修复了查询编辑器中按钮渲染不正确的问题

🐛 OAuth2：应用了一个修复，解决在配置编辑器中编辑 OAuth2 部分时 UI 崩溃的问题

🐛 URL 规范化：修复了某些 github URL 插值不正确的问题。修复了 #604

🐛 测试：修复了测试中的一个 bug

🐛 文档：移除了文档网站中 Cmd/Ctrl+F 键绑定，转而使用原生浏览器搜索

⚙️ 日常维护：Grafana 插件 SDK grafana/grafana-plugin-sdk-go 已从 v0.189.0 更新到 v0.174.0

⚙️ 日常维护：更新了后端包

⚙️ 测试添加了更多测试数据/示例

2.0.0

🎉 分页：添加了对 json 类型查询的分页支持（后端解析器）。有关详细信息，请参阅此 github 讨论

🎉 转换：添加了通过 transformations 查询类型进行服务器端转换的支持。此版本支持诸如 limit、filterExpression、computedColumn 和 summarize 的转换。有关详细信息，请参阅此 github 讨论

🚀 健康检查：添加了对自定义健康检查的支持

🚀 配置编辑器：更新了配置编辑器 UI

🐛 日志记录：更新了后端日志记录以改进调试体验

🐛 文档：更新了关于 user agent 请求头的文档

🐛 日志记录：从 @grafana/runtime 库消费 reportInteraction 以报告查询

⚙️ 日常维护：将 changeset 添加到构建/发布管道

⚙️ 日常维护：将 grafana 后端插件 SDK 从 v0.159.0 更新到 v0.162.0

⚙️ 日常维护：后端二进制文件现已使用 Go 1.20.4 编译，其中包含安全补丁

[ 1.4.1 ]

UQL 在 UQL 中添加了对 pivot 函数的支持
日常维护 后端二进制文件现已使用 Go 1.20.3 编译，其中包含安全补丁
日常维护 更新了前端依赖项，包括安全补丁

[ 1.4.0 ]

变量支持变量中的自定义显示值（使用 __text 和 __value 作为字段名）
后端解析器 添加了对数字日期时间的支持（例如：20221227 现在可以使用 YYYYMMDD 格式被视为有效日期时间）
全局变量 在后端查询中支持全局时间变量 ${__from} 和 ${__to}
Bug 修复 修复了 xml/html 后端查询未插值变量的问题一个 bug。
Bug 修复 修复了 BOM 编码的响应未正确解析的问题一个 bug。
认证健康检查验证已更新
文档文档网站 UI 更新

[ 1.3.0 ]

认证添加了使用 AWS Access 和 AWS Secret key 的 AWS 认证支持
UQL 支持新的方法 atob、btoa 和 substring
日常维护 后端二进制文件现已使用 Go 1.19.5 编译

[ 1.2.0 ]

XML 支持后端解析器（警报、记录的查询、公开仪表盘等）
HTML 支持后端解析器（警报、记录的查询、公开仪表盘等）
内联支持全局添加和查询参考数据，作为内联数据的替代方案
安全后端二进制文件现已使用最新的 GoLang 版本 1.19.3 编译，该版本修复了 CVE-2022-41716
后端解析器 后端解析器中的根数据选择器现在支持 JSONata
日常维护 Grafana 后端插件 SDK 已更新到最新版本
日常维护 E2E 测试已更新

[ 1.1.0 ]

计算字段 后端解析器现在支持计算字段（beta）
过滤后端解析器现在支持数据过滤（beta）
汇总后端解析器现在支持汇总为数字、字符串和二进制字段（beta）
GraphQL 支持后端解析器（警报、记录的查询、公开仪表盘等）
GraphQL 支持 GROQ 解析器
CSV/TSV 支持后端解析器（警报、记录的查询、公开仪表盘等）
认证支持 Google JWT Token 认证（通过引导式认证提供商）
内联数据 支持导入本地文件作为内联数据（实验性）
Google Sheets 支持从 Google Sheets 查询数据（beta）
UX 重新组织了查询字段。URL 选项，如请求头、请求体、参数，已移至独立部分
帮助简化了内联帮助页面
演示由于 heroku 的定价变更，移除了演示实例。（后续会寻找替代方案）
日常维护 移除了未使用的 metrics 资源处理程序

[ 1.0.1 ]

宏/变量 查询中的全局变量，如 ${__user.name}、${__user.email} 和 ${__user.login}，在服务器端正确插值
Bug 修复 修复了变量编辑器中使用 POST 方法时编辑器崩溃的问题。修复了 #413

[ 1.0.0 ]

新功能与 Bug 修复

新查询类型：JSON 后端（支持警报）（beta）
新认证类型：支持 Digest 认证
新宏：在 URL、Body、Inline data、UQL 查询中添加了对宏的支持（$__combineValues(), $__customInterval()）
新变量查询类型：从给定字符串数组中生成随机字符串
URL：支持更多请求体类型。（包括 raw、form-data、x-www-form-urlencoded）
UQL：添加了新的根级别命令 where 以支持基本过滤
UQL：添加了新的方法 extract 以使用正则表达式提取字符串的一部分
UQL：新的汇总方法 countif, sumif, minif 和 maxif
UQL：新的方法 percentage, split, replace_string, reverse, pack, array_to_map 和 array_from_entries
原样：使用 As-Is 格式和 JSON 时支持 URL
UX：从仪表盘导航到探索页面时，查询中的变量会插值
日常维护：更新了 cypress 并提高了 E2E 测试覆盖率
日常维护：添加了 prometheus metrics 资源端点（实验性）

重大变更

认证与允许的主机 URL

如果您正在使用任何需要认证的 API/URL，您现在需要在配置中指定允许的主机 URL 列表。引入此变更旨在为您的端点提供额外的安全性。

要迁移现有数据源，请在数据源配置部分添加允许的 URL/允许的主机。例如：如果您正在使用需要认证的 https://foo.com/some/path?id=123，您需要在允许的主机列表中添加 https://foo.com。

如果您的数据源是预配置的，那么您必须将以下内容添加到您的预配置 yaml 文件中。

jsonData:
  allowedHosts:
    - https://foo.com

如果允许的主机未正确配置，在执行查询时您将收到 Datasource is missing allowed hosts/URLs. Configure it in the datasource settings page. 错误。

在此处了解有关此重大变更的更多信息 github 讨论

Content-Type 和 Accept 请求头

Content-Type 和 Accept 请求头的默认值正在改变。这些请求头的默认值设置如下

对于 json 和 graphql 类型，Accept 现在将设置为 application/json;q=0.9,text/plain
对于 csv 查询类型，Accept 请求头现在将设置为 text/csv; charset=utf-8
对于 xml 查询类型，Accept 请求头现在将设置为 text/xml;q=0.9,text/plain
对于 http post 方法，Content-Type 请求头值将为 json 和 graphql 查询类型设置为 Content-Type

您可以在设置/查询请求头中覆盖这些请求头。

最低 Grafana 版本更新

Infinity 插件所需的最低 Grafana 版本现在是 Grafana v8.4.7。虽然旧版本预计可以工作，但可能存在一些小的意外问题。

[ 0.8.8 ]

UQL：新的命令 jsonata，可帮助对 json, xml, csv API 执行 JSONata 查询
日常维护：在后端为失败场景添加了更多日志记录
日常维护：数据源配置页面添加了预配置帮助程序，提供用于预配置的数据源 yaml

[ 0.8.7 ]

UQL：新的命令 distinct
UQL：新的函数 kv，从对象提供 kv 对数组。（在结果是键值格式时很有用）
UQL：新的数学函数（floor/ceil/round/sign/pow/sin/cos/tan/log/log2/log10）
Bug 修复：修复了 API 错误导致段违规错误的问题 (#299)
Bug 修复：修复了在使用高于 8.3.4 版本的 grafana 时 UQL 编辑器有时会抛出错误的问题
Bug 修复：修复了字符串中的负数被转换为正数的问题 (#297)