TSVB
Elastic Stack 无服务器
TSVB 是一组可视化类型,您可以配置并在仪表板上显示它们。
借助 TSVB,您可以
- 组合无限数量的 聚合 以显示您的数据。
- 使用来自 Elasticsearch 索引的带时间戳的事件来注释时间序列数据。
- 在多种类型的可视化中查看数据,包括图表、数据表和 Markdown 面板。
- 在每个可视化中显示多个 数据视图。
- 在聚合上使用自定义函数和一些数学运算。
- 使用标签和颜色自定义数据。

打开 TSVB,然后配置所需的设置。您可以仅使用数据视图或 Elasticsearch 索引字符串创建 TSVB 可视化。
当您仅使用数据视图时,您可以
- 使用运行时字段创建可视化
- 添加 URL 细查
- 为时间序列可视化添加交互式过滤器
- 提高性能
使用 Elasticsearch 索引字符串创建 TSVB 可视化已被弃用,并将在未来的版本中删除。默认情况下,您仅使用数据视图创建 TSVB 可视化。要使用 Elasticsearch 索引字符串,请联系您的管理员,或转到 高级设置 并将 metrics:allowStringIndices
设置为 true
。
在仪表板上,单击选择类型,然后选择 TSVB。
在 TSVB 中,单击面板选项,然后指定数据设置。
打开 数据视图 下拉菜单旁边的数据视图模式选项。
选择仅使用 Kibana 数据视图。
从数据视图下拉菜单中,选择数据视图,然后选择时间字段和间隔。
选择删除最后一个存储桶选项。
默认情况下,TSVB 删除最后一个存储桶,因为时间过滤器与最后一个存储桶的时间范围相交。要查看部分数据,请选择否。
要查看经过筛选的文档集,请在面板过滤器字段中输入 KQL 过滤器。
每个 TSVB 可视化都共享相同的选项来创建序列。每个序列都可以被认为是一个单独的 Elasticsearch 聚合。选项控制样式和 Elasticsearch 选项,并从面板选项继承。当您为每个序列设置单独的选项时,您可以比较不同的 Elasticsearch 索引,并查看来自同一索引的两个时间范围。
要配置每个序列的值,请选择函数,然后配置函数输入。仅显示最后一个函数。
从聚合下拉菜单中,选择序列的函数。TSVB 为您提供了一些常用函数的快捷方式
- 过滤器比率
- 通过计算两组文档上的指标来返回百分比值。例如,计算错误率作为一段时间内总体事件的百分比。
- 计数器速率
- 在处理单调递增计数器时使用。Max、Derivative 和 Positive Only 的快捷方式。
- 仅限正值
- 从结果中删除任何负值,这可以用作导数后的后处理步骤。
- 序列聚合
- 将函数应用于所有按...分组序列,以将值减少为单个数字。此函数必须始终是序列中的最后一个指标。例如,如果时间序列可视化显示 10 个序列,则总和序列聚合计算所有 10 个条的总和,并为每个 X 值输出单个 Y 值。这通常与总和函数混淆,总和函数为每个唯一序列输出单个 Y 值。
- 数学
-
对于每个序列,应用简单和高级的计算。仅对序列中的最后一个函数使用 Math。
要分别显示每个组,请从按...分组下拉菜单中选择以下选项之一
- 过滤器 — 将数据分组为指定的过滤器。要区分组,请为每个过滤器分配一种颜色。
- 术语 — 显示字段的顶部值。颜色只能在时间序列图表中配置。要配置,请单击选项,然后从分割颜色主题下拉菜单中选择一个选项。
单击选项,然后配置函数的输入。例如,要使用不同的字段格式,请从数据格式化程序下拉菜单中进行选择。
每个 TSVB 可视化的配置选项都不同。
默认情况下,y 轴显示完整的数据范围,包括零。要自动将 y 轴从数据的最小值缩放到最大值,请单击数据 > 选项 > 填充,然后在填充字段中输入 0
。您可以根据单独 Elasticsearch 索引中带时间戳的文档将注释添加到 x 轴。
面板选项中的数据时间范围模式下拉菜单控制 TSVB 用于匹配文档的时间跨度。最后值无法匹配所有文档,只能匹配特定的间隔。整个时间范围匹配时间过滤器中指定的所有文档。
面板选项中的颜色规则包含基于值的条件着色。
当您单击一个序列时,TSVB 会根据序列名称应用过滤器。要更改此行为,请单击面板选项,然后在项目 URL 字段中指定 URL,该 URL 将打开一个 URL,而不是在单击时应用过滤器。
Markdown 可视化支持带有 Handlebar (mustache) 语法的 Markdown,用于插入动态数据,并支持自定义 CSS。
当您在 Lens 中打开 TSVB 可视化时,所有配置选项和注释都会显示在 Lens 可视化编辑器中。
您可以在 Lens 中打开以下 TSVB 可视化
- 时间序列
- 指标
- Top N
- 仪表盘
- 表格
要开始使用,请单击工具栏中的在 Lens 中编辑可视化。
有关更多信息,请查看 使用 Lens 创建可视化。
查看收集可视化数据的请求。
- 在工具栏中,单击检查。
- 从请求下拉菜单中,选择要查看的序列。
将面板保存到可视化库并将其添加到仪表板,或者将其添加到仪表板而不保存。
要将面板保存到可视化库
- 单击保存到库。
- 输入标题并添加任何适用的 标签。
- 确保已选择保存后添加到仪表板。
- 单击保存并返回。
要将面板保存到仪表板
单击保存并返回。
向面板添加可选标题。
- 在面板标题中,单击无标题。
- 在面板设置窗口上,选择显示标题。
- 输入标题,然后单击保存。
有关常见 TSVB 问题的解答,请查看以下内容。
如何为 Top N 和 Table 可视化创建仪表板细查?
您可以创建仪表板细查,其中包含 Top N 和 Table 可视化的指定时间范围。
打开要链接到的仪表板,然后复制 URL。
打开带有 Top N 和 Table 可视化面板的仪表板,然后在工具栏中单击编辑。
打开 Top N 或 Table 面板菜单,然后选择编辑可视化。
单击面板选项。
在项目 URL 字段中,输入 URL。
例如
dashboards#/view/f193ca90-c9f4-11eb-b038-dd3270053a27
。单击保存并返回。
在工具栏中,单击另存为,然后确保将时间与仪表板一起存储未被选中。
如何基于我的数据建立细查 URL?
您可以使用您的可视化数据动态构建细查 URL。
通过将 {{key}}
占位符添加到您的 URL 来实现此目的
例如 https://example.org/{{key}}
这指示 TSVB 将您可视化中的值替换到它看到的任何 {{key}}
位置。
如果您的数据包含保留或无效的 URL 字符,例如 "#" 或 "&",您应该应用转换来对键进行 URL 编码,例如 {{encodeURIComponent key}}
。如果您正在动态构建一个可以深入到 Kibana 中另一个位置的下钻链接(例如,单击表格行会将您带到特定值的 Discover 会话),您可能需要对您的键进行 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 来执行这些插值。rison
和 encodeURIComponent
是 Kibana 提供的自定义 Handlebars 助手。
为什么我的 TSVB 可视化缺少数据?
这取决于情况,但最常见的原因有两个
- 对于具有导数函数的时间序列可视化,时间间隔可能太小。导数需要连续的值。
- 对于所有其他 TSVB 可视化,原因可能是数据时间范围模式,该模式由面板选项 > 数据时间范围模式 > 整个时间范围控制。默认情况下,TSVB 显示的是最后一个完整存储桶。例如,如果时间过滤器设置为过去 24 小时,并且当前时间是 9:41,则 TSVB 仅显示过去 10 分钟的数据,即从 9:30 到 9:40。
如何比较当前月份与上个月份?
如何计算环比变化?
如何计算事件开始和结束之间的时间间隔?
TSVB 不支持计算事件开始和结束之间的时间间隔,因为 TSVB 需要不同时间段之间的关联。TSVB 要求预先计算持续时间。