Java应用接入APM

Java应用接入APM

1. 登录APM控制台。
2. 在左侧导航栏中选择“应用监控 > 应用列表”。
3. 进入“接入应用”页面。
   • 首次接入应用时，单击“点击接入应用”，进入“接入应用”页面。
   • 已有探针接入时，在页面右上角，单击“接入应用”，进入“接入应用”页面。

4. 选择“区域”和“应用”。若未有应用，可单击“创建应用”，弹出“创建应用”弹窗，具体操作请参见创建应用。
5. “接入方式”选择SkyWalking。
6. “服务端语言”选择Java。
7. 数据接入。
   1. 下载SkyWalking。
      1. 前往Skywalking官网，推荐下载Java Agent 8.9.0及以上版本，解压后Agent文件放至在Java进程有访问权限的目录。

         如需配置插件，在启动阶段将新的插件放进“/plugins”目录中，即可令插件生效。将插件从该目录删除，即可令其失效。

         日志文件默认输出到“/logs”目录中。

   2. 添加启动命令并重启应用。
      1. 接入Agent配置相关参数，有如下两种配置方式：

         在应用程序的启动命令行中配置。

         java -javaagent:skywalking-agent-path -Dskywalking.collector.backend_service=**.**.**.**:**** -Dskywalking.agent.authentication=ZvL***ePqe -Dskywalking.agent.service_name=应用名称.组件名称.环境名称 -jar <yourApp>.jar

         在“agent/config/agent.config”中配置。

         collector.backend_service=**.**.**.**:****
         agent.authentication=ZvL3****Pqe
         agent.service_name=<应用名称.组件名称.环境名称>

         表1 启动命令参数说明

         参数	说明	是否必填
         skywalking-agent-path	探针安装路径，即探针下载后的存放路径。	必填
         Dskywalking.collector.backend_service	数据上报地址。	必填
         Dskywalking.agent.authentication	鉴权信息，获取信息方式请参见查看应用信息中获取“APPKEY”的值。	必填
         Dskywalking.agent.service_name	应用标识，三段式命名：应用名称.组件名称.环境名称。 应用名称，一个应用代表一个逻辑单元，是一个全局概念，各个region都可以看到相同的应用信息，比如一个租户下面比较独立的功能模块可以定义为一个应用。 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。	必填
         yourApp	用户所属的应用名称。	必填

         表2 agent.config配置参数

         参数	说明	是否必填
         collector.backend_service	数据上报地址。	必填
         agent.authentication	鉴权信息，获取信息方式请参见查看应用信息中获取“APPKEY”的值。	必填
         agent.service_name	应用标识，三段式命名：应用名称.组件名称.环境名称。 应用名称，一个应用代表一个逻辑单元，是一个全局概念，各个region都可以看到相同的应用信息，比如一个租户下面比较独立的功能模块可以定义为一个应用。 组件名称，代表一个组件，需要使用英文字符开头。同一个应用下，组件名称不能重复。一个组件可以包含多个环境。不能重复，如果要重复，使用instanceName区分。 环境名称，代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境，比如测试环境，现网环境。每个环境都在一个region部署，具有唯一的region属性。该参数可以为空，代表默认环境。	必填

      2. 配置javaagent路径，并重新启动应用。如果您两种方式均进行配置，则只有在启动命令行中的配置生效。

         java -javaagent:skywalking-agent-path -jar yourApp.jar 

         启动命令示例：

         java -javaagent:/root/my-dir/opentelemetry-javaagent.jar -Dskywalking.collector.backend_service=**.**.**.**:**** -Dskywalking.agent.authentication=ZvL******Pqe -Dskywalking.agent.service_name=<default.my-service.dev> -jar myApp.jar