概述

本文档介绍如何在 CCE 集群中安装 CCE OnePilot 组件，并为 Java 应用开启 APM 应用监控，以实现全链路智能监控能力。

背景信息

应用性能监控(Application Performance Management,APM) 是一款应用性能管理平台，提供分布式应用拓扑查询和性能分析能力。您可以通过 APM 对应用的四个黄金指标（请求数、QPS、耗时、错误率）进行监控，并通过 Trace 链路详情定位问题，全方位保障系统的可用性和稳定性。

前提条件

• 检查您的JDK版本。APM应用监控支持JDK1.8（含）以上版本
• 已开通APM

步骤一：安装 APM 应用监控组件

1. 登录 容器引擎控制台，进入 【集群列表】。
2. 单击目标集群名称，进入集群管理页面。
3. 选择 【运维与管理】 下的 【组件管理】。
4. 在 【监控和日志】 页签中找到 CCE OnePilot 组件，单击 【安装】。
5. 安装完成后，您可以在 【组件管理】 页面升级或卸载 CCE OnePilot 组件。

步骤二：为 Java 应用开启 APM 应用监控

如需在创建新应用的同时开启 APM 应用监控，请完成以下操作。

1. 登录 容器引擎控制台，进入 【集群列表】。
2. 单击目标集群名称，选择 【工作负载】 -> 【无状态】。
3. 单击 【使用 YAML 创建资源】。
4. 选择 【自定义模板】，在 spec.template.metadata.labels 下添加以下标签。

1labels:
2  cceOnepilotEnable: "on"
3  apmServiceName: "<your_service_name>" # 请用您应用实例的名称替换 <your_service_name>，若不设置此标签，则会以工作负载的名称 metadata.name 上报指标至 APM。

• cceOnepilotEnable：固定设置为 \"on\"。
• apmServiceName：请替换为应用实例名称。若未设置该标签，则默认使用工作负载名称 metadata.name 上报指标至 APM。创建一个无状态（Deployment）应用并开启APM应用监控的完整YAML示例模板如下：

1apiVersion: apps/v1
2kind: Deployment
3metadata:
4  name: test-demo
5  namespace: cce-onepilot
6spec:
7  replicas: 1
8  selector:
9    matchLabels:
10      app: test-demo
11  template:
12    metadata:
13      labels:
14        app: test-demo
15        cceOnepilotEnable: "on"
16        apmServiceName: "test-demo"
17    spec:
18      containers:
19      - name: test-demo
20        image: registry.baidubce.com/cce-plugin-dev/tomcat:my-tomcat
21        imagePullPolicy: Always
22        ports:
23        - containerPort: 8080
24          hostPort: 8080

查看结果

在 【无状态】 页面中，目标应用的操作列会显示 【APM 控制台】 按钮。

后续步骤

完成上述步骤后，您就为部署在容器服务 Kubernetes 版中的应用开启了 APM 应用监控。在目标应用的操作列中单击 【APM 控制台】，即可进入 APM 控制台的应用监控页面。