统一目录¶
统一目录（统一服务与资源目录，Unified Catalog）是观测云的资产管理中心，用于集中存放和管理企业内的系统服务、云资源及基础设施实体。通过自动化的资产采集、灵活的类型扩展与可视化的关系拓扑，帮助用户构建完整的资产生命周期管理体系，实现资产与可观测数据的深度联动。
核心能力¶
1. 多渠道资产接入
支持自动发现、DataKit 上报、云资产采集、YAML 声明四种数据来源，覆盖服务、主机、数据库、云资源等多类型实体。
2. 灵活的类型扩展
系统预设系统、服务、主机、数据库、云资源五种标准实体类型，支持自定义扩展，适配企业个性化资产管理需求。
3. 动态资产管理
实体列表支持按类型动态渲染列定义、自定义显示字段、一键导出 CSV，并提供实体数量统计与快捷添加能力。
4. 关系拓扑分析
基于调用链与依赖关系构建实体拓扑，支持依赖视图（展示调用与包含关系）与层级视图（展示归属关系）双视角分析，以及全景架构拓扑的可视化呈现。
5. 资产与观测联动
实体详情页自动关联日志、链路、事件、指标等可观测数据，实现从资产信息到运行态数据的快速跳转与故障定位。
数据来源¶
统一目录支持四种实体数据来源，覆盖自动化采集与人工录入场景：
| 来源方式 | 采集机制 | 适用场景 |
|---|---|---|
| 自动发现 | 通过 APM 链路 Span 自动推导 Service 及调用关系 | 微服务架构下的服务发现 |
| DataKit 上报 | 由部署在主机或 K8s 的 DataKit Agent 直接采集上报 | 基础设施纳管 |
| 云资产采集 | 定时同步 AWS、阿里云等云厂商 API，获取 RDS、S3、ECS 等元数据 | 多云资源统一管理 |
| YAML 声明 | 通过代码库中的 catalog-info.yaml 文件声明（GitOps） |
研发流程一体化资产管理 |
功能模块¶
统一目录包含以下功能模块，支持从资产录入到关系分析的全链路管理：
| 模块 | 功能说明 |
|---|---|
| 实体列表 | 资产主列表，支持动态列展示、自定义显示项、CSV 导出、实体增删改查及快捷添加 |
| 实体类型管理 | 管理预设类型与自定义类型，关联视图（内置视图与查看器）及图标显示 |
| 全景拓扑图 | 自动生成工作空间内实体全景架构图，支持筛选过滤、分组展示、搜索高亮及视图保存 |
| 实体详情 | 侧滑展示实体元数据、联系方式、外部链接、关系拓扑（依赖/层级）及关联观测数据 |
核心概念¶
实体（Entity）¶
统一目录中的最小管理单元，代表一个具体的系统、服务、主机、数据库或云资源实例。每个实体具有唯一的类型标识和名称，通过详情页可查看完整的元数据、关系图谱及关联观测数据。
实体间支持两种关联方式：
-
调用关系：表示服务间的调用依赖，上游实体调用下游实体
-
包含关系：表示层级归属，子实体归属于父实体
实体类型（Entity Type）¶
对实体进行分类的定义模板，决定实体的属性字段和展示方式。系统预设系统、服务、主机、数据库等标准类型，支持用户自定义扩展。每个类型可配置统一的关联视图，包括内置视图及日志、链路、事件等查看器。