当前位置：首页 > news >正文

Windows 环境 SkyWalking 完整实操教程

news 2026/6/15 1:36:39

一、SkyWalking 核心架构

SkyWalking有4大组件，零代码侵入监控Java微服务、链路追踪、指标监控、告警：

Agent探针（Java Agent）：依附你的Java进程，字节码增强，自动采集接口、SQL、MQ、RPC调用耗时、异常、TraceID，上报后端；不用改一行业务代码。
OAP服务端（Collector）：接收探针上报数据、聚合分析、计算指标，默认端口：11800(gRPC)、12800(HTTP)。
存储层：默认内置H2内存库（测试临时用，重启数据丢失）；生产改用Elasticsearch持久化。
UI控制台：可视化查看拓扑、调用链、慢接口、SQL耗时、JVM指标、告警，默认端口8080。

版本重要提醒：9.x+ 开始APM后端包、Java Agent探针包分开下载，不能共用一个压缩包。

二、Windows 部署SkyWalking后端

包括OAP+UI

1. 下载安装包

官网下载地址：官网
1）后端包：apache-skywalking-apm-x.x.x-bin.zip
2）Java探针包：apache-skywalking-java-agent-x.x.x.tgz

解压路径绝对不能有中文、空格、括号，示例解压到：D:\soft\skywalking-apm、D:\soft\skywalking-agent

2. Windows一键启动后端

进入OAP包的bin目录，双击startup.bat

会自动同时启动OAP收集服务 + UI网页服务，弹出两个黑窗口，不要关闭。
访问控制台：浏览器打开http://localhost:8080，默认账号密码admin/admin。

3. 常用端口说明

端口	作用
11800	Agent gRPC上报数据（探针必须连这个端口）
12800	Agent HTTP上报
8080	UI控制台访问端口

4. 存储切换

测试H2够用，生产必须ES

打开config/application.yml，修改storage：

storage:selector:${SW_STORAGE:h2}# selector: ${SW_STORAGE:elasticsearch} # 生产打开ES注释

H2内存库重启OAP数据清空，仅本地学习使用。

三、SpringBoot/Java项目接入Agent探针

前置说明

接入只需要加JVM启动参数，pom无需引入任何依赖、业务代码零修改，自动拦截SpringMVC、MyBatis、Dubbo、Kafka、Redis等主流组件。

方式1：IDEA开发环境配置

IDEA打开启动配置：Run/Debug Configurations→ 选中你的SpringBoot启动类
找到VM options，粘贴下面参数（修改探针绝对路径、服务名）

-javaagent:D:/soft/skywalking-agent/skywalking-agent.jar -Dskywalking.agent.service_name=order-service -Dskywalking.collector.backend_service=127.0.0.1:11800

参数解释：

-javaagent：指定探针jar绝对路径（Windows用正斜杠/，避免转义报错）
service_name：自定义服务英文名，控制台用来区分微服务
backend_service：OAP后端地址+gRPC端口

应用保存配置，重启SpringBoot项目，控制台日志输出SkyWalking加载日志即接入成功。

方式2：Jar包命令行启动（Windows cmd）

打包好xxx.jar后，cmd执行完整启动命令：

java -javaagent:D:/soft/skywalking-agent/skywalking-agent.jar ^ -Dskywalking.agent.service_name=goods-service ^ -Dskywalking.collector.backend_service=127.0.0.1:11800 ^ -jar goods-0.0.1-SNAPSHOT.jar

四、Agent常用配置优化（agent/config/agent.config）

# 1、服务名（也可JVM参数覆盖） agent.service_name=user-service # 2、OAP后端地址 collector.backend_service=127.0.0.1:11800 # 3、采样率：1=100%全采集（测试），生产0.3=30%采样减少存储压力 agent.sample_n_per_3_secs=1 # 4、忽略静态资源、健康检查接口，不生成链路 trace.ignore_path=/static/**,/actuator/**,/health

五、UI控制台五大核心功能实操

用于日常排查

1. 服务拓扑图

也叫微服务调用全景

左侧菜单Service → Service Topology

自动画出所有微服务、网关、数据库、MQ之间调用关系；
圆圈大小代表QPS，红色标异常报错服务，一眼定位哪个服务雪崩。

2. 调用链路追踪

排查慢接口/报错

菜单Traces

筛选服务、时间范围，可按响应耗时、异常状态码过滤；
点开一条Trace详情：完整展示一次请求全链路：
Gateway → Controller → Mapper SQL → Redis → MQ
每一段执行耗时、调用参数、异常堆栈全部展示；
经典排查场景：接口整体慢，点开发现某条SQL执行2s，直接定位慢SQL。