# SkyWalking

：一个 Web 服务器，支持链路监控、应用性能监控（APM）。

官方文档 (opens new window)
2015 年由中国开发人员吴晟开源，2017 年底进入 Apache 孵化器。

# 部署

用 docker-compose 部署：

version: '3'

services:
  elasticsearch:
    image: elasticsearch:7.10.1
    environment:
      - discovery.type=single-node
      - bootstrap.memory_lock=true
      - "ES_JAVA_OPTS=-Xms2G -Xmx2G"
    ports:
      - 9200:9200
    ulimits:
      memlock:
        soft: -1
        hard: -1

  oap:
    image: apache/skywalking-oap-server:8.9.1
    environment:
      JAVA_OPTS: -Xms2G -Xmx2G -Dcom.linecorp.armeria.defaultResponseTimeoutMillis=60000
      SW_STORAGE: elasticsearch
      SW_STORAGE_ES_CLUSTER_NODES: elasticsearch:9200
      SW_HEALTH_CHECKER: default
      SW_TELEMETRY: prometheus
      # SW_CORE_RECORD_DATA_TTL: 3    # Record 数据的保存天数
      # SW_CORE_METRICS_DATA_TTL: 7   # Metrics 数据的保存天数
    ports:
      - 11800:11800
      - 12800:12800

  ui:
    image: apache/skywalking-ui:8.9.1
    environment:
      JAVA_OPTS: "-Xms1G -Xmx1G"
      SW_OAP_ADDRESS: http://oap:12800
    ports:
      - 8080:8080

# 原理

SkyWalking 系统分为多个组件：
- UI
  - ：Web 前端，采用 Java 语言开发。
- OAP
  - ：Web 后端，采用 Java 语言开发。
- Storage
  - ：负责存储监控数据，可以是 ES、MySQL 等多种数据库。
  - 为了保证监控的实时性，这里不采用消息队列，当数据量过大时可以降低采样率。
- agent
  - ：采集业务服务的监控数据，发送给 OAP 。
SkyWalking 监控的主要概念：
- service
  - ：表示一种应用服务，具有某种功能、负责处理某种请求。
  - 一个 service 可能运行了一个或多个实例（instance），而一个 instance 可能包含一个或多个进程（process）。
- endpoint
  - ：service 接收请求的地址，比如 HTTP URI 或 gRPC 地址。
  - 一个 service 可能包含一个或多个 endpoint 。
- trace
  - ：用户发出一个请求时，业务系统会依次调用多个服务 API 来处理请求，称为一个调用链路（trace）。
  - 每调用一个服务 API 称为一个 span 。
- segment
  - ：在一个 trace 中，同一个 instance 执行的多个 span ，划分为一个段（segment）。
  - 一个 trace 由多个 segment 串联组成。每个 segment 包含多个 span ，拥有相同的 segment_id 。
- event
  - ：客户端可以上报事件到 SkyWalking 服务器，比如 k8s 事件。
SkyWalking 保存的监控数据分为几种：
- record ：包括 traces、logs、alarm 等数据。
- metrics ：包括 service、instance、endpoint 等对象的监控指标、元数据。

# 用法

例：以非侵入方式监控 Python 进程

安装 SkyWalking Python agent ：pip install apache-skywalking

配置环境变量：

export SW_AGENT_NAME=test_service     # 监控的该服务名
# export SW_AGENT_INSTANCE=           # 服务实例名，默认会自动生成
export SW_AGENT_COLLECTOR_BACKEND_SERVICES=10.0.0.1:11800 # SkyWalking OAP 地址
# export SW_AGENT_PROTOCOL=grpc       # 通信协议，默认为 grpc
# export SW_AGENT_LOGGING_LEVEL=INFO  # agent 的日志级别

用 agent 启动 Python 进程：
```
sw-python run python test.py
```

例：以非侵入方式监控 Java 进程

下载 agent 包，解压缩。
在 Java 启动命令中添加 agent 参数，如下：
```
java \
-javaagent:skywalking-agent/skywalking-agent.jar \
-Dskywalking.agent.service_name=test \
-Dskywalking.collector.backend_service=10.0.0.1:11800 \
-jar test.jar
```
- 这样能监控到 Java 进程对外通信的流量。不过想实现链路追踪的功能，还需要在代码里埋点 traceId 。
- 详情参考官方文档 (opens new window)