关联关系建模

字段映射

通过fields_mapping定义源 EntitySet 和目标 EntitySet 之间的字段对应关系：

spec:
  fields_mapping:
    source_field_1: target_field_1
    source_field_2: target_field_2

动态关系

设置dynamic: true可启用动态 EntitySetLink：

• 关系内容从 Storage 实时获取，而非存储在 EntityStore 中。

• 适用于关系频繁变化的场景。

• 需要配合 Storage 使用。

字段映射

定义源数据集和目标数据集之间的字段对应关系：

spec:
  fields_mapping:
    entity_id: data_entity_id
    timestamp: data_time

数据过滤

通过data_filter可对目标数据进行过滤（不推荐使用）：

spec:
  data_filter: "type='db'"  # 过滤出数据库类型的指标

注意：data_filter使用query类型的filter语法，较为复杂，建议通过其他方式实现数据过滤。

字段映射

定义数据集合字段与存储字段之间的映射关系：

spec:
  fields_mapping:
    logical_field_name: storage_column_name
    entity_id: storage_id
    timestamp: storage_time

核心原则

1. 主键优先映射：实体到 DataSet 的关联中，必须配置实体的主键字段到 DataSet 字段的映射。

2. 完整性保证：映射应覆盖所有关键标识字段，确保能够精确定位特定实体的数据。

3. 类型兼容性：确保源字段和目标字段的数据类型兼容。

4. 语义一致性：映射的字段应具有相同的业务语义。

实体主键映射示例

以APM应用实体为例，应用实体的主键字段需要完整映射到指标数据，此外，由于 APM 的服务名也是唯一的，且和MetricSet中的服务名一致，因此需要进行映射。

# APM应用实体关联指标数据
kind: data_link
metadata:
  name: "apm.service_related_to_apm.metric.apm.service"
spec:
  src:
    domain: apm
    kind: entity_set
    name: apm.service
  dest:
    domain: apm
    kind: metric_set
    name: apm.metric.apm.service
  data_link_type: related_to
  fields_mapping:
    # 实体主键字段映射
    "service_id": "acs_arms_service_id"    # 应用唯一标识，主键字段
    "service_name": "service"              # 应用名称

层次实体映射示例

以阿里云 NAS 文件系统为例，展示如何建立实体与多类型指标的映射：

# NAS实体关联CPFS指标
kind: data_link
metadata:
  name: "acs.nas.filesystem_related_to_acs.metric.prometheus_cpfs_userid_filesystemid"
spec:
  src:
    domain: acs
    kind: entity_set
    name: acs.nas.filesystem
  dest:
    domain: acs
    kind: metric_set
    name: acs.metric.prometheus_cpfs_userid_filesystemid
  data_link_type: related_to
  fields_mapping:
    # 完整的实体主键映射
    region_id: region_id                 # 区域标识
    resource_group_id: resource_group_id # 资源组标识
    instance_id: fileSystemId           # 文件系统实例ID
    user_id: userId                     # 用户标识

使用场景

• 同一个 EntitySet 包含多种子类型，需要针对特定子类型建立关联。

• 根据实体属性值筛选需要关联的实体范围。

• 根据特定实体，选择对应的存储实例（Storage）。

配置示例

以NAS文件系统为例，根据文件系统类型建立不同的指标关联：

# CPFS类型文件系统关联CPFS指标
kind: data_link
metadata:
  name: "acs.nas.filesystem_related_to_acs.metric.prometheus_cpfs_userid_filesystemid"
spec:
  src:
    domain: acs
    kind: entity_set
    name: acs.nas.filesystem
  dest:
    domain: acs
    kind: metric_set
    name: acs.metric.prometheus_cpfs_userid_filesystemid
  data_link_type: related_to
  filter_by_entity: file_system_type in ('cpfs', 'bmcpfs')  # 只关联CPFS类型
  fields_mapping:
    region_id: region_id
    instance_id: fileSystemId
    user_id: userId

# 标准NAS类型文件系统关联NAS指标
kind: data_link
metadata:
  name: "acs.nas.filesystem_related_to_acs.metric.prometheus_nas_userid_filesystemid"
spec:
  src:
    domain: acs
    kind: entity_set
    name: acs.nas.filesystem
  dest:
    domain: acs
    kind: metric_set
    name: acs.metric.prometheus_nas_userid_filesystemid
  data_link_type: related_to
  filter_by_entity: file_system_type = 'standard'  # 只关联标准NAS类型
  fields_mapping:
    region_id: region_id
    instance_id: fileSystemId
    user_id: userId

使用场景

• 目标 DataSet 包含多种数据类型，只需要关联特定类型的数据。

• 根据数据内容筛选相关数据范围。

• 实现数据的条件关联。

配置示例

# 应用实体关联数据库类型的调用指标
kind: data_link
metadata:
  name: "apm.service_related_to_database_metrics"
spec:
  src:
    domain: apm
    kind: entity_set
    name: apm.service
  dest:
    domain: apm
    kind: metric_set
    name: apm.metric.external_calls
  data_link_type: related_to
  data_filter: "call_type='database'"  # 只关联数据库调用的指标数据
  fields_mapping:
    service_id: service_id