前言

本文为博主在项目环境搭建时记录的SkyWalking安装流程，希望对大家能够有所帮助，不足之处欢迎批评指正🤝🤝🤝

SkyWalking简介

SkyWalking是一个开源的分布式系统观测平台，它主要用于监控、追踪和诊断分布式系统中的服务和应用。SkyWalking 能帮助开发者和运维人员了解系统中的服务调用链路，分析性能瓶颈，监控各个服务的运行状态，及时发现问题。简单的讲就是开发者可以通过SkyWalking来了解每个服务的状况、性能表现和调用关系。

SkyWalking下载

SkyWalking官网下载地址

我们在官网的Foundations下的SkyWalking APM的Distribution下载，这里博主是准备下载9.5.0版本，另外的话就是需要知道的是

如果你想查看或者修改SkyWalking的源代码的话，可以点击Source下载src链接🙂
当然就是只是想运行SkyWalking而不修改源代码建议和博主一样直接下载二进制文件

1727617049906

下载解压好的目录结构如下

1727619381875

从 SkyWalking 8.7.0版本开始，agent的相关代码已经从主程序包中拆分出来，成为独立的模块。这意味着，SkyWalking本身提供监控和追踪功能，但如果你需要在你的应用程序中进行性能监控或分布式追踪，就需要额外配置一个agent。这个agent会作为探针，植入到你的应用中，用于收集应用运行时的性能数据，比如响应时间、错误率、调用链路等🤔🤔🤔

我们需要下载和SkyWalking版本对应的agent版本， SkyWalking Agent不同版本的要求链接一览

1727621268419

因为博主下的serve是9.5.0的，所以这里的话从文档可以看出只能下载9.0.0版本的agent了

1727621385681

回到下载界面下载对应的Agents，这里博主还是下载可运行的二进制文件，有相应需求的话下载源代码🤝🤝

1727621737402

下载好之后进行解压，这里博主直接用命令行解压

1	tar -xvzf apache-skywalking-java-agent-9.0.0.tgz

1727622305491

Agent监控实现

解压好了之后我们要找到Agent Jar文件的路径

1727623250731

然后我们找一个java的应用程序进行配置JVM启动参数，博主的启动参数格式如下

1	-javaagent:/path/to/skywalking-agent.jar

博主在IDEA中给一个示例程序来配置启动参数，首先在IDEA界面右上角点击Edit Configurations

1727624110539

给示例程序添加JVM参数

1727624561181

然后我们也要配置agent.config文件的内容

1727624643430

主要涉及agent.namespace和collector.backend_service的配置

1 2	# The agent namespace agent.namespace=${SW_AGENT_NAMESPACE:}

这个配置项定义了Agent 的命名空间。SW_AGENT_NAMESPACE是一个环境变量。如果没有设置这个环境变量，则默认为空（即没有指定命名空间）。
命名空间的作用是当你有多个独立的SkyWalking集群时，Agent可以通过命名空间区分不同集群中的服务，防止数据混乱。如果你不需要区分多个集群，通常可以保持为空。

这里的话博主设置一个环境变量进行测试

1727625135999

1 2	# Backend service addresses. collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}

这个配置项定义了SkyWalking 后端服务（OAP）的地址，Agent 会将收集到的数据发送到这个地址。
SW_AGENT_COLLECTOR_BACKEND_SERVICES 是一个环境变量，如果没有设置这个变量，则默认连接到 127.0.0.1:11800，这意味着后端服务在本地运行，并且监听 11800 端口。

这里博主的后端服务在本地运行就不做修改了

启动配置

在下载的SkyWalking目录中有bin文件夹，其中有启动脚本，在windows下面是bin/startup.bat

1727659821081

默认情况下运行启动脚本后SkyWalking UI服务会在本地运行并监听8080端口，可以通过下面的地址访问

1	http://localhost:8080/

但是为了避免端口冲突，我们对于UI服务的配置文件进行修改，将默认的server.port的端口号修改为8888

1727661237483

这里可以直接将8080修改为8888或者设置环境变量SW_SERVER_PORT两种方式都可以

1727661436550

另外虽然就是测试的时候博主是本地单实例运行SkyWalking，但是项目要求的环境是需要配置Nacos服务注册中心，这里博主也给出相应的修改步骤，首先是打开config文件夹下的配置文件

1727662268301

然后将注册中心修改为nacos，当然这里为什么要进行这一步修改呢？🤔🤔🤔对Nacos有了解需求的可以简单看看博主写的另一篇博客 Windows11系统下Nacos环境搭建教程 🫡🫡🫡

希望使用Nacos来管理多个OAP实例
Nacos能够帮助实现负载均衡、故障检测和实例的动态拓展

