添加筛选器控件

Elastic Stack Serverless

控件 是您可以添加到仪表板的交互式面板，以帮助查看者更快地筛选和显示他们想要浏览的数据。控件适用于仪表板中的所有相关面板。

有三种类型的控件

• 选项列表 — 添加一个下拉列表，允许通过选择一个或多个值来筛选数据。例如，如果您使用的是示例 Web 日志数据中的 [Logs] Web Traffic 仪表板，则可以为 machine.os.keyword 字段添加一个选项列表，该列表允许您仅显示从 osx 和 ios 操作系统生成的日志。

• 范围滑块 — 添加一个滑块，允许在指定的值范围内筛选数据。 此类型的控件仅适用于数字字段。 例如，如果您使用的是示例 Web 日志数据中的 [Logs] Web Traffic 仪表板，则可以为 hour_of_day 字段添加一个范围滑块，该滑块允许您仅显示从上午 9:00 到下午 5:00 的日志数据。

• 时间滑块 — 添加一个时间范围滑块，允许在指定的时间范围内筛选数据，按您可以定义的单位向后和向前移动时间范围，并在指定的时间范围内为数据变化设置动画。 例如，您正在使用示例 Web 日志数据中的 [Logs] Web Traffic 仪表板，并且全局时间筛选器是过去 7 天。 当您添加时间滑块时，您可以单击“上一个”和“下一个”按钮以向后或向前移动时间范围，然后单击“播放”按钮以观看数据在过去 7 天内的变化。

要添加交互式选项列表和范围滑块控件，请创建控件，然后将它们添加到您的仪表板。

1. 打开或创建一个新的仪表板。

2. 在编辑模式下，在仪表板工具栏中选择控件 > 添加控件。

3. 在创建控件浮出控件中，从数据视图下拉列表中，选择包含要用于控件的字段的数据视图。

4. 在字段列表中，选择要筛选的字段。

5. 在控件类型下，选择控件应该是选项列表还是范围滑块。

   提示

   范围滑块仅适用于数字类型字段。

6. 定义您希望控件如何显示

   • 标签：使用更清晰且不言自明的标签覆盖默认字段名称。
   • 最小宽度：控件占用多少水平空间。 最终宽度可能会因其他控件及其自身的宽度设置而异。
   • 扩展宽度以适应可用空间：扩展控件的宽度以适应仪表板上的可用水平空间。

7. 指定其他设置

   • 对于选项列表

     • 定义用户是否可以选择多个值进行筛选，还是只能选择一个值。

     • 对于字符串和IP 地址类型字段上的选项列表控件，您可以定义控件的嵌入式搜索应如何运行

       • 前缀：显示以输入的值开头的选项。

       • 包含：显示包含输入的值的选项。 此设置选项仅适用于字符串类型字段。 使用此选项时，结果可能需要更长的时间才能显示。

       • 精确：显示与输入的值完全匹配的选项。

         提示

         搜索不区分大小写。 例如，如果该值存在，则搜索 ios 仍然会检索 iOS。

     • 忽略结果超时会将值的列表的显示延迟到完全加载时。 对于大型数据集，此选项非常有用，可以避免在它们需要更长时间加载并在使用控件时显示的情况下错过某些可用选项。

   • 对于范围滑块，请设置步长。 步长决定滑块的步数。 步长越小，滑块中的步数就越多。

8. 单击保存并关闭。 现在可以使用该控件。

9. 如果您在仪表板上启用了多个控件，请考虑控件的位置。 控件从左到右依次应用，这可能会根据启用链式控件设置时控件的位置更改可用选项。

10. 保存仪表板。

您可以向仪表板添加一个交互式时间滑块控件。

1. 打开或创建一个新的仪表板。

2. 在编辑模式下，选择控件 > 添加时间滑块控件。

3. 时间滑块控件使用来自全局时间筛选器的时间范围。 要更改时间滑块控件中的时间范围，请更改全局时间筛选器。

4. 保存仪表板。 现在可以使用该控件。

可以使用应用于同一仪表板的所有控件的多个设置。

1. 在编辑模式下，选择控件 > 设置。

2. 在控件设置浮出控件中，配置以下设置

   • 标签位置 — 指定控件标签的显示位置。

   • 筛选设置

     • 将全局筛选器应用于控件 — 定义控件应忽略还是应用在仪表板的主筛选器栏中指定的任何筛选器。
     • 将全局时间范围应用于控件 — 定义控件应忽略还是应用为仪表板指定的主要时间范围。 请注意，时间滑块控件依赖于全局时间范围，并且禁用此选项时无法正常工作。

   • 选择设置

     • 验证用户选择 — 选择后，任何导致没有数据的选定选项都将被忽略。
     • 链式控件 — 选择后，控件按从左到右的顺序以及逐行应用。 在一个控件中选择的任何选项都会缩小下一个控件中的可用选项。
     • 自动应用选择 — 在控件中选择选项时，仪表板会动态更新。 禁用此选项后，用户首先需要应用他们的控件选择，然后才能将其应用于仪表板。

   • 要从仪表板中删除所有控件，请单击全部删除。

3. 单击保存并关闭以应用更改。

更改选项列表和范围滑块控件的设置。

1. 将鼠标悬停在要编辑的控件上，然后单击 。
2. 在编辑控件浮出控件中，更改选项，然后单击保存并关闭。

Elastic Stack 技术预览 Serverless 技术预览

您可以将控件绑定到仪表板中的 ES|QL 可视化。 创建 ES|QL 可视化时，自动完成建议会提示插入字段值、字段名称、函数配置和函数名称的控件。 这使控件仅适用于特定面板，并将可视化配置（例如日期直方图间隔控件）公开给仪表板用户。

1. 在编辑 ES|QL 可视化的查询时，自动完成菜单建议添加控件。

   

2. 将打开一个菜单，让您配置控件。 您可以在此处指定

   • 控件的名称。 这将是出现在您的 ES|QL 查询中的名称，并带有 ? 符号前缀。
   • 用户可以使用此控件选择的值。您可以从建议的字段中添加多个值，或键入自定义值。
   • 控件的标签。 这是为查看该控件的仪表板的用户显示的标签。
   • 控件的宽度。

   

3. 保存控件。 面板关闭，控件的名称将插入到您的查询中。

示例

• 将过滤集成到您的 ES|QL 体验中

  | WHERE field == ?value
  

• 用于动态分组的控件中的字段

  | STATS count=COUNT(*) BY ?field
  

• 可变的时间范围？ 将函数配置设置绑定到控件

  | BUCKET(@timestamp, ?interval),
  

• 使函数本身动态化

  | STATS metric = ?function
  

从您的仪表板中删除控件。

1. 将鼠标悬停在您要删除的控件上，然后单击 。
2. 在 删除控件？ 窗口中，单击 删除。