前提条件 部署 APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考探针下载地址。 Java语言支持增强型探针、OpenTelemetry和Skywalking。

动态配置master.address以及AK/SK APM支持动态配置master.address以及AK/SK。 用户可以通过配置环境变量的方式，给APM_MASTER_ADDRESS、APM_AC CES S_KEY（apm-ak）以及APM_SECRET_KEY（apm-sk）赋值。获取AK/SK的具体操作，请参见为JAVA应用手工安装Agent，获取master.address，请参见探针下载地址。 如果javaagent配置文件和环境变量同时配置了AK、SK、master.address，那么环境变量配置的值优先生效。 Agent 2.3.19之后版本支持动态配置master.address以及AK/SK。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考探针下载地址。 Node.js语言，支持增强型探针、Skywalking和OpenTelemetry。

使用说明 目前只支持部署CCE的JAVA应用。相关参数说明参见表1。 表1 性能管理配置参数列表 参数名称 参数说明 安装探针 选择安装探针。目前支持“不启动”“APM 2.0探针”。 探针类型 选择探针的版本类型。探针类型建议与负载所在node节点的CPU架构对应版本一致。 探针升级策略 探针升级的方式、策略。默认为“重启自动升级”。 重启自动升级：每次都尝试重新下载镜像。 重启手动升级：如果本地有该镜像，则使用本地镜像，本地不存在时下载镜像。 APM环境 输入APM环境名称，该参数为选填。 APM应用 选择一个已有的APM应用。 子应用 输入APM子应用，该参数为选填。 接入密钥 将会自动获取APM服务的密钥信息，详情参见前提条件。 CCE新版UI为部署在CCE容器中的JAVA应用安装Agent的详细操作，请参考《用户指南》。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式为“Skywalking”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.2.112:11800，其他区域或源代码的地址请参考探针下载地址。 Php语言支持Skywalking和OpenTelemetry。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考探针下载地址。 Java语言支持增强型探针、OpenTelemetry和Skywalking。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式为“Skywalking”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.2.112:11800，其他区域或源代码的地址请参考探针下载地址。 Python语言支持Skywalking和OpenTelemetry。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式为“Skywalking”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.2.112:11800，其他区域或源代码的地址请参考探针下载地址。 GO语言支持Skywalking和OpenTelemetry。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考探针下载地址。 Node.js语言，支持增强型探针、Skywalking和OpenTelemetry。

前提条件 部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。 可使用Telnet命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式选择“增强型探针”的连通性为例，请登录应用所部署的机器，并输入命令telnet 100.125.12.108:41333，其他区域地址请参考探针下载地址。 Java语言支持增强型探针、OpenTelemetry和Skywalking。

操作步骤 下载JavaAgent，参考探针下载地址下载apm-javaagent，并将javaagent下载到需要接入APM机器的任意目录。 示例命令： curl -O https://xxx/apm-javaagent-x.x.x.tar 执行tar命令解压javaagent。 示例命令： tar -xvf apm-javaagent-x.x.x.tar 修改javaagent中的apm.config配置文件。master.address配置请参见探针接入地址，将AK/SK写入配置文件中，如下图所示。 图3 写入AK/SK 修改java进程启动脚本。 在服务启动脚本的java命令之后，配置apm-javaagent.jar包所在路径，并指定java进程的组件名。 添加-javaagent参数示例： java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName={appName} 当企业业务很多的情况下，也支持更为复杂一些的配置，添加-javaagent参数的复杂模式如： java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName=myApp,env=myEnv,envTag=myTag,business=myBusiness,subBusiness=mySub 上述参数属于APM内置的CMDB信息，具体详情见CMDB管理章节。 由于历史原因，APM启动参数设置的元数据，跟CMDB概念有一些冲突，这里进行说明。 启动参数一般会设置 -javaagent:D:\javaagent-package\apm-javaagent\apm-javaagent.jar=appName=xxx,env=yyy,business=zzz,subBusiness=sss,envTag=xxx，在这里appName代表组件，business代表应用，subBusiness代表子应用，envTag代表环境标签。 如果没有在web界面对business参数进行设置，启动javaagent时系统就会报错；其他参数如果没有设置，在启动javaagent时会自动创建出来，包括子应用、组件、环境及环境标签等。 同一个应用下，组件名称不能重复。 重新部署应用。

