跳到主要内容

3.5 元素与数据查询

随着资产模型不断扩展,快速定位所需元素或属性变得至关重要。TDengine IDMP 提供了多种互补的方式来导航和搜索资产目录:浏览元素树、按关键词或过滤条件搜索、将搜索结果保存为可复用的元素过滤器,以及将常用元素添加到元素收藏以便快速访问。

3.5.1 浏览元素树

Explorer 页面左侧侧边栏中的元素树提供了资产模型中所有元素的层次视图。当您大致知道某个资产在层次结构中的位置时,它是浏览资产目录的主要方式。

  • 点击任意元素旁的 箭头,展开并显示其子元素。
  • 点击 箭头可收拢分支。
  • 点击元素名称,选中该元素并在主工作区中打开其详情视图。
  • 将鼠标悬停在元素树中的任意元素上,会浮现 菜单,提供快捷操作:新建子元素、删除等。

元素树支持任意深度的层次结构。只展开当前任务相关的分支,收拢其余部分,可保持侧边栏整洁易用。

元素树下方,侧边栏还包含两个附加区域:元素收藏元素过滤器,分别在 3.5.43.5.5 中介绍。

3.5.2 浏览元素

在元素树中选中某个元素后,详情面板会显示以下选项卡:

选项卡内容
通用名称、路径、模板、类别、描述、位置、附加特性、关联文档、注解、父元素和版本历史
属性该元素上定义的所有属性,包含当前值、类型、单位和最后更新时间
面板与该元素关联的面板,包括 AI 推荐和手动创建的面板
分析为该元素定义的实时分析规则
事件由该元素生成或与其关联的事件
仪表板包含该元素面板的仪表板
子元素所有直接子元素的列表

3.5.3 搜索

TDengine IDMP 提供统一的搜索弹窗,可在整个资产目录中查找元素、属性、仪表板、面板和事件。

点击侧边栏元素面板标题栏右上角的搜索图标(放大镜)可打开搜索弹窗。

选择搜索类型

使用弹窗顶部的单选按钮,选择要搜索的对象类型:

选项搜索内容
元素按名称、描述、模板、类别或属性内容搜索元素
属性按名称、描述、类别或值类型搜索属性
仪表板按名称搜索仪表板
面板按名称搜索面板
事件按名称搜索事件

执行基础搜索

在搜索框中输入关键词,按回车或点击搜索。结果以临时的过滤结果视图展示,显示匹配条目的名称、路径、描述、模板和类别。

点击任意结果行可直接导航到该元素。若要保存搜索以备后用,点击过滤结果工具栏中的另存为按钮——参见 3.5.5

高级过滤

点击高级可展开更多过滤字段。对于元素搜索:

过滤条件说明
根路径将搜索限定在特定子树中的元素
名称按名称匹配元素
描述按描述文本匹配元素
属性名称匹配包含此名称属性的元素
属性描述匹配包含此描述属性的元素
类别按一个或多个类别标签筛选
模板按元素模板筛选
创建时间按创建日期范围筛选
更新时间按最后更新日期范围筛选
最大结果数限制返回的结果数量

对于属性搜索,高级面板提供属性名称、属性描述、属性类别、属性值类型、最大结果数、排序方式,以及用于限定属性所属元素范围的元素条件子区域(根路径、名称、描述、类别)。

3.5.4 元素收藏

您可以将任意元素标记为收藏,无需浏览完整元素树即可快速访问。

将元素添加到收藏:

  1. 在元素树中选中该元素。
  2. 在通用标签页工具栏中,点击星形图标(☆)。
  3. 星形填充后,该元素即被加入元素收藏

访问收藏:点击左侧侧边栏中的元素收藏(元素树下方)。这将打开所有元素收藏的平铺列表。点击任意条目可直接导航到该元素。

取消收藏:选中该元素,再次点击星形图标即可取消收藏。

3.5.5 元素过滤器

元素过滤器是已保存的搜索——可随时重新执行的复用查询,用于显示元素的筛选子集。它们列在左侧侧边栏底部的元素过滤器区域中。

将搜索保存为元素过滤器

执行搜索后(参见 3.5.3),点击过滤结果工具栏左侧的另存为按钮,输入名称并确认。该过滤条件将被添加到侧边栏的元素过滤器列表中,可随时重新执行。

使用过滤结果

过滤结果视图以表格形式展示匹配的元素(名称、路径、描述、模板、类别)。工具栏提供以下操作:

操作位置说明
另存为左侧将当前结果保存为侧边栏中的命名元素过滤器
重新定义右侧重新打开搜索弹窗,修改过滤条件
保存为面板右侧将结果保存为某元素上的资产列表表格面板
添加到模板右侧将此过滤条件添加到元素模板
刷新右侧重新执行过滤,获取最新结果
导出当前列表为 CSV右侧将结果列表导出为 CSV 文件
配置列右侧切换结果表格中显示的列

重新执行已保存的过滤器

点击侧边栏元素过滤器列表中的任意过滤器名称,即可重新执行并查看当前匹配的元素。

3.5.6 从事件定位数据

在排查某个事件时,您可以直接从事件导航到源元素及其数据。

  1. 点击顶部导航栏中的事件,或点击某元素上的事件选项卡。
  2. 在事件列表中点击某条事件,打开其详情视图。
  3. 在事件详情中,点击源元素名称或路径,直接在 Explorer 中导航到该元素。
  4. 在元素页面,切换到属性选项卡查看当前值和历史值,或打开面板选项卡可视化事件发生时间前后的数据。

此工作流支持快速根因分析——从观察到的事件直接追溯到底层资产及其数据。