插件〉VictoriaLogs

数据源

商业版

VictoriaLogs

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

Grafana 的 VictoriaLogs 数据源

VictoriaLogs Grafana 插件允许 Grafana 查询、可视化和与 VictoriaLogs（一个高性能日志存储和处理系统）进行交互。

功能

使用 LogsQL 过滤、聚合和转换日志数据，以获取应用行为的洞察。
在 Grafana 中使用 Explore 模式。
显示实时日志流。
构建仪表盘和设置警报。
使用 Ad Hoc 过滤器。

在 VictoriaMetrics playground 试用吧！

安装

有关如何在 Grafana Cloud 或本地安装插件的详细说明，请查阅插件安装文档。

通过 UI 手动配置

在 Grafana 实例上安装插件后，请按照这些说明添加新的 VictoriaLogs 数据源，并输入配置选项。

通过文件配置

Grafana 插件的 Provisioning 需要创建数据源配置文件。

apiVersion: 1
datasources:
  - name: VictoriaLogs
    type: victoriametrics-logs-datasource
    access: proxy
    url: http://victorialogs:9428
    isDefault: true

构建查询

VictoriaLogs 查询语言是 LogsQL。可以使用原始 LogsQL 或通过 QueryBuilder 构建查询。

请查看 VictoriaMetrics playground 中的面板示例以及此处的 LogsQL 示例。

日志面板

对于使用日志面板，请切换到 Raw Logs 查询类型

时间序列面板

对于使用时间序列面板，请切换到 Range 查询类型

统计面板

对于使用统计面板，请切换到 Instant 查询类型

若要启用背景可视化，请切换到 Range 查询类型。

表格面板

对于使用表格面板，请切换到 Raw Logs 查询类型

并按标签应用 Transformations

许可

本项目根据 Apache 2.0 许可证获得许可。

在 Grafana Cloud 上安装 VictoriaLogs

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

更新日志

提示

v0.16.3

BUGFIX: 修复了在状态码 400 时显示 VictoriaLogs 后端返回的原始错误消息的问题。这应该有助于解决查询或语法问题。详见此 Pull Request。
BUGFIX: 修复了扩展 Custom query parameters 标签宽度以修复标题的问题。详见此 Pull Request。感谢 @tommysitehost。
BUGFIX: 修复了当数据源返回类似 _stream:"{}" 时处理空的 _stream 字段的问题。详见此 Issue。

v0.16.2

BUGFIX: 正确关闭 io.ReadCloser 以避免内存泄漏。详见此 Pull Request。

v0.16.1

BUGFIX: 修复了仪表盘视图中的日志上下文问题。详见此 Pull Request。
BUGFIX: 修复了流键中包含非字母数字字符时解析 _stream 字段的问题。详见此 Issue和此 Issue。
BUGFIX: 修复了一个 bug，该 bug 会将数组索引附加到日志消息中，导致日志在仪表盘上显示不正确。详见此 Issue。
BUGFIX: 修复了 Ad Hoc 过滤器值自动完成问题。详见此 Issue。
BUGFIX: 修复了 Grafana 变量字段值加载问题。详见此 Issue。

v0.16.0

FEATURE: 实现了 getLogRowContext 方法。详见此 Issue。感谢 @Libr4rian 的此 Pull Request。
FEATURE: 添加了对构建 linux/s390x 的支持。扩展了后端构建流程以添加更多架构。详见此 Issue。
FEATURE: 添加了自定义查询参数的配置屏幕。详见此 Issue。感谢 @tommysitehost 的此 Pull Request。
BUGFIX: 修复了从标签字段构建注解的问题。所有标签都转换为字符串表示形式。详见此 Issue。
BUGFIX: 修复了日志量图表上柱状显示不正确的 bug。详见此 Issue。

v0.15.0

FEATURE: 添加了衍生字段的配置屏幕。详见此 Issue。感谢 @090809 的Pull Request。
BUGFIX: 修复了实时模式显示第一个查询结果而非单独请求的两个不同结果的 bug。详见此 Issue。

v0.14.3

BUGFIX: 修复了公共 Readme 中的图片链接。

v0.14.2

BUGFIX: 修复了插件签名问题。

v0.14.1

BUGFIX: 修复了新版本的插件签名流程。详见此 PR 和此 PR。

v0.14.0

FEATURE: 为新版本启用了插件签名流程。详见此 PR。

v0.13.5

BUGFIX: 在插件验证程序后清理了插件代码库。详见此 PR 和此 PR。

v0.13.4

BUGFIX: 在插件验证程序后更新了后端插件 ID 并修订了 README.md 文件。详见此 PR。

v0.13.3

BUGFIX: 修复了查询历史记录中的查询显示文本问题，使其显示实际表达式而不是完整的查询对象。详见此 Issue。
BUGFIX: 修复了在 Grafana 中创建警报时查询类型切换的问题。详见此 Issue
BUGFIX: 修复了插件中数据源设置解析问题。详见此 Issue。

v0.13.2

SECURITY: 将 Go 版本提升至 1.23.4。请参阅Go1.23.4中已解决的问题列表。
SECURITY: 将 golang.org/x/net 提升至 0.33.0。详见 https://github.com/advisories/GHSA-w32m-9786-jp63
FEATURE: 允许为数据源的每个请求设置标头。如果需要，这有助于在 Grafana 中使用自定义标头来定义 AccountID 和 ProjectID。详见此 Issue。

