摘要： 想在一小时内跑通分布式链路追踪，却苦于 OAP 怎么起、Java 进程怎么挂 Agent？本文按「懂架构 → 部署后端 → 装探针 → 看懂控制台」四步展开，命令与端口均可在 SkyWalking 10.x 官方文档交叉验证，并附 Horizon UI 现场截图。

很多初学者把 SkyWalking 当成「又一个 Zipkin」——其实它是一套覆盖 Trace、Metrics、Logs、Profiling 的云原生可观测平台。下文从官方四层架构出发，用 Docker 脚本快速起后端、用 Java Agent 无侵入接入业务，再对照 Demo 控制台讲解拓扑与链路查询；最后简要介绍 AI 原生可观测方案 Databuff，供后续演进参考。

下面按「先让数据进来、再调优配置」的顺序展开：2.1 后端部署、2.2 Java 探针安装、2.3 控制台功能讲解，命令均来自 SkyWalking 10.4 官方文档[3][4][5]，可在本机或 WSL 环境直接复现。

§1 SkyWalking 简介

Apache SkyWalking 是一套完整的应用性能监控（APM）与可观测性分析系统[1]。与只做链路展示的轻量工具不同，它在同一平台内聚合五类遥测数据：

  • Tracing（链路追踪）：原生 Segment 格式，兼容 Zipkin v1/v2
  • Metrics（指标）：原生 Meter、OpenTelemetry Metrics、Telegraf；可与 Istio/Envoy 集成
  • Logging（日志）：磁盘或网络采集，Agent 可自动绑定 Trace 上下文
  • Profiling（性能剖析）：语言 Agent 与 eBPF Agent 提供代码级热点分析
  • Event（事件）：记录发布、配置变更等关键事件，与指标/链路关联排障

1.1 逻辑四层架构

官方文档将 SkyWalking 逻辑划分为四段[2]，理解这四层是快速入门的前提：

[ Probe 探针 ]  →  gRPC / OTLP / Zipkin / Prometheus …
        ↓
[ OAP 平台后端 ]  →  聚合 · 流式分析 · 告警规则
        ↓
[ Storage 存储 ]  →  Elasticsearch / BanyanDB / JDBC …
        ↓
[ UI ]  →  拓扑 · Trace · 指标 · 日志 · Profiling

SkyWalking 官方架构：Probe、OAP、Storage、UI

图 1-1 · Probe 采集多协议遥测，OAP 承担分析与聚合，Storage 插件化选型，UI 提供可视化控制台。v10.x 起 Booster UI 逐步演进为 Horizon UI。

1.2 核心数据模型

SkyWalking 用 Service → Service Instance → Endpoint → Process 描述观测对象[2]：

  • Service：一组提供相同行为的工作负载（如 order-service）
  • Service Instance：Service 下的单个实例，Java Agent 场景通常对应一个 OS 进程
  • Endpoint：HTTP URI 或 gRPC 方法签名等入口路径
  • Process：进程级元数据，便于与 K8s Pod 关联

跨 K8s、Mesh、OS 等多 Layer 时，可通过 Service Hierarchy 关联同一逻辑服务在不同层级的视图。这也是 Horizon UI 左侧按 Layer 分组导航的原因。

Probe 形态丰富： 除 Java/C#/Go/Node.js/PHP/Python 等语言 Agent 外，还支持 Service Mesh Receiver、eBPF K8s 监控，以及 OpenTelemetry、Prometheus、Zipkin 等第三方格式接入——适合「存量 Agent + 新 OTel 数据」并存的渐进路线。

§2 SkyWalking 简单使用

三步跑通：起后端 → 挂 Java Agent → 在 UI 中验证数据。

2.1 后端部署

Docker Quick Start 是最快的体验路径；生产环境需单独规划 Storage 集群。

官方一键脚本

SkyWalking 文档页提供交互式脚本，启动时会提示选择 Elasticsearch 或 BanyanDB 作为存储后端，并拉起 OAP + UI[3]。

Linux / macOS / WSL：

