SkyWalking 入门实战(2)--安装部署
本文主要介绍 SkyWalking 的安装部署;文中使用到的软件版本:Rocky Linux 9.5、Java 17.0.16、Node 24.20.0、BanyanDB 0.11.1、SkyWalking 11.0.0、horizon-ui 1.0.0、SkyWalking Java Agent 9.7.0、SpringBoot 3.5.16。
1、BanyanDB 安装
BanyanDB 是一款可观测性数据库,旨在摄取、分析和存储指标(Metrics)、链路追踪(Tracing)及日志(Logging)数据。它专为处理 Apache SkyWalking 所产生的可观测性数据而设计。在 BanyanDB 出现之前,SkyWalking 所采用的数据库并不完全契合 APM(应用性能监控)的数据模型,尤其是在存储链路追踪和日志数据方面。因此,根据 SkyWalking 数据模式的特性,它在性能和资源利用率方面仍有很大的提升空间。
1.1、下载安装包
官网(https://skywalking.apache.org/downloads/?version=v0.11.1#skywalking-banyandb)下载安装包后解压:
tar zxvf skywalking-banyandb-0.11.1-banyand.tgz
根据操作系统拷贝 bin 目录下对应的二进制文件到相应目录下,这里是 banyand-server-static-linux-amd64:
cp bin/banyand-server-static-linux-amd64 /home/mongo/soft/banyandb-0.11.1
1.2、启动
cd /home/mongo/soft/banyandb-0.11.1 ./banyand-server-static-linux-amd64 standalone --node-host-provider=ip \ --access-log-root-path=/home/mongo/soft/banyandb-0.11.1/data \ --measure-root-path=/home/mongo/soft/banyandb-0.11.1/data \ --property-root-path=/home/mongo/soft/banyandb-0.11.1/data \ --stream-root-path=/home/mongo/soft/banyandb-0.11.1/data \ --trace-root-path=/home/mongo/soft/banyandb-0.11.1/data
--node-host-provider 参数用于定义集群/节点用来获取并向外暴露自身主机地址(IP 或域名)的策略与机制;--xxx-root-path 用于指定各类型数据存放目录,默认为:/tmp,各参数的含有看通过 banyand-server-static-linux-amd64 standalone -h 查看。
1.3、端口说明
BanyanDB 服务端默认需要如下端口:
| 端口 | 协议 | 说明 |
| 17912 | gRPC | 供客户端(如 SkyWalking OAP Server)进行数据写入与查询。 |
| 17913 | HTTP | 提供 HTTP API 及 Web 页面。 |
| 17916 | gRPC | 集群内部节点通信端口 |
2、SkyWalking 服务端安装
2.1、下载安装包
官网(https://skywalking.apache.org/downloads/?version=v11.0.0#skywalking)下载安装包后解压:
tar zxvf apache-skywalking-apm-11.0.0-bin.tar.gz
2.2、修改配置
根据需要修改 config/application.yml 文件。
1.2.1、使用 MySQL 作为存储(可选)
SkyWalking 默认配置的存储是 BanyanDB,如需使用使用其他存储,可修改 storage 对应的信息,如下修改为使用 MySQL 作为存储:
storage:
selector: ${SW_STORAGE:mysql}
mysql:
properties:
jdbcUrl: ${SW_JDBC_URL:"jdbc:mysql://10.49.196.30:3306/swtest?rewriteBatchedStatements=true&allowMultiQueries=true"}
dataSource.user: ${SW_DATA_SOURCE_USER:root}
dataSource.password: ${SW_DATA_SOURCE_PASSWORD:123456}
还需要把 MySQL 的 JDBC 驱动拷贝到 oap-libs 目录下。
1.2.2、数据发送到其他系统(可选)
SkyWalking 可以把数据发送到三方系统,如下把 trace 数据推给 kafla:
exporter:
selector: ${SW_EXPORTER:default}
default:
# gRPC exporter
enableGRPCMetrics: ${SW_EXPORTER_ENABLE_GRPC_METRICS:false}
gRPCTargetHost: ${SW_EXPORTER_GRPC_HOST:127.0.0.1}
gRPCTargetPort: ${SW_EXPORTER_GRPC_PORT:9870}
# Kafka exporter
enableKafkaTrace: ${SW_EXPORTER_ENABLE_KAFKA_TRACE:true}
enableKafkaLog: ${SW_EXPORTER_ENABLE_KAFKA_LOG:false}
kafkaBootstrapServers: ${SW_EXPORTER_KAFKA_SERVERS:10.49.196.30:9092}
# Kafka producer config, JSON format as Properties.
kafkaProducerConfig: >
{
"acks":"1",
"retries":2,
"security.protocol":"SASL_SSL",
"sasl.mechanism":"PLAIN",
"sasl.jaas.config":"org.apache.kafka.common.security.plain.PlainLoginModule required username=\"producer\" password=\"123456";",
"ssl.truststore.type":"pem",
"ssl.truststore.location":"/home/mongo/soft/apache-skywalking-apm-11.0.0-bin/config/ca.pem"
}
kafkaTopicTrace: ${SW_EXPORTER_KAFKA_TOPIC_TRACE:skywalking-export-trace}
kafkaTopicLog: ${SW_EXPORTER_KAFKA_TOPIC_LOG:skywalking-export-log}
exportErrorStatusTraceOnly: ${SW_EXPORTER_KAFKA_TRACE_FILTER_ERROR:false}
2.3、启动
cd bin ./startup.sh
2.4、端口说明
SkyWalking 服务端默认需要如下端口:
| 端口 | 说明 |
| 11800 (gRPC) | 对外开放,专门用于接收各类 Agent/探针上报的数据。 |
| 12800 (HTTP) | 对外开放,专门用于 UI/REST/GraphQL 查询以及 Agent 的 HTTP 模式。 |
| 12801 (gRPC Internal) | 对内开放,仅用于 OAP 节点与 OAP 节点之间的内部 Peer-to-Peer 通信。 |
3、SkyWalking Java Agent 安装
3.1、下载安装包
官网(https://skywalking.apache.org/downloads/?version=v9.7.0#skywalking-java)下载安装包后解压:
tar zxvf apache-skywalking-java-agent-9.7.0.tgz
3.2、修改配置
根据需要修改 config/agent.config 文件。
# 指定应用名称 agent.service_name=${SW_AGENT_NAME:MyApplication} # 指定服务端地址 collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:10.49.196.30:11800}
3.3、应用集成
SpringBoot 应用只需启动时增加 javaagent 参数:
nohup java -javaagent:/home/mongo/app/skywalking-agent/skywalking-agent.jar -jar demo-1.0.0.jar &
4、Horizon UI 安装
Horizon UI 是 Apache SkyWalking 的新一代 Web UI。
4.1、下载安装包
官网(https://skywalking.apache.org/downloads/?version=v1.0.0#skywalking-horizon-ui)下载安装包后解压:
tar zxvf apache-skywalking-horizon-ui-1.0.0-bin.tar.gz
由于该包是在 Mac 环境下生成的,在 Linux 环境解压后有很多 ._ 开头的文件,这些文件可能会影响 Horizon UI 的部署,这里把这些文件删除:
find . -name "._*" -delete
1.0.1 版本已没有这个问题。
4.2、修改配置
根据需要修改 horizon.yaml 文件。
4.2.1、配置服务端地址
oap: queryUrl: "${HORIZON_OAP_QUERY_URL:http://10.49.196.30:12800}"
3.2.2、配置用户名密码
在未配置任何用户的情况下,Horizon 可以正常启动,但任何登录操作都无法成功。需使用源码仓库中的辅助工具或任何支持 Argon2id 的密码工具生成一个 Argon2id 哈希值。
直接使用官网的方法:pnpm --filter bff cli:hash 报错了;这里使用 Node 的 argon2 包来生成 Argon2id 哈希值,在一个空目录下执行如下命令:
npm install argon2 node -e 'require("argon2").hash("123456", { type: require("argon2").argon2id }).then(console.log);'
得到哈希值后配置用户名密码:
auth: local: users: - username: admin passwordHash: "$argon2id$v=19$m=65536,p=4,t=3$pDOcsSHIfTxOH/9pWtBX/g$9+ufNUJPwgIpdZJHXzLlBhd6aoWJjQIKnGPYWA+bgMc" roles: [admin]
这里配置了一个用户:admin/123456
3.3、启动
HORIZON_CONFIG=./horizon.yaml node server.js
启动后访问 http://10.49.196.30:8081:

参考:
https://skywalking.apache.org/docs/skywalking-banyandb/v0.11.1/installation/standalone/
https://skywalking.apache.org/docs/main/latest/en/setup/backend/backend-setup/
https://skywalking.apache.org/docs/skywalking-java/latest/en/setup/service-agent/java-agent/readme/
https://skywalking.apache.org/docs/skywalking-horizon-ui/latest/setup/overview/
浙公网安备 33010602011771号