告别“盲人摸象”让每一次请求的轨迹都清晰可见前言在微服务架构横行的今天你是否遇到过这样的场景接口突然变慢你翻遍了三四个服务的日志却不知道瓶颈到底在哪线上报错用户说是下单时出的问题但你无法还原完整的调用链路服务依赖混乱新来的同事问你“这个服务到底调用了哪些下游”你只能画个大概的架构图这些问题的本质是你的系统缺乏可观测性。而 SkyWalking正是解决这些痛点的利器。本文将手把手带你从零搭建 SkyWalking 监控体系涵盖服务端部署、Spring Boot 应用接入、性能优化以及常见问题排查所有步骤均可直接复制使用。一、为什么微服务必须做链路追踪1.1 微服务架构下的三大痛点痛点具体表现传统方案的问题链路上下文丢失跨服务调用时无法关联日志和请求每个服务独立打日志无法串联故障定位低效出问题后逐个服务排查平均故障定位时间超过4小时-1性能瓶颈隐蔽不知道哪个环节是慢的元凶单点监控看不出全局耗时分布真实案例某电商公司大促期间下单接口突然从200ms飙升到5秒。运维团队查了网关、商品服务、库存服务、订单服务最后才发现是会员服务的一个慢SQL导致的。如果有链路追踪这个问题5分钟就能定位。1.2 为什么选择 SkyWalking对比维度ZipkinJaegerSkyWalking侵入性需引入依赖需引入依赖无侵入Java Agent语言支持多语言多语言Java/.NET/Node.js/Go性能分析基础基础内置JVM监控、慢查询分析服务拓扑需手动构建自动生成自动生成支持依赖分析告警能力弱中等内置告警规则引擎SkyWalking 的核心优势是无侵入、功能全、国产开源、社区活跃-5。二、SkyWalking 核心架构在动手部署之前先理解 SkyWalking 的三大组件-1┌─────────────────────────────────────────────────────────────┐ │ SkyWalking 架构 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Agent │───▶│ OAP │───▶│ Storage │ │ │ │ (探针) │ │ Server │ │ (ES/MySQL)│ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ │ │ ▼ │ │ │ │ ┌──────────┐ │ │ │ │ │ UI │◀───────────┘ │ │ │ │ (可视化) │ │ │ │ └──────────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌──────────────────────────────────────────┐ │ │ │ 业务应用 (Spring Boot) │ │ │ └──────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘组件职责Agent部署在业务应用中的探针通过字节码增强技术无侵入采集数据上报给 OAP Server-10OAP Server核心数据处理中心负责接收、分析、聚合、存储数据-6Storage存储链路数据生产环境推荐 Elasticsearch-1UI可视化仪表盘展示拓扑图、追踪详情、监控指标-5三、环境准备与版本选型3.1 版本兼容矩阵避坑指南版本不兼容是接入过程中最容易踩的坑。以下是生产验证过的稳定组合-1-5组件推荐版本说明Spring Boot2.6.x / 2.7.x3.x 需搭配 SkyWalking 9.xSkyWalking9.4.0 / 9.7.0最新稳定版Elasticsearch7.14.0 - 7.17.x8.x 需测试兼容性JDK11 / 178 也可用但推荐 11特别注意Spring Boot 3.x 使用jakarta命名空间必须搭配 SkyWalking 9.x 以上ES 7.x 和 8.x 有 breaking changes注意版本匹配-13.2 服务器资源配置场景CPU内存磁盘开发/测试2核4GB50GB生产小规模4核8GB100GB SSD生产大规模8核16GB根据数据量评估四、SkyWalking 服务端部署4.1 Docker Compose 一键部署推荐这是最快捷的部署方式适合开发/测试环境-5# docker-compose.yml version: 3.8 services: # Elasticsearch 存储 elasticsearch: image: elasticsearch:7.14.0 container_name: elasticsearch environment: - discovery.typesingle-node - ES_JAVA_OPTS-Xms512m -Xmx512m ports: - 9200:9200 volumes: - es_data:/usr/share/elasticsearch/data networks: - skywalking-net # SkyWalking OAP Server oap: image: apache/skywalking-oap-server:9.4.0 container_name: skywalking-oap depends_on: - elasticsearch environment: - SW_STORAGEelasticsearch - SW_STORAGE_ES_CLUSTER_NODESelasticsearch:9200 - SW_HEAP_SIZE1G ports: - 11800:11800 # gRPC 接收端口Agent 连接用 - 12800:12800 # HTTP 端口UI 查询用 networks: - skywalking-net # SkyWalking UI ui: image: apache/skywalking-ui:9.4.0 container_name: skywalking-ui depends_on: - oap environment: - SW_OAP_ADDRESShttp://oap:12800 ports: - 8080:8080 # UI 访问端口 networks: - skywalking-net volumes: es_data: networks: skywalking-net: driver: bridge启动命令docker-compose up -d # 查看启动状态 docker-compose ps # 查看日志 docker-compose logs -f验证部署访问http://你的服务器IP:8080看到 SkyWalking 登录界面即成功。默认用户名/密码admin/admin。4.2 生产环境配置优化生产环境需要调整以下配置-61. OAP 内存配置environment: - SW_HEAP_SIZE2G # 根据数据量调整建议 2G-4G - SW_GC_OPTS-XX:UseG1GC -XX:MaxGCPauseMillis2002. Elasticsearch 索引配置environment: - SW_STORAGE_ES_INDEX_SHARDS_NUMBER2 # 分片数 节点数 × 1.5 - SW_STORAGE_ES_INDEX_REPLICAS_NUMBER1 # 副本数高可用建议 13. 数据保留策略# 在 application.yml 中配置 storage: elasticsearch: # 链路数据保留7天 traceDataTTL: 7 # 指标数据保留30天 metricsDataTTL: 304.3 传统方式部署非 Docker# 1. 下载 SkyWalking 9.7.0 wget https://archive.apache.org/dist/skywalking/9.7.0/apache-skywalking-apm-9.7.0.tar.gz tar -zxvf apache-skywalking-apm-9.7.0.tar.gz -C /usr/local/ # 2. 配置存储修改 config/application.yml vim /usr/local/apache-skywalking-apm-9.7.0/config/application.yml # 将 storage.selector 改为 elasticsearch # 配置 elasticsearch.clusterNodes: localhost:9200 # 3. 启动 OAP Server 和 UI cd /usr/local/apache-skywalking-apm-9.7.0/bin ./oapService.sh start # 启动 OAP ./webappService.sh start # 启动 UI # 4. 检查进程 ps aux | grep skywalking五、Spring Boot 应用接入5.1 下载 AgentSkyWalking 对业务代码零侵入只需在启动时挂载 Agent-10。# Agent 已包含在 SkyWalking 安装包中 # 路径/apache-skywalking-apm-xxx/agent/ # 将 agent 目录复制到便于访问的位置 cp -r /usr/local/apache-skywalking-apm-9.7.0/agent /opt/skywalking-agent/Agent 目录结构agent/ ├── skywalking-agent.jar # 核心 jar 包 ├── config/ │ └── agent.config # 配置文件 ├── plugins/ # 插件目录支持的框架 ├── optional-plugins/ # 可选插件 └── logs/ # 日志目录5.2 本地开发环境配置IDEA在 IDEA 中配置 JVM 参数-1-5# Run → Edit Configurations → VM options -javaagent:/opt/skywalking-agent/skywalking-agent.jar -Dskywalking.agent.service_nameorder-service -Dskywalking.collector.backend_service127.0.0.1:118005.3 生产环境启动配置# JAR 包启动注意-javaagent 必须在 -jar 之前 java -javaagent:/opt/skywalking-agent/skywalking-agent.jar \ -Dskywalking.agent.service_nameorder-service \ -Dskywalking.collector.backend_service192.168.1.100:11800 \ -jar order-service.jar # 或使用环境变量 export SW_AGENT_NAMEorder-service export SW_AGENT_COLLECTOR_BACKEND_SERVICES192.168.1.100:11800 java -javaagent:/opt/skywalking-agent/skywalking-agent.jar -jar order-service.jar5.4 Agent 配置详解核心配置参数-3-9配置项说明默认值推荐值agent.service_name服务名称唯一标识Your_ApplicationName与业务服务名一致collector.backend_serviceOAP 地址127.0.0.1:11800生产环境 OAP 集群地址agent.sample_n_per_3_secs采样率每3秒采样数未配置全量生产10-50-5agent.authentication鉴权 Token未配置根据后端配置logging.level日志级别DEBUGINFO生产配置方式优先级从高到低-3代理选项-javaagent:...keyvalue系统属性-Dskywalking.xxxvalue环境变量SW_AGENT_NAMExxx配置文件agent/config/agent.config5.5 日志集成打印 TraceId将 TraceId 注入日志实现日志与链路的关联查询-10。Logback 配置logback-spring.xmlconfiguration appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder !-- 关键%X{tid} 输出 TraceId -- pattern%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%X{tid}] - %msg%n/pattern /encoder /appender root levelINFO appender-ref refCONSOLE/ /root /configuration效果日志中会自动包含 TraceId方便从 SkyWalking UI 反查日志。14:32:15.678 [http-nio-8080] INFO c.o.controller.OrderController [a1b2c3d4e5f6] - 收到下单请求六、验证与效果展示6.1 验证接入是否成功启动 Spring Boot 应用挂载 Agent调用几个接口产生链路数据访问 SkyWalking UIhttp://IP:8080检查清单服务列表中出现你的服务名服务拓扑图显示服务间的调用关系追踪列表能看到具体的请求链路6.2 UI 关键功能解读功能模块用途实战场景服务拓扑图可视化服务依赖关系新人快速了解系统架构-5追踪列表查看具体请求的完整链路定位慢请求的每个环节耗时端点列表查看每个接口的性能指标识别高频、高延迟接口JVM 监控查看 GC、内存、线程状态排查内存泄漏、GC 频繁-5告警配置阈值告警服务异常时第一时间通知七、高级配置与性能优化7.1 采样率配置生产环境关键全量采集会带来性能损耗和存储成本生产环境建议配置采样率-5-6# 每3秒采样10条适合 QPS 100-500 的服务 -Dskywalking.agent.sample_n_per_3_secs10 # 每3秒采样50条适合 QPS 500-2000 的服务 -Dskywalking.agent.sample_n_per_3_secs507.2 忽略健康检查等端点排除不必要的监控减少数据量-10# agent/config/agent.config agent.ignore_suffix.jpg,.png,.css,.js,/actuator/health,/actuator/info7.3 插件管理SkyWalking Agent 支持上百种框架插件-3# 查看已启用插件 ls /opt/skywalking-agent/plugins/ # 启用可选插件如 Spring Cloud Gateway cp /opt/skywalking-agent/optional-plugins/gateway-*.jar /opt/skywalking-agent/plugins/ # 禁用不需要的插件删除或移出 plugins 目录 rm /opt/skywalking-agent/plugins/unsupported-plugin.jar7.4 自定义方法追踪使用Trace注解追踪自定义方法-10!-- 添加依赖 -- dependency groupIdorg.apache.skywalking/groupId artifactIdapm-toolkit-trace/artifactId version9.4.0/version /dependencyimport org.apache.skywalking.apm.toolkit.trace.Trace; Service public class OrderService { Trace public void calculatePrice(Order order) { // 这个方法也会被追踪 // 在 UI 中会显示为单独的 Span } }八、常见问题排查8.1 数据丢失或不显示排查步骤-6检查 Agent 日志tail -f /opt/skywalking-agent/logs/skywalking-api.log验证网络连通性telnet OAP_IP 11800检查 OAP 是否正常接收查看 OAP 日志确认 ES 存储正常curl localhost:9200/_cat/indices | grep skywalking8.2 TraceId 在日志中不显示确认已将%X{tid}加入日志 pattern确认apm-toolkit-logback依赖已引入检查是否因异步线程导致上下文丢失8.3 Agent 导致应用启动变慢减少启用的插件数量降低采样率升级 Agent 到最新版本8.8.4 异步调用 TraceId 丢失使用 SkyWalking 提供的线程池包装类-1dependency groupIdorg.apache.skywalking/groupId artifactIdapm-toolkit-thread-pool/artifactId version9.4.0/version /dependencyimport org.apache.skywalking.apm.toolkit.trace.RunnableWrapper; // 使用包装类 executor.submit(RunnableWrapper.of(() - { // 业务逻辑TraceId 会自动传递 }));九、总结本文从零开始完整介绍了 SkyWalking 链路追踪体系的搭建过程阶段核心动作关键产出部署Docker Compose 一键部署可访问的 SkyWalking UI接入JVM 参数挂载 Agent应用数据上报验证调用接口查看 UI链路数据可视化优化配置采样率、忽略端点生产级稳定运行核心收益✅故障定位从几小时缩短到几分钟✅性能优化慢接口、慢 SQL 一目了然✅架构可视化服务依赖关系自动生成✅容量规划基于调用量数据评估服务承载能力-6下一步建议将 SkyWalking 集成到 CI/CD 流水线配置告警规则推送到钉钉/企业微信-5与 Prometheus Grafana 组合构建完整的可观测性体系-5你的微服务系统值得拥有这样一双“眼睛”。
SkyWalking 链路追踪实战：从零搭建微服务可观测性体系
发布时间：2026/5/19 6:50:11
告别“盲人摸象”让每一次请求的轨迹都清晰可见前言在微服务架构横行的今天你是否遇到过这样的场景接口突然变慢你翻遍了三四个服务的日志却不知道瓶颈到底在哪线上报错用户说是下单时出的问题但你无法还原完整的调用链路服务依赖混乱新来的同事问你“这个服务到底调用了哪些下游”你只能画个大概的架构图这些问题的本质是你的系统缺乏可观测性。而 SkyWalking正是解决这些痛点的利器。本文将手把手带你从零搭建 SkyWalking 监控体系涵盖服务端部署、Spring Boot 应用接入、性能优化以及常见问题排查所有步骤均可直接复制使用。一、为什么微服务必须做链路追踪1.1 微服务架构下的三大痛点痛点具体表现传统方案的问题链路上下文丢失跨服务调用时无法关联日志和请求每个服务独立打日志无法串联故障定位低效出问题后逐个服务排查平均故障定位时间超过4小时-1性能瓶颈隐蔽不知道哪个环节是慢的元凶单点监控看不出全局耗时分布真实案例某电商公司大促期间下单接口突然从200ms飙升到5秒。运维团队查了网关、商品服务、库存服务、订单服务最后才发现是会员服务的一个慢SQL导致的。如果有链路追踪这个问题5分钟就能定位。1.2 为什么选择 SkyWalking对比维度ZipkinJaegerSkyWalking侵入性需引入依赖需引入依赖无侵入Java Agent语言支持多语言多语言Java/.NET/Node.js/Go性能分析基础基础内置JVM监控、慢查询分析服务拓扑需手动构建自动生成自动生成支持依赖分析告警能力弱中等内置告警规则引擎SkyWalking 的核心优势是无侵入、功能全、国产开源、社区活跃-5。二、SkyWalking 核心架构在动手部署之前先理解 SkyWalking 的三大组件-1┌─────────────────────────────────────────────────────────────┐ │ SkyWalking 架构 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Agent │───▶│ OAP │───▶│ Storage │ │ │ │ (探针) │ │ Server │ │ (ES/MySQL)│ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ │ │ ▼ │ │ │ │ ┌──────────┐ │ │ │ │ │ UI │◀───────────┘ │ │ │ │ (可视化) │ │ │ │ └──────────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌──────────────────────────────────────────┐ │ │ │ 业务应用 (Spring Boot) │ │ │ └──────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘组件职责Agent部署在业务应用中的探针通过字节码增强技术无侵入采集数据上报给 OAP Server-10OAP Server核心数据处理中心负责接收、分析、聚合、存储数据-6Storage存储链路数据生产环境推荐 Elasticsearch-1UI可视化仪表盘展示拓扑图、追踪详情、监控指标-5三、环境准备与版本选型3.1 版本兼容矩阵避坑指南版本不兼容是接入过程中最容易踩的坑。以下是生产验证过的稳定组合-1-5组件推荐版本说明Spring Boot2.6.x / 2.7.x3.x 需搭配 SkyWalking 9.xSkyWalking9.4.0 / 9.7.0最新稳定版Elasticsearch7.14.0 - 7.17.x8.x 需测试兼容性JDK11 / 178 也可用但推荐 11特别注意Spring Boot 3.x 使用jakarta命名空间必须搭配 SkyWalking 9.x 以上ES 7.x 和 8.x 有 breaking changes注意版本匹配-13.2 服务器资源配置场景CPU内存磁盘开发/测试2核4GB50GB生产小规模4核8GB100GB SSD生产大规模8核16GB根据数据量评估四、SkyWalking 服务端部署4.1 Docker Compose 一键部署推荐这是最快捷的部署方式适合开发/测试环境-5# docker-compose.yml version: 3.8 services: # Elasticsearch 存储 elasticsearch: image: elasticsearch:7.14.0 container_name: elasticsearch environment: - discovery.typesingle-node - ES_JAVA_OPTS-Xms512m -Xmx512m ports: - 9200:9200 volumes: - es_data:/usr/share/elasticsearch/data networks: - skywalking-net # SkyWalking OAP Server oap: image: apache/skywalking-oap-server:9.4.0 container_name: skywalking-oap depends_on: - elasticsearch environment: - SW_STORAGEelasticsearch - SW_STORAGE_ES_CLUSTER_NODESelasticsearch:9200 - SW_HEAP_SIZE1G ports: - 11800:11800 # gRPC 接收端口Agent 连接用 - 12800:12800 # HTTP 端口UI 查询用 networks: - skywalking-net # SkyWalking UI ui: image: apache/skywalking-ui:9.4.0 container_name: skywalking-ui depends_on: - oap environment: - SW_OAP_ADDRESShttp://oap:12800 ports: - 8080:8080 # UI 访问端口 networks: - skywalking-net volumes: es_data: networks: skywalking-net: driver: bridge启动命令docker-compose up -d # 查看启动状态 docker-compose ps # 查看日志 docker-compose logs -f验证部署访问http://你的服务器IP:8080看到 SkyWalking 登录界面即成功。默认用户名/密码admin/admin。4.2 生产环境配置优化生产环境需要调整以下配置-61. OAP 内存配置environment: - SW_HEAP_SIZE2G # 根据数据量调整建议 2G-4G - SW_GC_OPTS-XX:UseG1GC -XX:MaxGCPauseMillis2002. Elasticsearch 索引配置environment: - SW_STORAGE_ES_INDEX_SHARDS_NUMBER2 # 分片数 节点数 × 1.5 - SW_STORAGE_ES_INDEX_REPLICAS_NUMBER1 # 副本数高可用建议 13. 数据保留策略# 在 application.yml 中配置 storage: elasticsearch: # 链路数据保留7天 traceDataTTL: 7 # 指标数据保留30天 metricsDataTTL: 304.3 传统方式部署非 Docker# 1. 下载 SkyWalking 9.7.0 wget https://archive.apache.org/dist/skywalking/9.7.0/apache-skywalking-apm-9.7.0.tar.gz tar -zxvf apache-skywalking-apm-9.7.0.tar.gz -C /usr/local/ # 2. 配置存储修改 config/application.yml vim /usr/local/apache-skywalking-apm-9.7.0/config/application.yml # 将 storage.selector 改为 elasticsearch # 配置 elasticsearch.clusterNodes: localhost:9200 # 3. 启动 OAP Server 和 UI cd /usr/local/apache-skywalking-apm-9.7.0/bin ./oapService.sh start # 启动 OAP ./webappService.sh start # 启动 UI # 4. 检查进程 ps aux | grep skywalking五、Spring Boot 应用接入5.1 下载 AgentSkyWalking 对业务代码零侵入只需在启动时挂载 Agent-10。# Agent 已包含在 SkyWalking 安装包中 # 路径/apache-skywalking-apm-xxx/agent/ # 将 agent 目录复制到便于访问的位置 cp -r /usr/local/apache-skywalking-apm-9.7.0/agent /opt/skywalking-agent/Agent 目录结构agent/ ├── skywalking-agent.jar # 核心 jar 包 ├── config/ │ └── agent.config # 配置文件 ├── plugins/ # 插件目录支持的框架 ├── optional-plugins/ # 可选插件 └── logs/ # 日志目录5.2 本地开发环境配置IDEA在 IDEA 中配置 JVM 参数-1-5# Run → Edit Configurations → VM options -javaagent:/opt/skywalking-agent/skywalking-agent.jar -Dskywalking.agent.service_nameorder-service -Dskywalking.collector.backend_service127.0.0.1:118005.3 生产环境启动配置# JAR 包启动注意-javaagent 必须在 -jar 之前 java -javaagent:/opt/skywalking-agent/skywalking-agent.jar \ -Dskywalking.agent.service_nameorder-service \ -Dskywalking.collector.backend_service192.168.1.100:11800 \ -jar order-service.jar # 或使用环境变量 export SW_AGENT_NAMEorder-service export SW_AGENT_COLLECTOR_BACKEND_SERVICES192.168.1.100:11800 java -javaagent:/opt/skywalking-agent/skywalking-agent.jar -jar order-service.jar5.4 Agent 配置详解核心配置参数-3-9配置项说明默认值推荐值agent.service_name服务名称唯一标识Your_ApplicationName与业务服务名一致collector.backend_serviceOAP 地址127.0.0.1:11800生产环境 OAP 集群地址agent.sample_n_per_3_secs采样率每3秒采样数未配置全量生产10-50-5agent.authentication鉴权 Token未配置根据后端配置logging.level日志级别DEBUGINFO生产配置方式优先级从高到低-3代理选项-javaagent:...keyvalue系统属性-Dskywalking.xxxvalue环境变量SW_AGENT_NAMExxx配置文件agent/config/agent.config5.5 日志集成打印 TraceId将 TraceId 注入日志实现日志与链路的关联查询-10。Logback 配置logback-spring.xmlconfiguration appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder !-- 关键%X{tid} 输出 TraceId -- pattern%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} [%X{tid}] - %msg%n/pattern /encoder /appender root levelINFO appender-ref refCONSOLE/ /root /configuration效果日志中会自动包含 TraceId方便从 SkyWalking UI 反查日志。14:32:15.678 [http-nio-8080] INFO c.o.controller.OrderController [a1b2c3d4e5f6] - 收到下单请求六、验证与效果展示6.1 验证接入是否成功启动 Spring Boot 应用挂载 Agent调用几个接口产生链路数据访问 SkyWalking UIhttp://IP:8080检查清单服务列表中出现你的服务名服务拓扑图显示服务间的调用关系追踪列表能看到具体的请求链路6.2 UI 关键功能解读功能模块用途实战场景服务拓扑图可视化服务依赖关系新人快速了解系统架构-5追踪列表查看具体请求的完整链路定位慢请求的每个环节耗时端点列表查看每个接口的性能指标识别高频、高延迟接口JVM 监控查看 GC、内存、线程状态排查内存泄漏、GC 频繁-5告警配置阈值告警服务异常时第一时间通知七、高级配置与性能优化7.1 采样率配置生产环境关键全量采集会带来性能损耗和存储成本生产环境建议配置采样率-5-6# 每3秒采样10条适合 QPS 100-500 的服务 -Dskywalking.agent.sample_n_per_3_secs10 # 每3秒采样50条适合 QPS 500-2000 的服务 -Dskywalking.agent.sample_n_per_3_secs507.2 忽略健康检查等端点排除不必要的监控减少数据量-10# agent/config/agent.config agent.ignore_suffix.jpg,.png,.css,.js,/actuator/health,/actuator/info7.3 插件管理SkyWalking Agent 支持上百种框架插件-3# 查看已启用插件 ls /opt/skywalking-agent/plugins/ # 启用可选插件如 Spring Cloud Gateway cp /opt/skywalking-agent/optional-plugins/gateway-*.jar /opt/skywalking-agent/plugins/ # 禁用不需要的插件删除或移出 plugins 目录 rm /opt/skywalking-agent/plugins/unsupported-plugin.jar7.4 自定义方法追踪使用Trace注解追踪自定义方法-10!-- 添加依赖 -- dependency groupIdorg.apache.skywalking/groupId artifactIdapm-toolkit-trace/artifactId version9.4.0/version /dependencyimport org.apache.skywalking.apm.toolkit.trace.Trace; Service public class OrderService { Trace public void calculatePrice(Order order) { // 这个方法也会被追踪 // 在 UI 中会显示为单独的 Span } }八、常见问题排查8.1 数据丢失或不显示排查步骤-6检查 Agent 日志tail -f /opt/skywalking-agent/logs/skywalking-api.log验证网络连通性telnet OAP_IP 11800检查 OAP 是否正常接收查看 OAP 日志确认 ES 存储正常curl localhost:9200/_cat/indices | grep skywalking8.2 TraceId 在日志中不显示确认已将%X{tid}加入日志 pattern确认apm-toolkit-logback依赖已引入检查是否因异步线程导致上下文丢失8.3 Agent 导致应用启动变慢减少启用的插件数量降低采样率升级 Agent 到最新版本8.8.4 异步调用 TraceId 丢失使用 SkyWalking 提供的线程池包装类-1dependency groupIdorg.apache.skywalking/groupId artifactIdapm-toolkit-thread-pool/artifactId version9.4.0/version /dependencyimport org.apache.skywalking.apm.toolkit.trace.RunnableWrapper; // 使用包装类 executor.submit(RunnableWrapper.of(() - { // 业务逻辑TraceId 会自动传递 }));九、总结本文从零开始完整介绍了 SkyWalking 链路追踪体系的搭建过程阶段核心动作关键产出部署Docker Compose 一键部署可访问的 SkyWalking UI接入JVM 参数挂载 Agent应用数据上报验证调用接口查看 UI链路数据可视化优化配置采样率、忽略端点生产级稳定运行核心收益✅故障定位从几小时缩短到几分钟✅性能优化慢接口、慢 SQL 一目了然✅架构可视化服务依赖关系自动生成✅容量规划基于调用量数据评估服务承载能力-6下一步建议将 SkyWalking 集成到 CI/CD 流水线配置告警规则推送到钉钉/企业微信-5与 Prometheus Grafana 组合构建完整的可观测性体系-5你的微服务系统值得拥有这样一双“眼睛”。