计费周期 前端监控按上报量计费，计费周期为24小时。假设您是2024/11/06 16:29:30开始使用前端监控，则计费周期如下。 第一个计费周期为：2024/11/07 01:00:00开始结算2024/11/06 16:29:30 ~ 2024/11/06 23:59:59之间的上报量。 第二个计费周期为：2024/11/08 01:00:00开始结算2024/11/07 00:00:00 ~ 2024/11/07 23:59:59之间的上报量。

APM JAVA探针支持操作系统 表4 APM JAVA探针（2.4.1版本）支持操作系统 探针类型 CPU架构 vCPUs 内存 规格名称 操作系统 系统版本 结果 自研探针 x86计算 2 4 s2.large.2 CentOS CentOS 8.1 64bit for GPU 支持 自研探针 x86计算 2 4 s2.large.2 CentOS CentOS 7.6 64bit for Tenant 20230712 支持 自研探针 x86计算 2 4 s2.large.2 CentOS CentOS 7.3 64bit 支持 自研探针 x86计算 4 16 Sit3.xlarge.4 CentOS CentOS 7.4 64bit 支持 自研探针 x86计算 2 4 s2.large.2 CentOS CentOS 6.8 64bit 支持 自研探针 x86计算 2 4 s2rm.2u.4g Debian Debian 11.1.0 64bit for Tenant 20221227 支持 自研探针 x86计算 2 4 s2.large.2 Ubuntu Ubuntu 22.04 server 64bit for Tenant 20230713 支持 自研探针 x86计算 2 4 s2.large.2 Ubuntu Ubuntu 16.04 server 64bit 支持 自研探针 x86计算 2 4 s2.large.2 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 Standard 64 bit for Tenant 20230606 base 2.0.2303.1 支持 自研探针 x86计算 2 4 s2.large.2 Huawei Cloud EulerOS Huawei Cloud EulerOS 1.1 for CentOS 64 bit for op5 Tenant 20230217 base 1.1.2212.1 支持 自研探针 x86计算 2 4 s2.large.2 EulerOS EulerOS 2.9 64bit for Tenant 20230728 base 2.9.15 支持 自研探针 x86计算 2 4 s2.large.2 EulerOS EulerOS 2.5 64bit for Tenant 2023714 base 2.5.15 支持 自研探针 x86计算 2 4 s2.large.2 EulerOS EulerOS 2.2 64bit for Tenant 20210227 支持 自研探针 x86计算 2 4 s2.large.2 Windows Windows Server 2019 标准版 64位简体中文_40GB 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 Standard 64 bit for ARM for Tenant 20230411 base 2.0.2303.1(40GiB)(bf7488b4-d9b3-4314-b2a9-e39094f573d2) 支持（默认jdk11.0.17） 自研探针 鲲鹏计算 2 4 kc1.large.2 CentOS CentOS 7.6 64bit with ARM 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 CentOS CentOS 7.5 64bit with ARM(40GiB) 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 CentOS CentOS 7.4 64bit with ARM(40GiB) 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 CentOS Kylin Linux Advanced Server (Kunpeng) V10(40GiB) 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 Ubuntu Ubuntu 18.04 64bit with ARM(40GiB) 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 EulerOS EulerOS 2.9 64bit with ARM for Tenant 20230419 base 2.9.14 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 EulerOS EulerOS 2.8 64bit with ARM for Tenant 20210309(40GiB) 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 EulerOS EulerOS 2.10 64bit with ARM for Tenant 20230404 base 2.10.7 支持 自研探针 鲲鹏计算 2 4 kc1.large.2 Fedora Fedora 29 64bit with ARM(40GiB) 支持

