UModel 探索使用文档

UModel 探索是 UModel 的图形化管理工具,用于查看和编辑 UModel 的各类元素。

应用案例

当前应用案例相关素材,请参考:umodel.zip

主页

在主页上,可以直观地查看和编辑UModel的各类元素。image

UModel 探索入口

登录云监控2.0控制台,选择目标工作空间,在左侧导航栏选择应用中心 > UModel 探索

推荐固定到 Workspace App 侧边栏。

image

控制面板(左上)image

单击图标image按钮可以收起与打开控制面板。

概览页

概览页中是当前 Workspace 中的统计信息。统计信息可以全局统计,也可以和应用过滤器筛选后统计。image

分为节点和链接的统计、孤立情况的统计。注意:entity_set_link 类型在统计中,既算作节点又算作链接。

UModel 列表视图

单击概览页的查看 UModel 列表,即可进入到 UModel 列表视图。image

上方可以过滤 UModel 类型、域,以及 UModel 元素内任意信息的筛选。

表格中信息包含 UModel 通用信息,以及特定节点的专属信息概览。imageimage

在操作栏中,可以单击后定位 UModel 在主页中的聚焦视图。

筛选页image

筛选页分为4种类型的筛选,前三种(节点类型筛选、域筛选、全文查找筛选)作为一组,同一项筛选关系为"或"(or),不同项筛选关系为"且"(and) 。在选择全文查找筛选中,需要在键入完毕关键词后按下回车即提交关键词。

聚焦筛选为独立、互斥且高优先级方式(若存在聚焦筛选,则仅考虑聚焦筛选)。

当筛选信息改变时,请及时按下“应用”按钮。image

CommonSchema 信息页

  • 背景:在阿里云可观测业务使用中,内置的UModel数据会作为公共 UModel(CommonSchema)默认存在,公共UModel数据以引用方式(CommonSchemaRef)配置在Workspace中,在查询时动态生成UModel实例并在元素的metadata字段中附加common_schema_info字段作为额外说明。

  • UModel Explorer中,CommonSchema信息页表示当前Workspace使用了哪些CommonSchema,以及是否存在本地与CommonSchema的冲突。

image

设置页image

  • 这里展示了用户可控制显示的配置。设置页信息非用户级配置,仅保留当前会话显示。

  • 注意:当主页下方出现“当前结果数据过大不宜全部展示,仅展示50个节点。若要强制展示,请前往左上方设置页面。” 提示时,若有全部显示需求,请在此处调整。

  • 警告:若强制展示大量数据,且WorkspaceUModel数据量过大,将会出现渲染卡顿、显示效果不佳的情况。

image

image

最佳实践:将范围缩小到固定聚焦、筛选后,打开全量显示开关。观察调整后,及时关闭全量显示开关。

迷你图(右下)

用于快速浏览图整体结构,快速移动视角。image

操作栏(右上)image

操作说明按钮image

创建节点按钮image

单击后会聚焦到新建出的节点,可以继续编辑。image

重新获取数据并刷新主页显示image

分享

分享后可附带当前过滤器信息和显示配置。

image

撤销与重做

支持撤销和重做每一次修改的临时提交

image

提交

当调整完毕后,点击提交可以正式将 UModel 发生改变的元素提交到 Workspace 当中。

image

  • 提交预览中指示了删除(D、红色)、新增(A、绿色)、修改(M、黄棕色),以及Diff内容展示。

  • 注意:改界面仅为预览展示,若需调整,可点击上方Tab右上角的定位按钮,可以将修改的内容进行聚焦定位展示。

  • 若担心在编辑过程中,WorkspaceUModel内容被其他用户修改,可以在提交之前,点击同步最新数据查看Diff视图是否发生变更。

  • 若修改均符合预期,可点击执行变更。

  • 若一切正常,则会批量执行对应操作。提交会按照删除、添加、修改的顺序,分别提交。删除一批次只操作1个元素,添加和修改每次批量提交10个变更。如果某一批次不成功,会终止后续执行,并返回错误。

image

  • 若遇到提交不成功的情况,请查看错误信息,并按要求修改。

  • 单击确定后,已成功提交的批次会不再在提交预览中显示。

image

在下方错误信息中会提示问题。

退出后,在操作栏中也可以再次查看错误信息。image修改后可重新提交。

image

此时为执行成功。

内容查看与表单编辑

UModel Explorer 为 UModel 元素精心设计了支持联动的表单编辑能力。image

  • 单击任意节点的非操作区域、边,即可唤出右侧详细内容展示。

  • 每一种UModel不同类型的元素,都有不同的Schema标准,包含UModel元素共用资源与该类型特殊字段。可以在字段标题的提示中查看每个字段的描述。修改过程中,如果存在校验错误,会在表单底部提示。若修改完毕,点击提交后即可完成本节点修改。

  • 注意:CommonSchema不支持修改。

在节点中操作

节点操作按钮中支持几种复杂操作:image支持针对单点和出入边的级联操作。

键盘删除

选中节点/边,然后按下backspace键。

可视化操作

image鼠标放到节点的++右侧++操作盘中,呈十字状,此时可以进行划线可视化操作。

划线直接链接

在主页中找到需要链接的两个节点,将 src 节点的右侧,拖动到 dest 节点的左侧。imageimageimage注意:划线链接后,关联关系只是默认值,通常无法直接使用 UModel 建模全部能力,需要进一步点击该边并编辑。image

划线并链接到多个已有节点

image此时会弹出“选择或创建链接对象”虚拟节点。image此时可以检索并链接多个希望链接的元素。

image

已选中的内容会在底部显示。若选择完毕,点击确认。此时会聚焦到刚刚选择的几条新建边。

image

注意:同样,创建链接后,关联关系只是默认值,通常无法直接使用UModel建模全部能力,需要进一步点击该边并编辑。

划线并创建新节点并链接

在虚拟弹出框中切换到创建新节点。

imageimage

注意:同样,创建链接、节点后,信息只是默认值,通常无法直接使用UModel建模全部能力,需要进一步点击该边并编辑。

特化操作

  • 特定 UModel 元素可发挥独特的能力,例如 EntitySet 可以跳转或快速查询相关实体,MetricSet 可以进行时序指标分析等。

  • 将鼠标置入 UModel 节点范围内,于左上角可显示操作。

  • 所有节点都具备聚焦操作。单击聚焦操作可将该 UModel 元素置入聚焦筛选条件内。

image

EntitySet

Usearchimageimage

跳转查询实体列表imageimage

MetricSet

MetricSet 分析imageimage

MetricSet分析界面,可以对MetricSet信息进行综合分析,包括下钻、 智能下钻、智能分组、智能分析等高级操作,并支持同环比查看。image

更多 MetricSet 分析界面操作,请参见 MetricSet Explorer 使用文档。