腾讯云可观测平台 K8s 环境自动接入 Python 应用（推荐）-应用性能监控-文档中心-腾讯云

对于部署在 Kubernetes 上的 Python 应用，APM 提供自动接入方案，可以实现探针自动注入，方便应用快速接入。
K8s 环境自动接入的 Python 应用将使用社区 OpenTelemetry-Python 方案注入探针，关于 OpenTelemetry-Python 的更多信息，请参考社区 OpenTelemetry-Python 项目。
前提条件
请参考 OpenTelemetry-Python 方案支持的组件和框架，确保 Python 版本、依赖库与框架在探针支持的范围内。对于自动埋点支持的依赖库和框架，在接入成功后即可完成数据上报，不需要修改代码。如果自动埋点不满足您的场景，或者需要增加业务层埋点，请使用 OpenTelemetry API 进行自定义埋点。
步骤1：安装 Operator
在 K8s 集群安装 Operator，推荐从 APM 控制台一键安装 Operator，详情请参考 安装 tencent-opentelemetry-operator。
步骤2：在工作负载添加 annotation 
以容器服务 TKE 为例，通过如下步骤可以在工作负载中添加 annotation。对于通用 K8s 集群，请通过 kubectl 等工具添加 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/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-python: "true"  # 添加到此处
        cloud.tencent.com/otel-service-name: my-app
    spec:
      containers:
        image: my-app:0.1
        name: my-app
接入验证
对工作负载添加 annotation 后，基于不同的发布策略，触发应用 Pod 的重启。新启动的 Pod 会自动注入探针，并连接到 APM 服务端上报监控数据，上报的业务系统为 Operator 的默认业务系统。在有正常流量的情况下应用性能监控 > 应用列表 中将展示接入的应用，点击应用名称/ID 进入应用详情页，再选择实例监控，即可看到接入的应用实例。由于可观测数据的处理存在一定延时，如果接入后在控制台没有查询到应用或实例，请等待30秒左右。
Django 应用注意事项
如果您的应用使用 Django 框架，在接入前需要注意如下事项：
1. 要在 K8s 环境通过 Operator 自动接入，需要确保 Python 版本为 3.8 及以上；
2. 推荐使用 uWSGI 方式部署服务，部署方式请参考 通过 uWSGI 托管 Django 应用，直接通过 Python 命令启动可能会造成上报失败。
3. OpenTelemetry-Python 的引入，可能会导致 Django 应用不再使用默认的配置文件，需要通过环境变量重新指定配置文件：
export DJANGO_SETTINGS_MODULE=mysite.settings
可以在项目的启动脚本中加入此设置项，或者通过 YAML 文件添加环境变量：
env: 
- name: DJANGO_SETTINGS_MODULE
  value: 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）版本信息，非必要情况下不推荐填写此字段。
cloud.tencent.com/container-names
指定注入探针的 container。该配置项支持将探针注入到多个 container 中，只需在该配置项的值中填写多个 container 名并用英文逗号间隔开。若不添加此项配置项，则探针将默认注入到第一个 container 中。该配置项在 operator 0.88 及以上版本支持。

配置项	描述
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）版本信息，非必要情况下不推荐填写此字段。
cloud.tencent.com/container-names	指定注入探针的 container。该配置项支持将探针注入到多个 container 中，只需在该配置项的值中填写多个 container 名并用英文逗号间隔开。若不添加此项配置项，则探针将默认注入到第一个 container 中。该配置项在 operator 0.88 及以上版本支持。

K8s 环境自动接入 Python 应用 （推荐）

本页目录：

前提条件

步骤1：安装 Operator

步骤2：在工作负载添加 annotation

接入验证

Django 应用注意事项

更多接入配置项（可选）

K8s 环境自动接入 Python 应用（推荐）