有奖捉虫:行业应用 & 管理与支持文档专题 HOT
您可以使用在容器服务(TKE)中的应用市场服务 > tapm-operator,快速安装应用性能监控 APM 的探针。即可监控追踪容器服务中的应用,查看应用相关的监控指标与链路。本文将会为您介绍如何在容器服务(TKE)侧安装 APM 探针。
说明:
当前仅支持 Java 语言- Opentelementry 增强探针。后续将会支持更多探针和语言,敬请期待。

接入步骤

通过 TKE 应用市场安装 tapm-operator

若您的集群从未通过 TKE 应用市场安装 tapm-operator,请参见以下操作步骤:

前置步骤

创建 TKE 集群,您可查看 容器服务(TKE)相关文档,了解并使用容器服务。
应用性能监控控制台 ,创建 APM 业务系统。参见文档 新建业务系统

在容器服务(TKE)侧应用市场安装 tapm-operator

2. 选择您的容器集群,在容器集群下单击新建
2.1. 输入应用名称。
2.2. 选择命名空间。
2.3. 来源项选择应用市场
2.4. Chart 中的应用场景选择监控
2.5. 选择应用性能监控 APM 的应用tapm-operator
2.6. Chart 版本需选择最新版本。

2.7 修改 yaml 文件参数。 单击下方的参数编辑按钮,进入参数配置页面。


根据下列描述修改 env 参数:
参数
描述
获取方式和格式说明
APM_TOKEN
您的 APM 实例对应的上报 Token
1. 应用性能监控控制台>数据接入页面选择 Java 语言接入方式及上报方式,单击下一步。



2. 单击OpenTelemetry增强探针,获取 Token。


CLUSTER_ID
此应用所在 Kubernetes集群的 ID
您可以在 容器服务控制台-集群列表 中查看。
TKE_REGION
此应用的 Kubernetes 集群所在地域
地域格式需要参见腾讯云规范地域格式,例如:广州地域为 ap-guangzhou,参见 地域说明 文档。

命名空间添加 label

在需要被注入的 pod 所在 namespace 加上 label swck-injection: enabled。如下图:



工作负载添加 label

若您已经通过 TKE 应用市场的方式成功接入 APM,只需新增应用信息即可,请参见以下操作步骤:

操作说明

您需要将新增的应用所在的 pod 打上 label,具体添加步骤可参见下列场景:
- java-agent-app-name: service-name    // 服务名,例如:order-service
- java-agent-injected: "true"                   // pod 是否需要注入,默认写 true

场景一:未创建工作负载

在 TKE 创建或修改 Deployment 配置时加上 label

1. 进入 容器服务控制台,单击相关集群,进入工作负载 > Deployment ,选择新建或修改 Deployment。


2. 在 Labels 配置项中新增 label。
- java-agent-app-name = service-name
- java-agent-injected = true


3. 单击创建 Deployment,即新增完成。

场景二:已在TKE控制台创建工作负载

若已创建 Deployment,可直接单击 Deployment 名称修改 YAML 文件,按照如下格式修改。
- java-agent-app-name: service-name
- java-agent-injected: "true" 
注意:
需要加到 deployment 下的 template 的 metadata 的 labels 里面。




场景三:已通过 yaml 创建工作负载

通过 TKE 控制台创建工作负载,TKE 会默认添加 label: k8s-app: <工作负载名>,所以若通过 yaml 直接创建需要额外添加这个 label。
通过 yaml 创建工作负载需要给 pod 添加以下标签:
- java-agent-app-name: order-service1
- java-agent-injected: "true"
- k8s-app: demo-springboot2
注意:
需要加到 deployment 下的 template 的 metadata 的 labels 里面。





跨地域上报处理

以上步骤会将数据上传到 APM,地域默认为容器集群所在的地域。请注意,APM 暂不支持部分容器集群所在的地域上报,如您有此类情况或者有特殊需求,可以修改或新增 label 进行跨地域上报。

新增/修改 Label 信息说明:

backend-service: APM 接入点信息 例如:APM 控制台数据接入信息为:pl.ap-beijing.apm.tencentcs.com 则需要新增/修改 Label 信息为:backend-service:pl.ap-beijing.apm.tencentcs.com



场景一:未创建工作负载

在 TKE 创建或修改 Deployment 配置时加上 label。
1. 进入 容器服务控制台,点击相关集群,进入工作负载 > Deployment ,选择新建或修改 Deployment。


2. 在 Labels 处新增 label。 以 backend-service:pl.ap-beijing.apm.tencentcs.com 为例:



场景二:已创建工作负载

若已创建 Deployment,可直接单击 Deployment 名称修改 YAML 文件,按照如下格式修改。 以 backend-service:pl.ap-beijing.apm.tencentcs.com 为例:



查看容器监控数据

完成以上步骤后,您就可以在应用性能监控 APM 页面监控到您在容器中部署的应用情况,以及该应用相关的容器基础资源监控。
1. 应用监控页,可选择想监控的应用,查看应用所在容器 Deployment 及 pod 的监控信息。


2. 调用查询 > 链路详情页中,可单击查看该 span 归属应用所在 pod 的基础监控信息。


容器监控链路详情如下: