对于部署在容器服务 TKE 上的 Python 应用，APM 提供自动接入方案，可以在应用部署到 TKE 之后实现探针自动注入，方便应用快速接入。
TKE 环境自动接入的 Python 应用将使用社区 OpenTelemetry-Python 方案注入探针，关于 OpenTelemetry-Python 的更多信息，请参考社区 OpenTelemetry-Python 项目。
前提条件
请参考 OpenTelemetry-Python 方案支持的组件和框架，确保 Python 版本、依赖库与框架在探针支持的范围内。对于自动埋点支持的依赖库和框架，在接入成功后即可完成数据上报，不需要修改代码。如果自动埋点不满足您的场景，或者需要增加业务层埋点，请使用 OpenTelemetry API 进行自定义埋点。
步骤1：安装 Operator
步骤2：在工作负载添加 annotation
1. 登录 容器服务 控制台。
2. 点击集群，进入对应的 TKE 集群。
3. 在工作负载中找到需要接入 APM 的应用，点击更多，点击编辑yaml。
4. 应用所在的Pod annotation 中如下内容，点击完成，即可以完成接入。
cloud.tencent.com/inject-python: "true"cloud.tencent.com/otel-service-name: my-app # 应用名，多个使用相同应用名接入的进程，在APM中会表现为相同应用下的多个实例# 应用名最长63个字符，只能包含小写字母、数字及分隔符("-")，且必须以小写字母开头，数字或小写字母结尾。
请注意，此内容需要添加到
spec.template.metadata.annotations 中，作用于 Pod 的 annotation，而不是工作负载的 annotation，可以参考如下代码片段： apiVersion: apps/v1kind: Deploymentmetadata:labels:k8s-app: my-appname: my-appnamespace: defaultspec:selector:matchLabels:k8s-app: my-apptemplate:metadata:labels:k8s-app: my-appannotations:cloud.tencent.com/inject-python: "true" # 添加到此处cloud.tencent.com/otel-service-name: my-appspec:containers:image: my-app:0.1name: my-app
接入验证
对工作负载添加 annotation 后，基于不同的发布策略，触发应用 Pod 的重启。新启动的 Pod 会自动注入探针，并连接到 APM 服务端上报监控数据，上报的业务系统为 Operator 的默认业务系统。在有正常流量的情况下 应用性能监控 > 应用监控 > 应用列表 中将展示接入的应用，应用性能监控 > 应用监控 > 应用详情 > 实例监控中将展示接入的应用实例。由于可观测数据的处理存在一定延时，如果接入后在控制台没有查询到应用或实例，请等待30秒左右。
Django 应用注意事项
如果您的应用使用 Django 框架，在接入前需要注意如下事项：
1. 推荐使用 uWSGI 方式部署服务，部署方式请参考 通过 uWSGI 托管 Django 应用，直接通过 python 命令启动可能会造成上报失败。
2. OpenTelemetry-Python 的引入，可能会导致 Django 应用不再使用默认的配置文件，需要通过环境变量重新指定配置文件：
export DJANGO_SETTINGS_MODULE=mysite.settings
或者通过 YAML 文件添加环境变量：
env:- name: DJANGO_SETTINGS_MODULEvalue: mysite.settings
更多接入配置项（可选）
在工作负载级别，可以添加更多的 annotation 对接入行为进行调整：
配置项 | 描述 |
cloud.tencent.com/apm-token | 指定 APM 业务系统的 Token。若不添加此项配置项，则使用 Operator的配置（对应 Operator 的 env.APM_TOKEN 字段）。 |
cloud.tencent.com/python-instr-version | 指定 Python 探针版本。若不添加此项配置项，则使用 Operator 的配置（对应 Operator 的
env.PYTHON_INSTR_VERSION 字段）。取值为 latest（默认）或具体版本号，具体的版本号列表请参考 探针（Agent）版本信息，非必要情况下不推荐填写此字段。 |
是
否
本页内容是否解决了您的问题？