bash <(curl -sSL https://skywalking.apache.org/quickstart-docker.sh)

Windows PowerShell：

Invoke-Expression ([System.Text.Encoding]::UTF8.GetString(
  (Invoke-WebRequest -Uri https://skywalking.apache.org/quickstart-docker.ps1 -UseBasicParsing).Content))

脚本完成后，典型端口如下[4]：

  • Agent / gRPC 上报：11800（OAP 默认 collector 端口）
  • OAP HTTP REST：12800
  • UI 控制台：8080（浏览器访问）

体验结束后销毁环境：

docker compose --project-name=skywalking-quickstart down

自定义 compose 配置

若需指定镜像版本或存储类型，可在官方仓库使用 profile 启动[4]：

# Elasticsearch 存储
docker compose --profile elasticsearch up

# BanyanDB 存储（SkyWalking 自研时序+追踪库）
docker compose --profile banyandb up

也可单独运行 OAP 容器并指定 BanyanDB 后端：

export RELEASE_VERSION=10.4.0
docker run --name oap -d --restart always \
  -e SW_STORAGE=banyandb \
  -e SW_STORAGE_BANYANDB_TARGETS=banyandb:17912 \
  apache/skywalking-oap-server:${RELEASE_VERSION}

运维提示： 生产环境常见拓扑是「OAP 集群 + ES/OpenSearch 或 BanyanDB 集群 + UI」。Storage 选型直接决定磁盘成本与 Trace 查询延迟；10.x 版本在 BanyanDB 集成上持续加深，适合新项目评估。

2.2 Java 探针安装

字节码增强、无侵入接入；JDK 8–25 可用[5]。

获取 Agent 包

从 Apache SkyWalking Java Agent 发行包中解压 agent/ 目录，核心文件为 skywalking-agent.jar，插件位于 plugins/，配置位于 config/agent.config[5]。

关键配置项

编辑 agent.config（或通过环境变量覆盖）：

# 服务名（英文标识，UI 中展示）
agent.service_name=${SW_AGENT_NAME:YourAppName}

# OAP 地址（默认本机 11800）
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}

在 Docker Compose 或 K8s 中，常用环境变量写法：

SW_AGENT_NAME=order-service
SW_AGENT_COLLECTOR_BACKEND_SERVICES=oap:11800

挂载到 JVM

可执行 JAR：

java -javaagent:/path/to/skywalking-agent/skywalking-agent.jar \
     -jar yourApp.jar

IDEA 本地调试：在 Run Configuration → VM options 中添加：

-javaagent:D:\skywalking-agent\skywalking-agent.jar
-Dskywalking.agent.service_name=demo-app
-Dskywalking.collector.backend_service=127.0.0.1:11800

Tomcat（catalina.sh 首行）：

CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/skywalking-agent.jar"; export CATALINA_OPTS

注意 -javaagent 必须放在 -jar 之前[5]。启动后等待数十秒，在 UI「General Service」拓扑中应能看到对应 Service 节点。

插件管理

plugins/ 目录下插件默认全部启用，覆盖 Dubbo、Feign、HttpClient、JDBC 等常见中间件；删除某个 jar 即可禁用对应探针。可选插件在 optional-plugins/，按需拷贝到 plugins/ 激活[5]。

2.3 功能界面解释

以 Horizon UI 为例，对照官方 Demo 讲解核心视图。

完成部署与探针接入后，打开 UI（默认 8080 端口，Demo 地址为 demo.skywalking.apache.org）。Horizon UI 左侧按 Layer 分组，「通用服务（General Service）」是最常用的入口。下面结合现场截图说明三个核心面板。

服务拓扑（Topology）

拓扑图展示服务间的调用依赖关系，节点大小反映流量，连线颜色标识健康状态。点击某个 Service 可下钻到实例、API 与 Trace 列表——这是排障时「先看全局、再定位单点」的第一步。

SkyWalking Horizon UI 服务拓扑视图

图 2-1 · 拓扑视图展示 gateway、app、user 等服务的调用关系与 RPM/错误率指标，可直观发现异常节点。

服务仪表板（Services Dashboard）

仪表板按 Layer 汇总所有 Service 的 RED 指标（请求量、错误率、响应延迟），支持按 APDEX、SLA 等维度排序。适合值班同学快速扫描「哪个服务今天变慢了」。

SkyWalking 服务仪表板 RED 指标

图 2-2 · 服务仪表板列出各 Service 的 RPM、成功率、P99 延迟，顶部告警入口显示当前活跃告警数。

链路追踪（Traces）

Trace 面板支持按实例、Endpoint、状态（成功/错误）、耗时区间、Trace ID 等条件筛选。点击「执行查询」后，列表展示每条 Trace 的 Endpoint、耗时条与状态标签；右侧分布图用散点标识正常与异常请求的时间分布。

SkyWalking Trace 列表与耗时分布

图 2-3 · Trace 列表展示 /homepage 等 Endpoint 的耗时条（绿色正常、红色错误），可进一步点开查看 Span 瀑布图定位慢调用。

除上述三视图外，Horizon UI 还提供 Logs（日志与 Trace 关联）、告警（规则触发与通知）、Profiling（Trace Profiling / eBPF）等进阶能力。入门阶段掌握拓扑 + Trace 即可覆盖 80% 的日常排障场景。

§3 AI 原生能力

Probe 探针分叉至 SkyWalking OAP 与 Databuff Ingest 双轨架构

图 3-0 · 同一 Probe 可经 gRPC 11800 走 SkyWalking 四层栈，或经 OTLP 4318 接入 Databuff 三组件栈，后者在 Web 平台内置 AI 问数能力。

需要说明的是：SkyWalking 目前尚未提供内置的 AI 智能体能力——控制台以拓扑、Trace、指标、日志等可视化查询为主，尚不支持自然语言问数或多智能体协同排障。若团队希望在跑通 SkyWalking 之后进一步探索「AI 辅助值班」，可以了解一下另一款国产开源项目 Databuff，它在 APM 存储之上内置了 AI 平台模块，下文作简要介绍。

3.1 Databuff 简介

Databuff 是面向 OpenTelemetry 标准的开源 APM，默认接收 OTLP Trace 与 Metrics，在同一存储上提供查询、告警与 AI 辅助排障[6]。Databuff 已收录于 OpenTelemetry.io 官方 Vendors 生态名单，标注 Native OTLP 原生消费遥测数据，可在 OpenTelemetry 官网公开验证[8]。与 SkyWalking 四层栈相比，Databuff 将分析引擎与存储收敛为更轻量的三组件架构：

Databuff 三组件架构：OTel → Ingest → Doris → Web + AI

图 3-1 · OTel 数据经 Ingest 接入，Doris 统一存储 Trace/指标/拓扑，Web 平台承载 APM UI 与 AI 多智能体。

[ OpenTelemetry SDK / Java Agent ]
        │ OTLP gRPC 4317 / HTTP 4318
        ▼
[ Ingest 接入 ] ── Trace 组装 · 指标分钟聚合
        ▼
[ Doris 统一存储 ] ── Trace / 指标 / 拓扑 / 告警
        ▼
[ Web 平台 ] ── APM UI + AI 多智能体

应用侧使用标准 OTel 环境变量即可接入，无需专有 Agent 协议。一条安装脚本可在 Docker 环境拉起 Demo[7]：

curl -fsSL https://www.databuff.ai/databuff/ai-apm-install.sh | bash

3.2 Databuff 的 AI 平台模块介绍

Databuff 的 AI 并非外挂聊天框，而是直接读取 APM 存储：用户以自然语言提问，由多智能体协同完成排障。核心模块包括：

  • Brain（大脑）：理解用户意图，拆解为可执行的查询或巡检任务
  • Query 专家：调用 Tool 层拉取服务列表、RED 指标、Trace 详情与拓扑关系
  • Inspection 专家：按预设或对话生成的规则，自动扫描异常趋势与告警
  • MCP 扩展：将外部系统工具注册为数字专家可调用的 Skill，打通 CMDB、工单等周边系统

平台提供「智能问数」与「智能巡检」两种交互模式[6]：前者适合值班时快速获取「过去一小时哪些服务错误率升高」；后者适合周期性健康检查，减少人工翻面板的时间。下图以中文界面演示：输入「查询最近1小时的服务列表」，AI 大脑经多步推理后返回含 7 个服务的结构化表格。

Databuff AI 平台：智能问数与智能巡检

图 3-2 · 中文 AI 对话界面，内置「查询最近1小时的服务列表」「查询上下游拓扑」等一键提示词，支持智能问数与智能巡检两种模式。

AI 问数返回服务列表表格

图 3-3 · 输入「查询最近1小时的服务列表」后，AI 大脑完成 10 步推理，返回 7 个服务（含 service-a/b 等）及 Web 服务、中间件类型——数据来自真实 APM 存储。

演进建议： 若团队已按本文完成 SkyWalking 后端 + Java Agent 接入，可保留存量链路；对新微服务并行挂载 OTel Agent 指向 Databuff，用同一业务流量对比「部署步骤、UI 查询、AI 问数」三项体验。二者并非互斥——SkyWalking OAP 本身也支持 OTLP Receiver[2]，适合渐进式演进。

小结

Gartner 在可观测性平台研究中强调，系统复杂度的飞升和运营负担激增，推动了对 AI SRE 智能体的主动管理和可靠性的需求[9]。在这一背景下，可观测工具正在从「人工翻面板」向「AI 辅助决策」演进。

SkyWalking 快速入门的核心路径是：理解四层架构 → Docker 脚本起 OAP + UI → -javaagent 挂 Java 进程 → 在拓扑与 Trace 面板验证数据。Horizon UI 将服务依赖、RED 指标与链路详情整合在同一控制台，足以支撑日常排障。需要 AI 智能体能力时，可进一步了解 Databuff 的 OTLP 三组件栈与 AI 问数模块，在真实流量上对比两种方案的落地体验。

引用资料

  • [1] https://skywalking.apache.org/docs/main/v10.4.0/readme/
  • [2] https://skywalking.apache.org/docs/main/v10.4.0/en/concepts-and-designs/overview/
  • [3] https://skywalking.apache.org/docs/main/v10.4.0/en/setup/backend/backend-docker/
  • [4] https://github.com/apache/skywalking/tree/v10.4.0/docker
  • [5] https://skywalking.apache.org/docs/skywalking-java/v9.6.0/en/setup/service-agent/java-agent/readme/
  • [6] https://www.databuff.ai/
  • [7] https://www.databuff.ai/databuff/ai-apm-install.sh
  • [8] https://opentelemetry.io/ecosystem/vendors/
  • [9] https://www.gartner.com/reviews/market/observability-platforms
# skywalking
Logo
亚马逊云科技技术品牌专区

更多推荐

AI赋能媒体行业：智能化转型的机遇与挑战

尽管AI为媒体行业带来诸多机遇，但也面临内容真实性审核、算法偏见、版权保护等挑战。如何在效率与质量之间找到平衡，是行业需要共同思考的问题。媒体从业者可以利用AI工具快速生成新闻摘要、选题建议和初稿框架，显著提升内容生产效率。基于深度学习的推荐算法能够精准分析用户偏好，实现千人千面的内容分发。这不仅提升了用户阅读体验，也大幅提高了内容的传播效率和商业转化率。随着人工智能技术的快速发展，媒体行业正迎来

avatar 亚马逊云科技技术品牌专区

千万用户股票量化平台设计

2026-07-10已确认总体路线云原生 Lakehouse + 流批一体 + 异步计算平面。

avatar 亚马逊云科技技术品牌专区

基于 .NET 10 打造的开源自部署 S3 兼容对象存储服务

imageimage引言对象存储已经成为现代云原生架构的基石。从 AWS S3 到 MinIO，S3 兼容 API 几乎成了对象存储的"通用语言"。然而在 .NET 生态中，一直缺少一个纯 .NET 原生实现的高质量 S3 兼容存储方案。Means 应运而生——它是一个基于 .NET 10 / ASP.NET Core 构建的、可自部署的 S3 兼容对象存储服务。

avatar 亚马逊云科技技术品牌专区