TSVB
编辑TSVB编辑
TSVB 是一组可在仪表板上配置和显示的可视化类型。
使用 TSVB,您可以
打开并设置 TSVB编辑
打开 TSVB,然后配置所需的设置。您可以仅使用数据视图或 Elasticsearch 索引字符串创建 TSVB 可视化。
当您仅使用数据视图时,您可以
- 使用运行时字段创建可视化
- 添加 URL 跳转
- 为时间序列可视化添加交互式筛选器
- 提高性能
使用 Elasticsearch 索引字符串创建 TSVB 可视化已被弃用,并将在未来版本中删除。默认情况下,您只能使用数据视图创建 TSVB 可视化。要使用 Elasticsearch 索引字符串,请联系您的管理员,或转到 高级设置 并将 metrics:allowStringIndices
设置为 true
。
- 在仪表板上,单击 选择类型,然后选择 TSVB。
- 在 TSVB 中,单击 面板选项,然后指定 数据 设置。
- 打开 数据视图 下拉菜单旁边的 数据视图模式 选项。
- 选择 仅使用 Kibana 数据视图。
- 从 数据视图 下拉菜单中,选择数据视图,然后选择 时间字段 和 间隔。
-
选择 删除最后一个存储桶 选项。
默认情况下,TSVB 会删除最后一个存储桶,因为时间筛选器与最后一个存储桶的时间范围相交。要查看部分数据,请选择 否。
- 要查看筛选后的文档集,请在 面板筛选器 字段中输入 KQL 筛选器。
配置序列编辑
每个 TSVB 可视化都共享相同的选项来创建 序列。每个序列都可以被视为一个单独的 Elasticsearch 聚合。选项 控制样式和 Elasticsearch 选项,并从 面板选项 继承。当您为每个序列设置单独的选项时,您可以比较不同的 Elasticsearch 索引,并查看来自同一索引的两个时间范围。
要配置每个序列的值,请选择函数,然后配置函数输入。仅显示最后一个函数。
-
从 聚合 下拉菜单中,选择该序列的函数。TSVB 为您提供了一些常用函数的快捷方式
- 筛选比率
- 通过计算两组文档的指标来返回百分比值。例如,计算错误率作为一段时间内总体事件的百分比。
- 计数器速率
- 用于处理单调递增的计数器。 最大值、导数 和 仅正数 的快捷方式。
- 仅正数
- 从结果中删除任何负值,这可以用作导数后的后处理步骤。
- 序列聚合
- 将函数应用于所有 分组依据 序列,以将值减少到单个数字。此函数必须始终是序列中的最后一个指标。例如,如果 时间序列 可视化显示 10 个序列,则总和 序列聚合 会计算所有 10 个条形的总和,并为每个 X 值输出一个 Y 值。这通常与总体求和函数混淆,后者为每个唯一序列输出一个 Y 值。
- 数学
- 对于每个序列,应用简单和高级计算。仅对序列中的最后一个函数使用 数学。
-
要分别显示每个组,请从 分组依据 下拉菜单中选择以下选项之一
- 筛选器 - 将数据分组到指定的筛选器中。要区分组,请为每个筛选器分配一种颜色。
- 词条 - 显示字段的最高值。颜色只能在 时间序列 图表中配置。要进行配置,请单击 选项,然后从 拆分颜色主题 下拉菜单中选择一个选项。
- 单击 选项,然后配置函数的输入。例如,要使用不同的字段格式,请从 数据格式化程序 下拉菜单中进行选择。
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 创建可视化。
查看可视化数据请求编辑
查看收集可视化数据的请求。
- 在工具栏中,单击 检查。
- 从 请求 下拉菜单中,选择要查看的序列。
保存并添加面板编辑
将面板保存到 可视化库 并将其添加到仪表板,或者在不保存的情况下将其添加到仪表板。
要将面板保存到 可视化库
- 单击 保存到库。
- 输入 标题 并添加任何适用的 标签。
- 确保选中了 保存后添加到仪表板。
- 单击 保存并返回。
要将面板保存到仪表板
- 单击 保存并返回。
-
为面板添加可选标题。
- 在面板标题中,单击 无标题。
- 在“面板设置”窗口中,选择“显示标题”。
- 输入标题,然后单击“保存”。
常见问题编辑
有关常见TSVB问题的答案,请查看以下内容。
如何为“Top N”和“表格”可视化创建仪表板钻取?
您可以创建包含“Top N”和“表格”可视化的指定时间范围的仪表板钻取。
- 打开要链接到的仪表板,然后复制 URL。
- 打开包含“Top N”和“表格”可视化面板的仪表板,然后单击工具栏中的“编辑”。
- 打开“Top N”或“表格”面板菜单,然后选择“编辑可视化”。
- 单击“面板选项”。
-
在“项目 URL”字段中,输入 URL。
例如
dashboards#/view/f193ca90-c9f4-11eb-b038-dd3270053a27
。 - 单击 保存并返回。
- 在工具栏中,单击“另存为”,然后确保取消选中“使用仪表板存储时间”。
如何根据我的数据设置钻取 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 来执行这些插值。 rison
和 encodeURIComponent
是 Kibana 提供的自定义 Handlebars 帮助器。
为什么我的 TSVB 可视化缺少数据?
这取决于具体情况,但最常见的原因有两个
- 对于具有导数函数的时间序列可视化,时间间隔可能太小。导数需要连续值。
- 对于所有其他TSVB可视化,原因可能是数据时间范围模式,它由面板选项 > 数据时间范围模式 > 整个时间范围控制。默认情况下,TSVB 显示最后一个完整存储桶。例如,如果时间过滤器设置为过去 24 小时,并且当前时间为 9:41,则TSVB 仅显示最后 10 分钟(从 9:30 到 9:40)。
如何比较当月与上月?
TSVB 可以显示具有时间偏移量的两个系列,但不能跨系列执行数学运算。要添加时间偏移量
-
单击“克隆系列”,然后为新系列选择一种颜色。
- 单击“选项”,然后在“偏移系列时间”字段中输入偏移值。
如何计算月环比变化?
如何计算事件开始和结束之间的时间?
TSVB 不支持计算事件开始和结束之间的时间,因为TSVB 需要不同时间段之间的关联。TSVB 要求预先计算持续时间。