可观测链路 OpenTelemetry 版：通过SkyWalking上报Java应用数据

示例Demo

示例代码仓库地址：SkyWalking Demo

用SkyWalking为Java应用自动埋点

1. 打开config/agent.config，配置接入点和令牌。

   说明

   请将<endpoint>和<auth-token>分别替换成控制台集群配置 > 接入点信息页面上SkyWalking客户端在相应地域的接入点和鉴权令牌。关于获取方法，请参见前提条件。

   collector.backend_service=<endpoint>
   agent.authentication=<auth-token>

2. 采用以下方法之一配置应用名称（Service Name）。

   重要

   请将<ServiceName>替换为您的应用名称。如果同时采用以下两种方法，则仅第二种方法（在启动命令行中添加参数）生效。

   • 打开config/agent.config，配置应用名称。

     agent.service_name=<ServiceName>

   • 在应用程序的启动命令行中添加-Dskywalking.agent.service_name参数。

     java -javaagent:<skywalking-agent-path> -Dskywalking.agent.service_name=<ServiceName> -jar yourApp.jar

3. 根据应用的运行环境，选择相应的方法来指定SkyWalking Agent的路径。

   说明

   请将以下示例代码中的<skywalking-agent-path>替换为Agent文件夹中的skywalking-agent.jar的绝对路径。

   • Linux Tomcat 7 / Tomcat 8

     在tomcat/bin/catalina.sh第一行添加以下内容：

     CATALINA_OPTS="$CATALINA_OPTS -javaagent:<skywalking-agent-path>"; export CATALINA_OPTS

   • Windows Tomcat 7 / Tomcat 8

     在tomcat/bin/catalina.bat第一行添加以下内容：

     set "CATALINA_OPTS=-javaagent:<skywalking-agent-path>"

   • JAR File或Spring Boot

     在应用程序的启动命令行中添加-javaagent参数。

     重要

     -javaagent参数一定要在-jar参数之前。

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

   • Jetty

     在{JETTY_HOME}/start.ini配置文件中添加以下内容：

     --exec    # 去掉前面的井号取消注释。
     -javaagent:<skywalking-agent-path>

4. 重新启动应用。

Java Agent可配置属性

SkyWalking Java Agent支持丰富的用户可配置属性。完整的属性配置详情，请参见示例Demo的config/agent.config文件。

属性列表（部分）

以下属性以apache-skywalking-java-agent-8.16.0为准。

配置方式

系统属性

使用-Dskywalking. + agent.config配置文件的key。例如：

# 通过系统属性配置agent.service_name
java -javaagent:/path/to/skywalking-agent.jar -Dskywalking.agent.service_name=<your_service_name> -jar your-project.jar

代理选项

在JVM参数中的代理路径之后添加属性即可。

# 模板
-javaagent:/path/to/skywalking-agent.jar=[key1]=[value1],[key2]=[value2]

# 举例
java -javaagent:/path/to/skywalking-agent.jar=agent.service_name=<your-service-name>,agent.authentication=<your-token> -jar your-project.jar

系统环境变量

将属性配置成系统环境变量，skywalking-agent会自动获取。可以在config/agent.config文件中查询具体属性对应的系统环境变量，例如agent.service_name的系统环境变量为SW_AGENT_NAME。

agent.service_name=${SW_AGENT_NAME:default_name}

# 配置环境变量
export SW_AGENT_NAME=<your_service_name>

优先级

以上配置方式的优先级从高到低依次为代理选项、系统属性、系统环境变量、配置文件。

Java Agent插件

SkyWalking Java Agent支持多种中间件、框架和库。支持的所有插件可在示例Demo的/plugins文件夹下查看。

激活插件

所有在/plugins文件夹下的插件都是已被激活的插件。若从/plugins中移除某个插件的jar包，则表示插件不可用。

官方已支持插件

官方支持的插件都已在/plugins文件夹下。

可选插件

Java Agent的插件支持可插拔。在Agent或第三方仓库的optional-plugins文件夹下提供了可选的插件。 想要使用可选插件，可以将对应插件移动到/plugins文件夹下。

Bootstrap类插件

由于意外风险，所有Bootstrap插件都是可选的。Bootstrap插件在bootstrap-plugins文件夹中。若需要使用这些插件，可以将目标插件的jar文件放入/plugins文件夹下。

支持插件列表

关于下面的插件，官方认为可能存在性能影响或者使用限制，所以只在第三方仓库发布。更多信息请参见SkyAPM Java插件扩展仓库。

插件开发

您可以参考官方文档自定义开发一个SkyWalking Java Agent Plugin。

可观测链路 OpenTelemetry 版支持Trace上报，您可以参考官方文档开发一个自定义的Trace Plugin。

常见问题

问：SkyWalking正常连接服务端后，无法创建应用？

如果未产生数据上报，则可能原因是：开启采样、设置过滤或未触发生成链路追踪的请求。