应用性能监控全链路版
应用性能监控全链路版
文档指南
请输入
- 文档首页
应用性能监控全链路版用户指南应用性能监控接入指南通过 VKE 接入应用
复制全文
下载 pdf通过 VKE 接入应用
文档反馈
问问助手应用性能监控已经对接 VKE，为集群中部署的应用提供端到端全链路应用性能监控服务。本文为您介绍如何在 VKE 集群中部署应用并接入应用性能监控。
前提条件
- 已开通应用性能监控。详情请参见：开通应用性能监控。
- 已创建 VKE 集群。详情请参见：创建集群。
- 已经在 VKE 集群中安装 apmplus-opentelemetry-collector 组件，详情请参见：安装组件。
使用限制
工作区拥有独立的数据上报凭证，如需使用工作区进行数据管理和数据隔离，请确保 apmplus-opentelemetry-collector 组件已经升级至 v3.1.0 及以上版本。
操作步骤
说明
方式一：通过控制台配置
- 登录 容器服务控制台。
- 在左侧导航栏选择 集群，并单击目标集群名称，前往集群管理页面。
- 在左侧导航栏选择 工作负载 > 无状态负载。
- 单击 创建无状态负载，在 容器配置 页面中，勾选启用 全链路应用性能监控，并配置监控参数。
-
- 本场景涉及的关键配置说明如下，更多参数配置介绍，参见：创建无状态负载。
- 配置项说明监控应用类型选择监控的应用类型，当前支持 Java、Python、NodeJs 等。APM 工作区监控服务名称（可选）配置监控服务的名称，该名称会作为当前工作负载监控任务的名称，在 APMPlus 服务端控制台的服务列表中展示，方便您区分不同的监控任务。说明若未填写该名称，则系统会默认使用工作负载的名称作为监控服务的名称。
- 完成工作负载其他参数的配置后，单击 确定，完成配置。
方式二：通过 kubectl 命令行配置
说明
通过 kubectl 命令行创建无状态负载前请确保：
- 已安装 kubectl 工具到本地。具体操作说明，请参见：安装和设置 kubectl。
- 已通过 kubectl 连接目标集群。具体操作说明，请参见：连接集群。
您可以在集群中使用 Yaml 创建工作负载时，通过 Annotaiton 配置应用的性能观测功能。不同类型的应用，Yaml 配置示例代码略有不同。
Java 应用的配置示例代码，如下所示：
apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-demo # 无状态负载名称
namespace: default # 无状态负载所在的命名空间
spec:
replicas: 1 # 无状态负载的副本数
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
annotations:
instrumentation.apmplus.volcengine.com/inject-java: "true" # 开启 APMPlus 观测注入
instrumentation.apmplus.volcengine.com/workspace: default # 指定服务所属工作区
instrumentation.apmplus.volcengine.com/java-container-names: "nginx,myapp" # （可选）指定哪些 Container 实现注入
apmplus.volcengine.com/service.name: "doc-pod-demo" # （可选）自定义工作负载在 APMPlus 中的服务名称，未配置时，默认使用 Pod 的名称作为服务器名称
spec:
containers:
- name: nginx # 容器名称
image: cr-cn-beijing.volces.com/demo-namespace/demo-repo:v1 # 容器镜像地址和 Tag
ports:
- containerPort: 80 # 容器开放的端口号
env: # 使用环境变量定义 Container 在 APMPlus 中的服务名称，该配置的优先级高于注解中的 apmplus.volcengine.com/service.name 配置
- name: OTEL_SERVICE_NAME
value: "container-demo"
Python 应用的配置示例代码，如下所示：
apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-demo # 无状态负载名称
namespace: default # 无状态负载所在的命名空间
spec:
replicas: 1 # 无状态负载的副本数
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
annotations:
instrumentation.apmplus.volcengine.com/inject-python: "true" # 开启 APMPlus 观测注入
instrumentation.apmplus.volcengine.com/workspace: default # 指定服务所属工作区
instrumentation.apmplus.volcengine.com/python-container-names: "nginx,myapp" # （可选）指定哪些 Container 实现注入
apmplus.volcengine.com/service.name: "doc-pod-demo" # （可选）自定义工作负载在 APMPlus 中的服务名称，未配置时，默认使用 Pod 的名称作为服务器名称
spec:
containers:
- name: nginx # 容器名称
image: cr-cn-beijing.volces.com/demo-namespace/demo-repo:v1 # 容器镜像地址和 Tag
ports:
- containerPort: 80 # 容器开放的端口号
env: # 使用环境变量定义 Container 在 APMPlus 中的服务名称，该配置的优先级高于注解中的 apmplus.volcengine.com/service.name 配置
- name: OTEL_SERVICE_NAME
value: "container-demo"
NodeJS 应用的配置示例代码，如下所示：
apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-demo # 无状态负载名称
namespace: default # 无状态负载所在的命名空间
spec:
replicas: 1 # 无状态负载的副本数
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
annotations:
instrumentation.apmplus.volcengine.com/inject-nodejs: "true" # 开启 APMPlus 观测注入
instrumentation.apmplus.volcengine.com/workspace: default # 指定服务所属工作区
instrumentation.apmplus.volcengine.com/nodejs-container-names: "nginx,myapp" # （可选）指定哪些 Container 实现注入
apmplus.volcengine.com/service.name: "doc-pod-demo" # （可选）自定义工作负载在 APMPlus 中的服务名称，未配置时，默认使用 Pod 的名称作为服务器名称
spec:
containers:
- name: nginx # 容器名称
image: cr-cn-beijing.volces.com/demo-namespace/demo-repo:v1 # 容器镜像地址和 Tag
ports:
- containerPort: 80 # 容器开放的端口号
env: # 使用环境变量定义 Container 在 APMPlus 中的服务名称，该配置的优先级高于注解中的 apmplus.volcengine.com/service.name 配置
- name: OTEL_SERVICE_NAME
value: "container-demo"
如果您的工作负载中同时包含不同语言的 Container，支持同时注入不同语言的 Annotation。示例如下：
template:
metadata:
labels:
app: nginx
annotations:
instrumentation.apmplus.volcengine.com/workspace: default # 指定服务所属工作区
instrumentation.apmplus.volcengine.com/inject-java: "true" # 开启 Java 应用的观测注入
instrumentation.apmplus.volcengine.com/java-container-names: "myapp" # 指定名称为 myapp 的 Container 实现 Java 注入
instrumentation.apmplus.volcengine.com/inject-python: "true" # 开启 Python 应用的观测注入
instrumentation.apmplus.volcengine.com/python-container-names: "myapp2" # 指定名称为 myapp2 的 Container 实现 Python 注入
spec:
...
结果验证
- 登录 应用性能监控控制台。
- 单击 点击进入服务列表，进入服务端监控页面。
-
- 在服务端监控页面的左侧导航栏中选择 服务监控 > 服务列表，在服务列表中即可查看集群中工作负载监控服务的名称。
-
- 单击服务名称，即可查看该服务的详细监控信息。更多详情参见：服务监控。
-
最近更新时间：2026.06.09 14:58:55
这个页面对您有帮助吗？
有用
有用
无用
无用