自定义应用标签

最近更新时间:2026-05-22 11:05:31

我的收藏
标签(Tag)是腾讯云提供的云资源管理工具,用户可以从不同维度对具有相同特征的云资源进行分类、搜索和聚合,从而轻松管理云上资源。应用性能监控(APM)支持对业务系统和应用这2种资源进行标签管理,从而实现资源过滤、细粒度权限控制、分账等功能。

创建标签

标签由标签键(Key)和标签值(Value)两个部分组成,一个标签键可以对应多个标签值,一对标签键和标签值可绑定多个云资源。
在为应用打标签之前,请先前往腾讯云 标签控制台 创建自定义标签,具体的操作方式请参见 创建标签

为应用打标签

方式一:控制台操作

在完成应用接入后,前往 APM 控制台 > 应用列表 页面,单击目标应用操作栏的编辑标签,即可实现应用与标签键值对的绑定。

方式二:通过 Operator 注入

说明:
tencent-opentelemetry-operator 从0.92.2版本开始支持注入应用标签,请先升级 Operator 版本。
为了避免与控制台操作产生冲突,Operator 的注入机制不会删除应用已有的标签键(Key),只会增加新的标签键值对(Key-Value Pair),或者更新标签值(Value)。如果需要删已有的标签键(Key),请通过 APM 控制台或 API 进行操作。
通过 Operator 注入的应用标签,会自动完成自定义标签的创建,无需预先在腾讯云标签控制台创建自定义标签。
对于通过 Operator 接入的应用,可以在工作负载中添加如下 annotation ,在接入阶段注入应用标签,以简化操作流程:
cloud.tencent.com/service-tags: "keyA=valueA,keyB=valueB"
其中,annotation 的键固定为cloud.tencent.com/service-tags,值为逗号分隔的应用标签键值对。
以 Java 应用为例,完整的 YAML 片段为:
apiVersion: apps/v1
kind: Deployment
metadata:
labels:
k8s-app: my-app
name: my-app
namespace: default
spec:
selector:
matchLabels:
k8s-app: my-app
template:
metadata:
labels:
k8s-app: my-app
annotations:
cloud.tencent.com/inject-java: "true"
cloud.tencent.com/otel-service-name: my-app
cloud.tencent.com/service-tags: "keyA=valueA,keyB=valueB"
spec:
containers:
image: my-app:0.1
name: my-app