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:

image

 

 

参考:
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/


 

posted @ 2026-11-07 14:13  且行且码  阅读(21)  评论(0)    收藏  举报