跳到主要内容

3.5 元素与数据查询

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

3.5.1 浏览元素树

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

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

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

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

3.5.2 浏览元素

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

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

3.5.3 搜索

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

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

3.5.3.1 选择搜索类型

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

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

3.5.3.2 执行基础搜索

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

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

3.5.3.3 高级过滤

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

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

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

3.5.4 元素分组

您可以将元素组织到自定义命名的分组中,便于快速访问。一个元素可同时属于多个分组。

将元素加入分组:

  1. 在元素树中,将鼠标悬停在某元素上,点击 菜单,选择加入分组;或在通用标签页工具栏中点击加入分组图标。
  2. 弹出分组对话框,列出当前所有分组(已包含该元素的分组以选中状态显示)。
  3. 勾选目标分组;如需新建分组,在底部输入框中输入名称并点击 +
  4. 点击确认完成添加。

访问分组:点击左侧侧边栏中的元素分组(元素树下方),进入分组列表页面。列表显示每个分组的名称和包含的元素数量。点击分组名称可查看该分组内的所有元素,点击元素名称可直接导航到该元素。

管理分组:在分组列表中点击 菜单,可对分组进行重命名删除操作。

3.5.5 元素过滤器

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

3.5.5.1 将搜索保存为元素过滤器

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

3.5.5.2 使用过滤结果

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

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

3.5.5.3 重新执行已保存的过滤器

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

3.5.6 从事件定位数据

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

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

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