1727662176128

SkyWalking启动

首先的话因为Nacos是服务注册和发现的中心，所以需要最先启动

1727663023610

然后的话便是启动OAP服务，因为OAP后端是SkyWalking的核心服务，负责处理代理agent发送来的监控数据，OAP服务启动后会向Nacos注册自己并开始接收来自 Java 应用的监控数据🤔🤔🤔

1727663332604

这里博主同时启动OAP服务和UI服务时窗口闪退，无法查看到错误信息，准备来一一排查错误信息

首先是检查日志文件，可惜为空🤔🤔🤔

1727663548826

然后检查下是否端口被占用，所设置的8888端口也没有发送冲突🤔🤔🤔

1727663593155

使用命令行启动，结果没有出输出错误信息，仍然闪退🤔🤔🤔

1727663898866

经调研可知，SkyWalking OAP 服务默认情况下需要一个存储引擎来存储监控数据。博主接下来带领大家下载一下Elasticsearch（SkyWalking的默认存储引擎），跳转至下文的Elasticsearch安装目录进行Elasticsearch安装的步骤，安装完毕后将配置文件中storage部分进行配置

1727680418756

双击服务仍然不能打开，用Git Bash打开输入命令

1	sh startup.sh

显示已成功运行？这就很奇怪了🤨🤨🤨

1727682755754

然后发现生成有log文件了，一看表示我正在运行的 Java 版本过低，无法运行由更高版本的 Java 编译的类文件，崩溃了啊，新版本要求JDK11😭😭😭

1727682819641

安装JDK吧

JDK11 安装地址

博主直接下载压缩包来解压

1727683701710

解压完成后博主修改了一下JAVA_HOME的环境变量，更换为jdk11的文件夹，重启一下命令行输入java版本命令，显示jdk11表示更好成功

1727684247911

双击oapService.bat启动OAP服务仍然闪退，查看log文件表明Nacos时没有找到用户，这里是因为博主没有在SkyWalking的配置文件中修正nacos的用户名和密码配置

1727685287024

1727685472347

再次运行oapService.bat在Nacos管理页面发现服务成功注册🎉🎉🎉🎉

1727685530137

运行webappService.bat然后访问http://localhost:8888成功打开SkyWalking的UI界面🎉🎉🎉🎉

1727685615955

Java应用程序启动

启动测试程序，可以看到agent代理的相关日志信息

1727685933315

可以发现SkyWalking的UI界面可以看到我注册的服务的信息🎉🎉🎉

1727686097224

Elasticsearch安装

Elasticsearch官网下载地址

这里博主直接下载Elasticsearch在Windows下的压缩包

1727665553857

解压后的目录结构如下

1727677045801

然后配置环境变量

1727677379240

1727677489026

双击bin\elasticsearch.bat启动后会在命令行窗口看到一系列的日志输出

1727677563230

打开elasticsearch.yml文件进行一些配置，这里把xpack.security.enabled和xpack.security.http.ssl.enabled设置为false，便于我们稍后测试Elasticsearch是否成功启动，但在生产环境中不推荐这种使用。

1727678456997

通过访问http:localhost:9200来验证Elasticsearch是否成功启动，如果看到类似下面的JSON响应表示已成功启动

{
    "name": "your_node_name",#节点的名称，通常是启动 Elasticsearch 时自动分配的名称或者手动配置
    "cluster_name": "your_cluster_name",#集群的名称，多个节点可以属于同一个集群也可以手动修改。
    "cluster_uuid": "your_cluster_uuid",#集群的唯一标识符
    "version": {
        "number": "your_elasticsearch_version",#Elasticsearch 的版本号
        "build_flavor": "your_build_flavor",#构建版本的风格
        "build_type": "your_build_type",#构建的安装类型
        "build_hash": "your_build_hash",#当前 Elasticsearch 版本的 Git 提交哈希值
        "build_date": "your_build_date",#构建日期，表示 Elasticsearch 这个版本的打包日期
        "build_snapshot": "your_build_snapshot",#是否是开发快照版本
        "lucene_version": "your_lucene_version",#Elasticsearch 使用的 Lucene 库的版本号
        "minimum_wire_compatibility_version": "your_minimum_wire_compatibility_version",
        "minimum_index_compatibility_version": "your_minimum_index_compatibility_version"
    },
    "tagline": "your_elasticsearch_tagline"#这是 Elasticsearch 项目的一句幽默标语
}

总结

本文记录了博主搭建SkyWalking环境从头到尾的步骤，中间会遇到一些bug，博主的解决问题的思路和处理逻辑希望能够对你有所启发，大家国庆快乐🎉🎉🎉

前言