Skip to content

model-elements.md

Latest commit

 

History

History
85 lines (63 loc) · 2.21 KB

model-elements.md

File metadata and controls

85 lines (63 loc) · 2.21 KB
Raw

Model Elements

English: Model Elements

UModel element 是版本化的模型定义。它描述对象图的结构，而不是运行时实体数据本身。

通用结构

UModel YAML 通常采用以下结构：

kind: entity_set
schema:
  url: "umodel.aliyun.com"
  version: "v0.1.0"
metadata:
  name: "devops.service"
  domain: devops
spec:
  fields: []

关键字段：

字段 含义
kind 模型类型，例如 entity_set、metric_set、data_link、sls_metricstore。
schema.version Schema 校验版本。
metadata.name domain 内稳定名称。
metadata.domain 语义命名空间。
metadata.display_name 面向人的双语名称。
spec kind-specific 内容。

核心 Kind

分类 Kinds
实体 entity_set
数据集 metric_set, log_set, trace_set, event_set, profile_set, runbook_set
链接 data_link, entity_set_link, storage_link, runbook_link, entity_source_link, explorer_link
存储 sls_logstore, sls_metricstore, sls_entitystore, aliyun_prometheus, external_storage

生命周期

flowchart LR
  Author["编写 YAML"]
  Validate["校验"]
  Import["导入 workspace"]
  Query["通过 .umodel 读取"]
  Use["Query / UI / Agent"]

  Author --> Validate
  Validate --> Import
  Import --> Query
  Query --> Use
Loading

导入路径

导入内置多域 quickstart 样例：

curl -X POST http://localhost:8080/api/v1/samples/demo/multi-domain-quickstart:import \
  -H 'Content-Type: application/json' \
  -d '{}'

导入自定义模型包：

go run ./cmd/umctl --addr http://localhost:8080 umodel import demo examples/quickstart-multidomain

校验与引用

Validation 在写入 GraphStore 之前检查 element shape。Schema 源文件位于 schemas/，生成参考 HTML 位于 docs/html、docs/html_en 和 docs/html_cn。

相关概念