新建实体对象¶

进入统一目录 > 实体列表，点击右上角“添加”，或点击左侧设置图标选择“新建实体对象”，打开“新建实体对象”弹窗。

注意

不同的实体类型配置项会有所不同，请务必选择正确类型后填写配置信息。

基础信息¶

选择需要添加的实体类型，包括：系统、服务、主机、数据库等；
定义当前实体名称。

配置信息¶

在“配置信息”区域，支持通过“编辑器”或 “YAML” 两种模式配置实体属性，点击右上角标签切换。

编辑器模式¶

1. 基础信息¶

字段	说明
显示名	实体在列表中的展示名称，若填写将优先于系统名称显示
描述	实体的详细说明
项目	系统/服务/主机/数据库等实体类型的所属项目
资源 ID (ARN)	选择新建云资源时必填，是云资源的全局唯一标识

2. 系统¶

系统服务主机数据库云厂商

字段	说明
系统类型	选择实体所属的系统类型，包含业务应用、共享服务、中间件平台、数据平台、内部工具
生命周期	选择系统当前所处的生命周期阶段，包含规划中、建设中、运行中、维护中、已停用、已下线
环境	选择部署环境，包含生产、预发、测试、开发
重要等级	选择等级，包含核心、重要、普通、低、测试

字段	说明
服务类型	选择实体所属的服务类型，包含 Web、DB、Cache、Queue 等
服务语言	选择当前服务的语言，包含 Java、go、Python 等
生命周期	选择当前服务所处的生命周期阶段，包含规划中、建设中、运行中、维护中、已停用、已下线
环境	选择部署环境，包含生产、预发、测试、开发

字段	说明
主机 IP	填入主机 IP 地址
操作系统	选择当前实体的操作系统，包含 Linux、Windows、macoS
生命周期	选择当前主机所处的生命周期阶段，包含规划中、建设中、运行中、维护中、已停用、已下线
环境	选择部署环境，包含生产、预发、测试、开发
云服务商	选择实体所属的云服务商
实例 ID	选择实体所属的实例 ID
地域	选择实体所属的地域，如 `cn-hangzhou`
可用区	选择实体可用区，如 `cn-hangzhou-q`

字段	说明
数据库类型	选择数据库类型，如 MySQL、PostgreSQL、MongoDB、Oracle、SQLServer 等
版本号	输入版本号
主机地址	填入主机地址
端口	定义主机端口
服务地址	定义服务地址，如 10.0.0.12:3306。用于关联官方采集器中的 `server` 标签，格式为 `host:port`
地域	选择实体所属的地域，如 `cn-shenzhen`
可用区	选择实体可用区，如 `cn-shenzhen-e`
环境	选择部署环境，包含生产、预发、测试、开发
生命周期	选择当前数据库所处的生命周期阶段，包含规划中、建设中、运行中、维护中、已停用、已下线
重要等级	选择等级，包含核心、重要、普通、低、测试

字段	说明
云服务商	选择云服务商，如阿里云、AWS、腾讯云、华为云、Azure 等
云账号	输入当前实体的云账号
资源类型	选择资源类型，如 `aws_s3_bucket`
地域	选择实体所属的地域，如 `cn-shenzhen`
可用区	选择实体可用区，如 `cn-shenzhen-e`
资源属性	点击“添加”按钮，填入`键:值`

3. 关系¶

字段	说明
健康度配置	选择该系统的健康度计算方式。健康度反映系统整体运行状态，由平台基于其组成实体（服务、主机、数据库等）的未恢复告警自动聚合计算，分为四种状态：正常：组成实体整体运行良好，无未恢复告警关注：组成实体存在需关注的异常严重：组成实体存在严重异常，建议立即处理未知：系统暂无组成实体，或健康度计算失败支持两种计算方式：继承系统类型：使用系统类型中配置的默认算法自定义：调用 Func 平台函数单独计算该系统健康度，选择后需指定具体函数
组成实体	构成该系统的服务、主机、数据库等实体。系统健康度将基于这些组成实体计算
所属实体	选择上层业务域、平台或父系统，用于表示归属关系
运行依赖	选择该系统所依赖的其他系统、服务或资源

4. 团队¶

选择负责维护该实体的团队。

5. 自定义标签¶

选择或新建标签，用于分类和筛选。

6. 联系方式¶

点击 + 添加，可添加邮箱、电话、Slack 等联系信息。仅显示名称以保护隐私，点击可查看详情。

7. 链接¶

点击+ 添加，可添加仓库、文档、视图等外部链接。仓库类型自动识别提供商 Logo。

YAML 模式¶

切换至 YAML 标签页，可直接编辑配置文件。

点击右上角“配置说明”，可查看字段规范。

配置示例（服务类型）：

attributes:
  env: ''
  host: 172.16.161.51
  name: kodo.nsq.producer
  time: '2026-03-30T17:27:01.131146+08:00'
  project: cloudcare-testing
  version: ''
  language: go
  namespace: default
  sourceType: message_queue
  serviceType: message_queue
  clusterNameK8S: ''
  depends_on:
    - service:kodox.nsq.consumer
    - service:kodo.nsq.consumer
  component_of:
    - host:172.16.161.45
    - host:172.16.161.54
    - host:172.16.162.24
    - host:172.16.162.30
  custom_tags: []
  contact: []
  link: []
telemetrySelectors: []

完成创建¶

信息填写完成后，点击“保存”，系统将自动返回实体列表页，新创建的实体即时可见。