服务实例识别

通过自定义命名规则，您可以按照进程属性值（如 Kubernetes pod 名、环境变量等）灵活命名服务实例的配置别名，便于在服务实例列表和详情中快速识别实例。注意：该规则修改的是配置别名，不会变更服务实例识别名称。

核心能力

• 灵活组合进程属性命名：支持从环境变量、进程元数据、Java 系统属性、Kubernetes pod 名等 70+ 种进程属性中选取最多 5 个，拼接生成配置别名。
• 精细的生效范围控制：支持按全部主机或自定义主机范围（主机条件/主机标签）限定规则的作用对象。
• 多规则优先级管理：多条规则按优先级顺序生效，数值越低优先级越高，支持随时调整顺序。
• 配置别名全局可见：生成的配置别名在服务实例列表和详情属性面板中默认展示，支持排序与搜索。

使用场景

• K8s 环境实例溯源：生产环境中多个 pod 运行同一服务，您可以用 Kubernetes 完整 pod 名 作为配置别名，快速定位具体实例。
• 多环境混合部署：测试与生产环境实例同时上报，您可以结合 环境变量 + 服务名称 拼接别名，在列表中一眼区分环境归属。
• 按业务维度命名：应用通过 Java 系统属性传入业务线信息，您可以将该属性设为命名项，让配置别名直接体现业务身份。

开始使用

进入部署配置 → 规则配置 → 实体识别 → 服务实例，即可查看服务实例识别规则配置页面。

规则列表

列表按优先级由高到低展示所有自定义命名规则，包含优先级序号、描述、启用状态，以及编辑、移动、删除操作。支持按规则描述模糊搜索，列表分页展示。

创建 / 编辑规则

点击创建或列表行的编辑，在右侧抽屉中完成配置：

1. 生效范围：选择"全部主机"或"自定义主机范围"。自定义时，按主机名或主机标签添加条件（最多 10 条），并选择条件关系（与 / 或）。
2. 配置项：选择用于命名的进程属性类型（如进程元数据、服务名称等），并填写对应的属性 Key，最多添加 5 项，多项以下划线拼接。右侧实时预览命名效果。
3. 高级设置（可选）：展开后可启用识别名称映射，上传映射文件后，系统将自动识别名称与映射主键匹配并替换。
4. 描述：必填，用于在列表中标识该规则。
5. 点击保存，若配置有变更，系统将弹出确认提示，确认后规则立即生效。

提示

新建规则默认插入为最高优先级（序号为 1）。

调整优先级（移动）

点击规则行的移动，在弹出的移动面板中，点击目标位置即可完成优先级调整，点击保存后生效。当前被移动的规则以紫色高亮显示，灰色文字表示已禁用的规则。

启用 / 禁用规则

在列表中切换规则行的启用开关，即时生效。禁用后，该规则不参与配置别名的生成。

删除规则

点击删除后，确认弹窗提示"是否删除？"，点击确认删除后规则永久移除。

特殊说明

提示

配置别名 ≠ 识别名称：自定义命名规则只写入服务实例的配置别名（configurationAlias），不修改系统自动识别的实例名称。

别名读取优先级：当存在已启用的自定义规则时，配置别名优先从规则中读取；若无规则或全部禁用，则配置别名为空。

多规则时按优先级取第一个匹配项：系统从优先级最高（序号最小）的规则开始匹配，第一个生效范围包含该实例的规则即为最终命名依据。

配置别名长度上限：生成的配置别名超过 512 个字符时，系统自动截断后入库。

服务实例列表展示：配置别名作为默认列头展示在服务实例识别名称列之后，支持排序与搜索过滤。