TSVB编辑

TSVB 是一组可在仪表板上配置和显示的可视化类型。

使用 TSVB,您可以

  • 组合无限数量的 聚合 来显示数据。
  • 使用 Elasticsearch 索引中带时间戳的事件来注释时间序列数据。
  • 以多种类型的可视化方式查看数据,包括图表、数据表和 Markdown 面板。
  • 在每个可视化中显示多个 数据视图
  • 对聚合使用自定义函数和一些数学运算。
  • 使用标签和颜色自定义数据。
TSVB overview

打开并设置 TSVB编辑

打开 TSVB,然后配置所需的设置。您可以仅使用数据视图或 Elasticsearch 索引字符串创建 TSVB 可视化。

当您仅使用数据视图时,您可以

  • 使用运行时字段创建可视化
  • 添加 URL 跳转
  • 为时间序列可视化添加交互式筛选器
  • 提高性能

使用 Elasticsearch 索引字符串创建 TSVB 可视化已被弃用,并将在未来版本中删除。默认情况下,您只能使用数据视图创建 TSVB 可视化。要使用 Elasticsearch 索引字符串,请联系您的管理员,或转到 高级设置 并将 metrics:allowStringIndices 设置为 true

  1. 在仪表板上,单击 选择类型,然后选择 TSVB
  2. TSVB 中,单击 面板选项,然后指定 数据 设置。
  3. 打开 数据视图 下拉菜单旁边的 数据视图模式 选项。
  4. 选择 仅使用 Kibana 数据视图
  5. 数据视图 下拉菜单中,选择数据视图,然后选择 时间字段间隔
  6. 选择 删除最后一个存储桶 选项。

    默认情况下,TSVB 会删除最后一个存储桶,因为时间筛选器与最后一个存储桶的时间范围相交。要查看部分数据,请选择

  7. 要查看筛选后的文档集,请在 面板筛选器 字段中输入 KQL 筛选器

配置序列编辑

每个 TSVB 可视化都共享相同的选项来创建 序列。每个序列都可以被视为一个单独的 Elasticsearch 聚合。选项 控制样式和 Elasticsearch 选项,并从 面板选项 继承。当您为每个序列设置单独的选项时,您可以比较不同的 Elasticsearch 索引,并查看来自同一索引的两个时间范围。

要配置每个序列的值,请选择函数,然后配置函数输入。仅显示最后一个函数。

  1. 聚合 下拉菜单中,选择该序列的函数。TSVB 为您提供了一些常用函数的快捷方式

    筛选比率
    通过计算两组文档的指标来返回百分比值。例如,计算错误率作为一段时间内总体事件的百分比。
    计数器速率
    用于处理单调递增的计数器。 最大值导数仅正数 的快捷方式。
    仅正数
    从结果中删除任何负值,这可以用作导数后的后处理步骤。
    序列聚合
    将函数应用于所有 分组依据 序列,以将值减少到单个数字。此函数必须始终是序列中的最后一个指标。例如,如果 时间序列 可视化显示 10 个序列,则总和 序列聚合 会计算所有 10 个条形的总和,并为每个 X 值输出一个 Y 值。这通常与总体求和函数混淆,后者为每个唯一序列输出一个 Y 值。
    数学
    对于每个序列,应用简单和高级计算。仅对序列中的最后一个函数使用 数学
  2. 要分别显示每个组,请从 分组依据 下拉菜单中选择以下选项之一

    • 筛选器 - 将数据分组到指定的筛选器中。要区分组,请为每个筛选器分配一种颜色。
    • 词条 - 显示字段的最高值。颜色只能在 时间序列 图表中配置。要进行配置,请单击 选项,然后从 拆分颜色主题 下拉菜单中选择一个选项。
  3. 单击 选项,然后配置函数的输入。例如,要使用不同的字段格式,请从 数据格式化程序 下拉菜单中进行选择。

TSVB 可视化选项编辑

每个 TSVB 可视化的配置选项都不同。

时间序列编辑

默认情况下,y 轴显示数据的完整范围,包括零。要自动缩放 y 轴以适应数据的最小值到最大值,请单击 数据 > 选项 > 填充,然后在 填充 字段中输入 0。您可以根据单独的 Elasticsearch 索引中带时间戳的文档向 x 轴添加注释。

除时间序列以外的所有图表类型编辑

面板选项 中的 数据时间范围模式 下拉菜单控制 TSVB 用于匹配文档的时间跨度。最后一个值 无法匹配所有文档,只能匹配特定的时间间隔。整个时间范围 匹配时间筛选器中指定的所有文档。

指标、前 N 个和仪表编辑

面板选项 中的 颜色规则 包含基于值的条件着色。

前 N 个和表格编辑

当您单击某个序列时,TSVB 会根据序列名称应用筛选器。要更改此行为,请单击 面板选项,然后在 项目 URL 字段中指定一个 URL,该 URL 将在单击时打开,而不是应用筛选器。

Markdown编辑

Markdown 可视化支持使用 Handlebar(mustache)语法的 Markdown 来插入动态数据,并支持自定义 CSS。

