通过SkyWalking上报Java应用数据

示例Demo

示例代码仓库地址：SkyWalking Demo

用SkyWalking为Java应用自动埋点

1. 下载SkyWalking Java Agent。

2. 修改 SkyWalking Java Agent 配置文件，设置接入信息和应用信息。

   collector.backend_service=<endpoint> // 替换为其他条件获取的接入点信息。
   agent.authentication=<token> // 替换为前提条件获取的鉴权Token。
   agent.service_name=<Service Name> // 替换为您实际的应用名称。

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正常连接服务端后，无法创建应用？

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