概述
随着业务增长,接口性能监控需求日益重要。本文介绍如何在 Java 老项目中集成 SkyWalking 进行链路追踪与性能分析。
1. 准备工作
下载 SkyWalking Java Agent
从官网下载对应版本的 Java Agent 包(建议使用与后端版本一致的旧版本以兼容 JDK8)。
解压 Agent 包
将下载的压缩包解压到项目所在服务器的合适位置:
tar -zxvf apache-skywalking-java-agent-8.9.0.tgz
mv apache-skywalking-java-agent-8.9.0 skywalking-agent
2. 配置 Agent
编辑 skywalking-agent/config/agent.config 文件,配置核心参数:
# 服务名称(在 SkyWalking UI 中显示的服务名称)
agent.service_name=${SW_AGENT_NAME:your-service-name}
# SkyWalking 后端地址(OAP Server)
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}
# 采样率(每 3 秒采集的链路数据,0 表示不采集,-1 为全量采样仅用于调试)
agent.sample_n_per_3_secs=${SW_AGENT_SAMPLE:100}
可选配置项:
agent.namespace:命名空间,用于区分不同环境agent.sample_n_per_3_secs:调整采样率以控制性能影响agent.trace_segment_ref_limit_per_span:限制链路 Span 数量
3. 启动应用时集成 Agent
命令行启动
java -javaagent:./skywalking-agent/skywalking-agent.jar \
-Dskywalking.agent.service_name=your-service-name \
-Dskywalking.collector.backend_service=127.0.0.1:11800 \
-jar your-application.jar
IDEA 集成
在 VM Options 中添加以下参数:
-javaagent:./skywalking-agent/skywalking-agent.jar
-Dskywalking.agent.service_name=your-service-name
-Dskywalking.collector.backend_service=127.0.0.1:11800
注:11800 端口是 OAP Service 默认接收端口。
4. 部署 SkyWalking 服务端
下载 SkyWalking APM
从官网下载对应版本的 apm 包并解压:
tar -zxvf apache-skywalking-apm-8.9.0.tar.gz
配置 WebUI
配置文件位于 webapp/webapp.yml,主要配置项包括:
- 修改监听端口(可选)
server:
port: 8080
address:





