# skywalking_build

**Repository Path**: bwlab/skywalking_build

## Basic Information

- **Project Name**: skywalking_build
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SkyWalking 部署文档

基于 Docker Compose 部署 Apache SkyWalking APM 监控平台，使用 BanyanDB 作为存储后端。

## 架构组件

| 组件 | 版本 | 端口 | 说明 |
|------|------|------|------|
| BanyanDB | 0.9.0 | 17912（gRPC）/ 17913（HTTP） | 时序数据库存储后端 |
| SkyWalking OAP Server | 10.3.0 | 11800（Agent gRPC） | 观测分析平台核心 |
| SkyWalking UI | 10.3.0 | 12800（Web） | Web 控制台 |

## 文件结构

```
├── docker-compose.yml      # Docker Compose 编排文件
├── alarm-settings.yml      # SkyWalking 告警规则配置
├── banyandb-data/          # BanyanDB 数据持久化目录（自动创建）
├── skywalking-oap-data/    # OAP Server 数据持久化目录（自动创建）
└── README.md
```

## 前置要求

- Docker 20.10+
- Docker Compose v2.0+
- 可访问镜像仓库：`swr.cn-north-4.myhuaweicloud.com/de-24fcpf/`

## 部署步骤

### 1. 启动服务

```bash
docker compose up -d
```

启动顺序由依赖关系自动保证：BanyanDB → OAP Server → UI。

BanyanDB 健康检查通过后（约 10s），OAP Server 才会启动，OAP 完全就绪约需 60s。

### 2. 验证服务状态

```bash
docker compose ps
```

所有服务应处于 `healthy` 或 `Up` 状态：

```
NAME                    STATUS
banyandb                Up (healthy)
skywalking-oap-server   Up (healthy)
skywalking-ui           Up
```

### 3. 访问 UI

浏览器打开：`http://<host>:12800`

### 4. 查看日志

```bash
# 查看 OAP 日志
docker compose logs -f skywalking-oap

# 查看 BanyanDB 日志
docker compose logs -f banyandb
```

## 数据持久化

BanyanDB 数据持久化到宿主机 `./banyandb-data/`，目录结构如下：

```
banyandb-data/
├── trace/      # 链路追踪数据
├── stream/     # 日志流数据
├── measure/    # 指标数据
├── metadata/   # 集群元数据
└── property/   # 属性数据
```

> **注意**：BanyanDB 0.9.0 不支持通过环境变量统一设置数据目录，须在 `command` 中分别指定各模块的 `--*-root-path` 参数，官方 Docker quickstart 示例未做持久化，本配置已修复此问题。

OAP Server 数据持久化到 `./skywalking-oap-data/`（配置、日志等辅助数据）。

## 配置说明

### 认证 Token

OAP Server 与 UI、Agent 之间均启用了认证：

```
SW_AUTHENTICATION=RfumLNt94JXwYhy9vGDe3yCFcTZuXxgcz5gLVvuikt8
```

### 数据保留策略

| 数据类型 | 保留时长 |
|----------|----------|
| Trace 数据 | 7 天 |
| Metrics 数据 | 30 天 |

### 性能调优参数

| 参数 | 值 | 说明 |
|------|----|------|
| `SW_TRACE_SAMPLE_RATE` | 3300 | 采样率约 33% |
| `SW_CORE_L1_AGGREGATION_FLUSH_PERIOD` | 30000ms | L1 聚合周期 |
| `SW_CORE_L2_AGGREGATION_FLUSH_PERIOD` | 300000ms | L2 聚合周期 |
| `SW_CORE_GRPC_THREAD_POOL_SIZE` | 4 | gRPC 线程池大小 |
| `SW_SLOW_DB_THRESHOLD` | 1000ms | 慢 SQL 告警阈值 |

### 告警配置

告警规则配置在 `alarm-settings.yml` 中，按需修改后重启 OAP 生效：

```bash
docker compose restart skywalking-oap
```

## 客户端接入

在应用服务中配置 SkyWalking Agent：

```properties
# Agent 上报地址
SW_AGENT_COLLECTOR_BACKEND_SERVICES=<host>:11800

# 认证 Token（与服务端保持一致）
SW_AGENT_AUTHENTICATION=RfumLNt94JXwYhy9vGDe3yCFcTZuXxgcz5gLVvuikt8
```

## 日常运维

### 停止服务

```bash
docker compose down
```

数据目录 `banyandb-data/` 和 `skywalking-oap-data/` 不会被删除。

### 更新镜像后重新部署

```bash
docker compose pull
docker compose up -d --force-recreate
```

> **注意**：`--force-recreate` 会重建容器，由于数据已挂载到宿主机，不会丢失。

### 检查 BanyanDB 数据写入

```bash
find banyandb-data -type d
```

### 清理全部数据（慎用）

```bash
docker compose down
rm -rf banyandb-data/ skywalking-oap-data/
```