v0.13.1

FEATURE: 更新了插件依赖项以满足 Grafana marketplace 要求。
BUGFIX: 过滤掉查询中的空变量值。详见此 Issue。

v0.13.0

⚠️ 破坏性更改：插件 ID 已更新
更新说明 1
在新版插件中，插件 ID 已更新。新的插件 ID 是 victoriametrics-logs-datasource。这是破坏性更改：Grafana 会将其视为一个新插件。

您必须更新 grafana.ini 或 defaults.ini 配置文件中的 allow_loading_unsigned_plugins 字段。
示例
```
allow_loading_unsigned_plugins = victoriametrics-logs-datasource  
```
如果您使用的是 provisioning，请在 provisioning 配置中将 type 字段更新为 victoriametrics-logs-datasource。
进行这些更改后，必须重启 Grafana 服务器才能使更新生效。

FEATURE: 更新插件 ID 名称为 victoriametrics-logs-datasource，为插件签名流程做准备。详见此 Issue。

v0.12.0

FEATURE: 添加了对 Grafana v10.x.x 的兼容性，以确保 /select/logs/hits 在 Explore 页面上显示精确的日志量。详见此评论。
BUGFIX: 正确解析数据源响应中具有毫秒精度的时间戳。详见此 Issue。

v0.11.1

BUGFIX: 修复了表达式中统计管道函数的检查问题。
BUGFIX: 修复了 Grafana v10.x.x 中的插件加载问题。详见此 Issue。

v0.11.0

FEATURE: 添加了查询类型的工具提示和信息消息。现在，插件将警告关于 stats 面板的正确用法，并提供关于不同查询类型的更多信息。
FEATURE: 如果查询中不存在 _time 字段，则自动为其统计 API 调用添加 _time 字段。详见此 Issue。
FEATURE: 添加了对 /select/logs/hits 的支持，以在 Explore 页面上显示精确的日志量。详见此 Issue。
BUGFIX: 修复了选择更大时间间隔时时间序列面板渲染不完整的 bug。
BUGFIX: 修复了使用查询变量时时间范围被重置的 bug。详见此 Issue。
BUGFIX: 修复了 ad-hoc 过滤器在面板中应用不正确的问题。详见此 Issue。
BUGFIX: 修复了表达式中多变量替换的问题。详见此 Issue。

v0.10.0

FEATURE: 添加了警报支持。详见此 Issue。
FEATURE: 实现了在即时请求和范围请求之间切换的开关。详见此 Issue。
FEATURE: 添加了配置图例模板、日志行数限制和步长的选项。详见此和此 Issue。
BUGFIX: 修复了对带有流字段标签值的多选项支持问题。详见此 Issue。

v0.9.0

FEATURE: 添加了对查询中 $__range 变量的支持。它将转换为 Unix 格式的 [time_from, time_to]。详见此 Issue。
BUGFIX: 显示 VictoriaLogs 后端返回的原始错误消息。这应该有助于解决查询或语法问题。详见此 Issue。

v0.8.0

FEATURE: 添加了对 /select/logsql/stats_query 和 /select/logsql/stats_query_range API 调用的支持。此功能有助于构建包含统计数据的不同面板。详见此 Issue。
BUGFIX: 修复了数值数据类型变量中的选项排序问题。详见此 Issue。

v0.7.0

FEATURE: 添加了通过查询数据源中的 tail 端点来显示实时日志的支持。详见此 Issue

v0.6.2

BUGFIX: 在流模式下解析响应时，允许读取任意长度的字符串。详见此 Issue。

v0.6.1

BUGFIX: 修复了健康检查

v0.6.0

FEATURE: 为 /field_values 请求添加了 limit 参数。详见此 Issue。
BUGFIX: 修复了查询中的变量替换问题。详见此 Issue。
BUGFIX: 修复了 URL 以斜杠结尾时的健康路径问题。
BUGFIX: 修复了查询中过滤器的应用问题。详见此 Issue。

v0.5.0

FEATURE: 添加了对查询中 $__interval 变量的支持。详见此 Issue。感谢 @yincongcyincong 的Pull Request。
BUGFIX: 查询变量值时正确传递时间范围过滤器。之前，时间过滤器未应用于 /field_values 和 /field_names API 调用。详见此和此 Issue。
BUGFIX: 修复了请求不同字段集的日志时显示不正确子字段的问题。详见此 Issue。

v0.4.0

FEATURE: 如果返回的错误是临时网络错误，则对数据源请求进行重试。详见此 Issue
BUGFIX: 修复了导致 this is undefined 错误的动态变量问题。详见此 Issue。
BUGFIX: 修复了多值变量处理问题，使其能够正确格式化查询。详见此 Issue。
BUGFIX: 修复了变量值中特殊字符的问题。详见此 Issue。

v0.3.0

FEATURE: 添加了查询构建器的 Beta 版本。构建器允许选择 field names 和 field value。详见此 Issue。
FEATURE: 添加了对加载变量数据（包括日志字段名称和值）的支持。此功能允许查询 /select/logsql/field_names 获取字段名称，以及查询 /select/logsql/field_values 获取字段值。详见此 Issue。