APM支持的JAVA类型 APM支持JAVA类应用，目前已支持多种主流Java框架、web服务器、通讯协议、数据库等，可实现应用轻松接入。 表1 自研探针JAVA组件和框架 探针类型 组件 JDK 1.8 JDK 17 自研探针 Dubbo 2.6.x 2.6.x 自研探针 Jedis 2.x.x-3.x.x 2.x.x-3.x.x 自研探针 Lettuce 5.x.x 5.x.x 自研探针 servicecomb 2.x.x - 自研探针 log4j 1.x.x 1.x.x 自研探针 log4j2 2.x.x 2.x.x 自研探针 httpclient 4.x.x 4.x.x~5.3.x（5.x.x仅支持同步场景） 自研探针 jdkhttpclient 1.6~1.8 17 自研探针 mariadb 2.x.x 2.x.x 自研探针 mysql 5.x.x~8.x.x 5.x.x~8.x.x 自研探针 okhttpclient 3.x.x 3.x.x 自研探针 tomcat 6.x.x~9.x.x 9.x.x 自研探针 jetty 8.x.x~9.x.x 9.x.x 自研探针 grpc 1.x.x 1.x.x 自研探针 reactor-netty 1.x.x - 自研探针 hbase 2.x.x 2.x.x 自研探针 mongodb 3.x.x~4.x.x 3.x.x~4.x.x 自研探针 redisson 3.12.x~3.26.x 3.13.x~3.26.x 自研探针 c3p0 0.9.x 0.9.x 自研探针 cassandra3 3.x.x 3.x.x 自研探针 clickhouse 0.2.x 0.2.x 自研探针 dbcp 2.x.x 2.x.x 自研探针 druid 1.x.x 1.x.x 自研探针 httpasyncclient 4.x.x 4.x.x 自研探针 jettyclient 9.x.x 9.x.x 自研探针 mariadb3 3.x.x 3.x.x 自研探针 mybatis 3.x.x 3.x.x 自研探针 netty 4.x.x 4.x.x 自研探针 postgresql 42.x.x 42.x.x 自研探针 rabbitmq 5.x.x 5.x.x 自研探针 websocket 9.x.x 9.x.x 自研探针 elasticsearch 7.x.x 7.x.x 自研探针 oracle 10.x.x 10.x.x 自研探针 rocketmq 4.x.x 4.x.x 自研探针 kafka 2.x.x 2.x.x 自研探针 springCloudGateway 2.1.x~3.1.x - 自研探针 GaussDB 1.0.2.SPC180.B003 1.0.2.SPC180.B003 表2 skywalking探针JAVA组件信息 探针类型 组件 版本 skywalking探针 Tomcat 7~10 skywalking探针 Spring Boot Web 4.x skywalking探针 Spring MVC 3.x, 4.x 5.x with servlet 3.x skywalking探针 Spring MVC 6.x skywalking探针 Nutz Web Framework 1.x skywalking探针 Struts2 MVC 2.3.x~2.5.x skywalking探针 Resin 3~4 skywalking探针 Jetty Server 9.x~11.x skywalking探针 Spring WebFlux 5.x skywalking探针 Undertow 1.3.0~2.0.27 skywalking探针 RESTEasy 3.1.0~6.2.4 skywalking探针 Play Framework 2.6.x~2.8.x skywalking探针 Light4J Microservices Framework 1.6.x~2.x skywalking探针 Netty SocketIO 1.x skywalking探针 Micronaut HTTP Server 3.2.x~3.6.x skywalking探针 Jersey REST framework 2.x~3.x skywalking探针 Grizzly 2.3.x~4.x skywalking探针 WebSphere Liberty 23.x skywalking探针 Feign 9.x skywalking探针 Netflix Spring Cloud Feign 1.1.x~2.x skywalking探针 Okhttp 2.x~4.x skywalking探针 Spring RestTemplate 6.x skywalking探针 Jetty Client 9.x~11.x skywalking探针 Apache httpcomponent AsyncClient 4.x skywalking探针 AsyncHttpClient 2.1+ skywalking探针 JRE HttpURLConnection (Optional²) - skywalking探针 Hutool-http client 5.x skywalking探针 Micronaut HTTP Client 3.2.x~3.6.x skywalking探针 Spring Cloud Gateway 2.0.2.RELEASE~3.x skywalking探针 Apache ShenYu 2.4.x skywalking探针 Mysql Driver 5.x, 6.x, 8.x skywalking探针 H2 Driver 1.3.x~1.4.x skywalking探针 ShardingSphere 3.0.0, 4.0.0, 4.0.1, 4.1.0, 4.1.1, 5.0.0 skywalking探针 PostgreSQL Driver 8.x, 9.x, 42.x skywalking探针 Mariadb Driver 2.x, 1.8 skywalking探针 InfluxDB 2.5~2.17 skywalking探针 Mssql-Jtds 1.x skywalking探针 Mssql-jdbc 6.x~8.x skywalking探针 ClickHouse-jdbc 0.3.x skywalking探针 Apache-Kylin-Jdbc 2.6.x~ 4.x skywalking探针 Impala-jdbc 2.6.x skywalking探针 Dubbo 2.5.4~2.7.0 skywalking探针 Dubbox 2.8.4 skywalking探针 Apache Dubbo 2.7.x~3.x skywalking探针 Motan 0.2.x~1.1.0 skywalking探针 gRPC 1.x skywalking探针 Apache ServiceComb Java Chassis 1.x, 2.x skywalking探针 SOFARPC 5.4.0 skywalking探针 Armeria 0.63.0~1.22.0 skywalking探针 Apache Avro 1.7.0~1.8.x skywalking探针 Finagle 6.44.0~20.1.0 skywalking探针 Brpc-Java 2.3.7~3.0.5 skywalking探针 JSONRPC4J 1.2.0~1.6 skywalking探针 Nacos-Client 2.x skywalking探针 RocketMQ 3.x~5.x skywalking探针 RocketMQ-gRPC 5.x skywalking探针 Kafka 0.11.0.0~3.2.3 skywalking探针 Spring Kafka Consumer 1.3.x~2.3.x skywalking探针 ActiveMQ 5.10.0~5.15.4 skywalking探针 RabbitMQ 3.x~5.x skywalking探针 Pulsar 2.2.x~2.9.x skywalking探针 NATS 2.14.x~2.15.x skywalking探针 Aliyun ONS 1.x skywalking探针 aerospike 3.x~6.x skywalking探针 Jedis 2.x~4.x skywalking探针 redisson Easy Java Redis client 3.5.2+ skywalking探针 Lettuce 5.x skywalking探针 MongoDB Java Driver 2.13~2.14, 3.4.0~3.12.7, 4.0.0~4.1.0 skywalking探针 Spymemcached 2.x skywalking探针 Xmemcached 2.x skywalking探针 transport-client 5.2.x~5.6.x，6.2.3~6.8.4，7.0.0-7.5.2 skywalking探针 rest-high-level-client 6.7.1~6.8.4，7.0.0~7.5.2 skywalking探针 SolrJ 7.x skywalking探针 cassandra-java-driver 3.7.0~3.7.2 skywalking探针 hbase-client HTable 1.0.0-2.4.2 skywalking探针 Neo4j-java 4.x skywalking探针 Zookeeper 3.4.x skywalking探针 Spring Bean annotations 3.x~4.x skywalking探针 Spring Core Async SuccessCallback/FailureCallback/ListenableFutureCallback 4.x skywalking探针 Spring Transaction 4.x~5.x skywalking探针 Hystrix 1.4.20~1.5.18 skywalking探针 Sentinel 1.7.0~1.8.1 skywalking探针 Elastic Job 2.x skywalking探针 Apache ShardingSphere-Elasticjob 3.x skywalking探针 Spring @Scheduled 3.1+ skywalking探针 Quartz Scheduler 2.x skywalking探针 XXL Job 2.x skywalking探针 Canal 1.0.25~1.1.2 skywalking探针 GSON 2.8.x skywalking探针 Fastjson 1.2.x skywalking探针 Jackson 2.x skywalking探针 Vert.x Eventbus 3.2~4.x skywalking探针 Vert.x Web 3.x~4.x skywalking探针 Spring 4.x~5.x skywalking探针 Quasar 0.7.x skywalking探针 Ehcache 2.x skywalking探针 GuavaCache 18.~23.x skywalking探针 Coroutine 1.0.1~1.3.x skywalking探针 Graphql 8.0~17.x skywalking探针 Alibaba Druid 1.x skywalking探针 HikariCP 3.x~4.x skywalking探针 log4j 2.x skywalking探针 log4j2 1.2.x skywalking探针 logback 1.2.x skywalking探针 MyBatis 3.4.x~3.5.x skywalking探针 GuavaEventBus 19.x~31.x-jre skywalking探针 Undertow 2.1.x~2.6.x skywalking探针 Grizzly 2.3.x~4.x skywalking探针 Jetty 9.1.x~11.x 表3 Opentelemetry探针JAVA组件信息 探针类型 组件 版本 opentelemetry探针 Dubbo 2.7+ opentelemetry探针 Jedis 1.4+ opentelemetry探针 Lettuce 4.0+ opentelemetry探针 log4j 1.2+ opentelemetry探针 log4j2 2.11+ opentelemetry探针 httpclient 2.0+ opentelemetry探针 tomcat 7.0.x, 8.5.x, 9.0.x, 10.0.x opentelemetry探针 jetty 9.4.x, 10.0.x, 11.0.x opentelemetry探针 grpc 1.6+ opentelemetry探针 mongodb 3.1+ opentelemetry探针 redisson 3.0+ opentelemetry探针 c3p0 0.9.2+ opentelemetry探针 cassandra3 3.0+ opentelemetry探针 dbcp 2.0+ opentelemetry探针 httpasyncclient 4.1+ opentelemetry探针 jettyclient 9.2+(not including 10+ yet) opentelemetry探针 netty 3.8+ opentelemetry探针 rabbitmq 2.7+ opentelemetry探针 undertow 1.4+ opentelemetry探针 elasticsearch 5.0+ opentelemetry探针 oracle 11.2+ opentelemetry探针 rocketmq 4.8+ opentelemetry探针 kafka 2.7+

