更新时间:2026-01-21 GMT+08:00
分享

Java语言接入

操作步骤

  1. 登录APM控制台
  2. 单击左侧,选择“管理与监管 > 应用性能管理 APM”,进入APM服务页面。
  3. 在左侧导航栏中选择“应用监控 > 应用列表”。
  4. 单击“接入应用”,进入接入应用页面。
  5. 选择“区域”和“应用”。单击“创建应用”,弹出“创建应用”弹窗,可以具体操作参见创建应用
  6. “接入方式”选择Skywalking。
  7. “服务端语言”选择Java。
  8. 数据接入,相关参数与操作步骤如下。

    表1 参数说明

    参数

    说明

    是否必填

    应用名称

    应用显示的名称。一个应用代表一个逻辑单元,是一个全局概念,各个region都可以看到相同的应用信息,比如一个租户下面比较独立的功能模块可以定义为一个应用。

    必填

    组件名称

    组件名称,代表一个组件,需要使用英文字符开头。同一个应用下,组件名称不能重复。一个组件可以包含多个环境。不能重复,如果要重复,使用instanceName区分。

    必填

    环境名称

    环境名称,代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境,比如测试环境,现网环境。每个环境都在一个region部署,具有唯一的region属性。该参数可以为空,代表默认环境。

    选填

    环境标签

    环境标签,主要用于环境过滤,多个环境打上相同的环境标签,在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。

    选填

    应用英文名称

    应用英文名称,为全局概念。如果填写,则必须提前创建该应用。如果为空,则代表默认应用(开通APM时系统会自动创建一个默认应用)。

    选填

    子应用

    子应用,为全局概念,在应用下面子文件夹。该参数可以为空,为空代表资源挂载在根应用下面,子应用最多支持三层。比如 a/b/c,a、b、c各代表一层。

    选填

    用户应用

    用户所属的应用名称。

    必填

    1. 下载Skywalking。
      1. 前往Skywalking官网,推荐下载Java Agent 8.9.0及以上版本,解压后Agent文件放至在Java进程有访问权限的目录。

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

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

    2. 添加启动命令并重启应用。接入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=<应用名称.组件名称.环境名称>
      • 配置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

相关文档