在 Lens 中打开和编辑 TSVB 可视化编辑

当您在 Lens 中打开 TSVB 可视化时,所有配置选项和注释都会显示在 Lens 可视化编辑器中。

您可以在 Lens 中打开以下 TSVB 可视化

  • 时间序列
  • 指标
  • 前 N 个
  • 仪表
  • 表格

要开始使用,请单击工具栏中的 在 Lens 中编辑可视化

有关更多信息,请查看 使用 Lens 创建可视化

查看可视化数据请求编辑

查看收集可视化数据的请求。

  1. 在工具栏中,单击 检查
  2. 请求 下拉菜单中,选择要查看的序列。

保存并添加面板编辑

将面板保存到 可视化库 并将其添加到仪表板,或者在不保存的情况下将其添加到仪表板。

要将面板保存到 可视化库

  1. 单击 保存到库
  2. 输入 标题 并添加任何适用的 标签
  3. 确保选中了 保存后添加到仪表板
  4. 单击 保存并返回

要将面板保存到仪表板

  1. 单击 保存并返回
  2. 为面板添加可选标题。

    1. 在面板标题中,单击 无标题
    2. 在“面板设置”窗口中,选择“显示标题”。
    3. 输入标题,然后单击“保存”。

常见问题编辑

有关常见TSVB问题的答案,请查看以下内容。

如何为“Top N”和“表格”可视化创建仪表板钻取?

您可以创建包含“Top N”和“表格”可视化的指定时间范围的仪表板钻取。

  1. 打开要链接到的仪表板,然后复制 URL。
  2. 打开包含“Top N”和“表格”可视化面板的仪表板,然后单击工具栏中的“编辑”。
  3. 打开“Top N”或“表格”面板菜单,然后选择“编辑可视化”。
  4. 单击“面板选项”。
  5. 在“项目 URL”字段中,输入 URL。

    例如 dashboards#/view/f193ca90-c9f4-11eb-b038-dd3270053a27

  6. 单击 保存并返回
  7. 在工具栏中,单击“另存为”,然后确保取消选中“使用仪表板存储时间”。
如何根据我的数据设置钻取 URL?

您可以使用可视化数据动态构建钻取 URL。

为此,请将 {{key}} 占位符添加到您的 URL

例如 https://example.org/{{key}}

这指示 TSVB 在看到 {{key}} 的任何地方替换可视化中的值。

如果您的数据包含保留或无效的 URL 字符(例如“#”或“&”),则应应用转换以对密钥进行 URL 编码,如下所示 {{encodeURIComponent key}}。如果您正在动态构建到 Kibana 中另一个位置的钻取(例如,单击表格行会将您带到值范围内的已保存搜索),则您可能希望对密钥进行 Rison 编码,因为它可能包含无效的 Rison 字符。(Rison 是 Kibana 的许多部分用于在其 URL 中存储信息的序列化格式。)

例如:discover#/view/0ac50180-82d9-11ec-9f4a-55de56b00cc0?_a=(filters:!((query:(match_phrase:(foo.keyword:{{rison key}})))))

如果两种情况都适用,则可以通过应用两种转换来涵盖所有情况:{{encodeURIComponent (rison key)}}

技术说明:TSVB 使用 Handlebars 来执行这些插值。 risonencodeURIComponent 是 Kibana 提供的自定义 Handlebars 帮助器。

为什么我的 TSVB 可视化缺少数据?

这取决于具体情况,但最常见的原因有两个

  • 对于具有导数函数的时间序列可视化,时间间隔可能太小。导数需要连续值。
  • 对于所有其他TSVB可视化,原因可能是数据时间范围模式,它由面板选项 > 数据时间范围模式 > 整个时间范围控制。默认情况下,TSVB 显示最后一个完整存储桶。例如,如果时间过滤器设置为过去 24 小时,并且当前时间为 9:41,则TSVB 仅显示最后 10 分钟(从 9:30 到 9:40)。
如何计算两个数据系列之间的差异?

TSVB 不支持跨数据系列执行数学运算。要计算两个数据系列之间的差异,请使用 TimelionVega

如何比较当月与上月?

TSVB 可以显示具有时间偏移量的两个系列,但不能跨系列执行数学运算。要添加时间偏移量

  1. 单击“克隆系列”,然后为新系列选择一种颜色。

    Clone Series action
  2. 单击“选项”,然后在“偏移系列时间”字段中输入偏移值。
如何计算月环比变化?

TSVB 不完全支持计算月环比变化,但有一种特殊情况是支持的,如果时间过滤器设置为 3 个月或更长时间,并且间隔1m。使用导数获取绝对月度变化。要转换为百分比,请添加带有 params.current / (params.current - params.derivative) 公式的数学函数,然后从数据格式化程序下拉列表中选择百分比

对于其他类型的月环比计算,请使用 TimelionVega

如何计算事件开始和结束之间的时间?

TSVB 不支持计算事件开始和结束之间的时间,因为TSVB 需要不同时间段之间的关联。TSVB 要求预先计算持续时间。