JavaAgent更新说明 目前仅支持主流的jdk8和jdk17，jdk17环境请选用末尾带-jdk17的版本。 下载Agent请参见探针下载地址。 表1 JavaAgent更新列表 版本号 更新说明 2.4.12 1、优化并发数递增逻辑。 2.4.12-profiler 1、优化Debugging诊断处理逻辑。 2.4.11-profiler 1、支持Profiler的Live Object Memory类型。 2、支持全采样设置。 2.4.10-profiler 1、支持Debugging诊断。 2.4.9-profiler 1、Profiler时延度量线程采集算法优化。 2.4.9 1、优化springbean启动时间。 2.4.8-profiler 1、Profiler支持性能优化推荐。 2.4.8 1、支持redisson支持3.17.x。 2、url接口调用支持分位数。 2.4.7-profiler 1.支持用户包数据采集。 2.4.7 1.支持sql字节数的配置。 2.支持springbean插件。 3.支持jedis2.9.3。 2.4.6-profiler 支持时延持续性能剖析。 2.4.5-profiler 支持CPU、内存持续性能剖析。 2.4.5-jdk17 新增支持httpclient5，仅支持同步场景。 2.4.5 指标采集队列增加老化机制。 2.4.4 新增支持SpringCloudGateway（2.1.x~3.1.x）。 2.4.3 1.修复异常数未清零问题。 2.修复日志过大问题。 3.新增redisson基本信息。 2.4.2-jdk17 该版本只支持jdk17。 2.4.2 支持FunctionGraph在启动时关闭agent。 2.4.1 1.支持动态修改指标采集阈值。 2.接口调用维度新增异常数，统计url中日志标记的异常。 3.新增通过代理传输数据的功能。 2.3.19 1.支持日志自动打印traceId。 2.提高线程详情上限。 2.3.17 1.AKSK可以从环境变量读取。 2.调用链增加sqlId。 3.sql增加最近调用链。 4.补齐接口调用的集群维度分析能力。 2.3.16 1.指定注册协议。 2.兼容ibm sdk不支持线程内存获取。 2.3.15 1.新增支持dubbo2.8.x版本。 2.新增支持JDKhttp子类。 2.3.13 1. CS E Provider bizcode支持多key。 2.支持hikari插件。 2.3.12 1.客户端统计时，hashmap的key数量溢出后，之前是停止采集，现在修改为继续采集。 2.Url支持自动规整能力，当在后台配置为自动规整后，url按照原始格式规整。 3.oracle插件补齐读取行数和更新行数能力。 4.CSE Provider提供显示bizCode的功能。 5.修复CSE Provider修复状态码400时调用链没有标红。 2.3.5 1.支持启动脚本配置access地址。 2.3.2 1.支持jetty-client。 2.取消对com.huawei.bsp.commonlib.roa.restclient的支持。 3.url支持采集apdex。 2.3.1 1.支持cce解密sk。 2.支持jedis拦截key和value。 3.支持cassandra3。 2.2.15 1.支持sk自定义解密。 2.支持在启动脚本中配置master地址。 3.支持apacheHttpclient的responseBody采集。 2.2.13 1.使NamedTransformer加载接口类时直接返回原字节码。 2.解决mariadb3.0.4 sql没有采集到的问题。 3.支持oracle。 2.2.10 1.支持gauss-zenith数据库。 2.支持com.huawei.bsp.commonlib.roa.restclient。 2.2.9 1.支持jetcd 5.x - 6.x。 2.支持采集netty直接内存。 表2 CCE和Servicestage界面上 JavaAgent latest版本指向说明 版本号 实际版本号 latest-x86_64 2.4.3，支持x86架构。 latest-aarch64 2.4.3，支持arm架构。 latest-noroot-x86_64 2.4.3，支持x86架构，支持非root用户身份运行容器。 latest-noroot-aarch64 2.4.3，支持arm架构，支持非root用户身份运行容器。 latest 2.1.17，兼容x86和arm架构。