您可以使用在容器服务(TKE)中的应用市场服务 > tapm-operator,快速安装应用性能监控 APM 的探针。即可监控追踪容器服务中的应用,查看应用相关的监控指标与链路。本文将会为您介绍如何在容器服务(TKE)侧安装 APM 探针。
说明:
当前仅支持 Java 语言- Opentelementry 增强探针。后续将会支持更多探针和语言,敬请期待。
接入步骤
通过 TKE 应用市场安装 tapm-operator
若您的集群从未通过 TKE 应用市场安装 tapm-operator,请参见以下操作步骤:
前置步骤
创建 TKE 集群,您可查看 容器服务(TKE)相关文档,了解并使用容器服务。
在容器服务(TKE)侧应用市场安装 tapm-operator
1. 进入 腾讯云容器服务(TKE)控制台-应用。
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 集群所在地域 |
命名空间添加 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 的基础监控信息。
容器监控链路详情如下: