UModel 术语介绍

核心概念类

UModel

定义：通用可观测模型，是一种基于图模型的可观测数据建模方法。

说明：采用Node（节点）和Link（边）组成的图结构来描述IT世界，通过标准化的数据建模方式，实现可观测数据的统一表示、存储解耦和智能分析。

EntitySet

定义：实体集，用于定义具有相同属性的实体的集合。

说明：类似于数据库中的表结构定义，定义了某一类实体的结构、属性和行为规范，如"apm.service"、"k8s.pod"等。

Entity

定义：实体实例，EntitySet的具体化对象。

说明：具体的业务对象实例，如具体的服务实例"order-service"、Pod实例"web-pod-001"等。

EntitySetLink

定义：实体关系定义，描述两个EntitySet之间的关系类型。

说明：定义实体间的关联关系，如"calls"、“contains”、"runs_on"等关系类型，是构建实体关系图的核心组件。

EntityRelation

定义：实体关系实例，具体的实体间关系数据。

说明：实际的实体关系数据，描述具体实体之间的连接，如"user-service -> web-pod-123"（服务运行在Pod上）。

数据建模类

Field

定义：字段，UModel中数据的最基本单元。

说明：用于定义日志、指标、追踪、实体等数据的具体属性，包含完整的元数据信息，如名称、类型、约束条件、显示特性等。

TelemetryDataSet

定义：可观测数据集，用于定义和管理可观测数据的核心概念。

说明：提供统一的数据建模框架，支持日志、指标、链路追踪、事件和性能剖析等多种可观测数据类型，包含时间维度和观测特性。

MetricSet

定义：指标集，用于定义监控指标的数据结构。

说明：专门用于描述具有相同属性的指标集合，支持标签管理、指标聚合和查询优化。

LogSet

定义：日志集，用于定义日志数据的结构。

说明：继承TelemetryDataSet的基础能力，适用于各种类型的日志数据建模，具有最强的灵活性。

TraceSet

定义：链路集，用于定义分布式追踪数据。

说明：包含链路追踪特有的字段和协议支持，是OpenTelemetry等追踪标准在UModel中的抽象表示。

EventSet

定义：链路集，用于定义事件数据的结构。

说明：适用于告警事件、系统事件、业务事件等场景，格式遵循CloudEvents规范。

ProfileSet

定义：性能剖析集，用于定义性能剖析数据。

说明：支持CPU、内存、网络等多种性能数据的建模，主要用于应用性能分析和系统性能调优场景。

存储相关类

Storage

定义：存储，UModel中用于定义数据物理存储的抽象概念。

说明：将数据建模与具体的存储实现解耦，支持多种存储类型，并提供统一的存储接口。

EntityStore

定义：实体存储，UModel系统中的统一存储引擎。

说明：负责存储和管理可观测性领域的核心Metadata数据，包括UModel元数据、实体数据和实体关系数据。

SLS LogStore

定义：SLS日志存储，面向日志数据的存储类型。

说明：提供高性能的日志写入和检索能力，支持全文搜索和实时分析。

SLS MetricStore

定义：SLS指标存储，专门用于存储时序指标数据。

说明：提供高效的指标聚合和查询能力，针对时序数据进行存储和查询优化。

Aliyun Prometheus

定义：阿里云Prometheus存储，托管的Prometheus服务存储。

说明：支持标准的PromQL查询，完全兼容Prometheus协议，提供企业级的高可用和容灾能力。

关联关系类

DataLink

定义：数据关联，定义EntitySet/Link与DataSet之间的关系。

说明：连接实体模型和数据模型的桥梁，实现实体与可观测数据的关联。

StorageLink

定义：存储映射，定义EntitySet/DataSet与Storage之间的映射关系。

说明：实现数据集合与底层存储的连接，通过字段映射建立逻辑字段与存储字段的对应关系。

查询相关类

USearch

定义：实体检索引擎，UModel的核心查询组件。

说明：支持多种查询模式，包括全文检索、精确查找、条件过滤等，提供强大的实体查询能力。

查询特性：

• 多类型联合检索。

• 多关键词检索打分。

• 扫描能力。

• SPL集成。

Graph Query

定义：图查询，基于实体关系的复杂查询操作。

说明：支持graph-match和graph-call功能，用于查询实体之间的关系和路径。

查询方式：

• graph-match：图模式匹配。

• graph-call：图函数调用。

• Cypher：标准图查询语言。

UModel Query

定义：元数据查询，用于查询知识图谱元数据的专用查询接口。

说明：通过.umodel查询语法，探索EntitySet定义、EntitySetLink关系以及完整的知识图谱结构。

SPL

定义：SLS Processing Language，SLS 数据处理和分析语言。

说明：SPL语法。

管理操作类

Workspace

定义：工作空间，UModel的基础容器。

说明：所有UModel操作都需要在特定的Workspace中进行，提供数据隔离和权限管理。

CommonSchema

定义：公共模式，阿里云可观测性平台提供的标准化UModel模板库。

说明：预定义的UModel组件集合，包含标准化实体集、数据集、关联关系等，支持开箱即用。

UModel Explorer

定义：UModel图形化管理工具。

说明：用于查看和编辑UModel的各类元素，提供可视化的建模和管理界面。

技术实现类

生命周期方法

定义：实体和关系的状态管理方法。

说明：控制实体和关系的创建、更新、过期和删除等生命周期操作。

方法类型：Create：创建；Update：更新；Expire：过期；Delete：删除；Revise：订正。

时间戳

定义：时间标记，用于记录数据的时间信息。

格式：秒级Unix时间戳。

相关字段：

• __first_observed_time__：首次观察时间。

• __last_observed_time__：最后观察时间。

• __keep_alive_seconds__：存活时间。

主键字段

定义：唯一标识字段，用于确保实体的唯一性。

说明：通过primary_key_fields配置，支持单字段和复合字段主键，在实体生命周期内保持稳定。

Entity ID

定义：实体唯一标识符，128位十六进制字符串。

生成方法：

• 标准：对主键使用MD5或双重xxhash函数。

• 兜底：系统自动进行xxhash转换。

数据格式类

语义字符串

定义：semantic_string，支持多语言的字符串类型。

格式：{"zh_cn": "中文内容", "en_us": "English Content"}。

系统字段类

Domain

定义：域，实体所属的业务领域。

示例：apm、k8s、acs、infrastructure等。

Kind

定义：类型，UModel元素的类型标识。

类型：entity_set、metric_set、log_set、trace_set、entity_set_link、data_link、storage_link等。