Linux / Centos Stream 9安装 Skywalking 9.4.0 记录

柔情只为你懂 2024-03-23 12:19 59阅读 0赞

> 链路追踪框架  
> 官网：[http://skywalking.apache.org/][http_skywalking.apache.org]  
> 下载：[http://skywalking.apache.org/downloads/][http_skywalking.apache.org_downloads]  
> Github：[https://github.com/apache/skywalking][https_github.com_apache_skywalking]  
> 文档：[https://skywalking.apache.org/docs/main/v9.4.0/readme/][https_skywalking.apache.org_docs_main_v9.4.0_readme]  
> 中文文档： [https://skyapm.github.io/document-cn-translation-of-skywalking/][https_skyapm.github.io_document-cn-translation-of-skywalking]  
> ![在这里插入图片描述][39244abdca204373bcfb269a4d8ec516.png]

--------------------

### 1. 下载 ###

SkyWalking OAP 服务、SkyWalking UI 服务  
官网下载：  
[https://skywalking.apache.org/downloads/][https_skywalking.apache.org_downloads]  
在线下载：

wget https://dlcdn.apache.org/skywalking/9.4.0/apache-skywalking-apm-9.4.0.tar.gz

![官方下载][90e532f040d348f390e498174f815087.png]  
下载 Agents  
在线下载：

wget https://dlcdn.apache.org/skywalking/java-agent/8.15.0/apache-skywalking-java-agent-8.15.0.tgz

![8.15][]

--------------------

### 2. 解压 ###

习惯放到local路径下

cd /usr/local/

tar -zxvf apache-skywalking-apm-9.4.0.tar.gz -C /usr/local

tar -zxvf apache-skywalking-java-agent-8.15.0.tgz -C /usr/local

--------------------

### 3. 配置SkyWalking OAP ###

避免端口冲突，更换 SkyWalking UI界面默认8080端口：

cd apache-skywalking-apm-bin

查看目录

![目录][016596d0b84548f8b49e1412a8b9cabf.png]

编辑yml文件，以8100端口为例：

vi webapp/application.yml

![8100][]  
默认内存模式，更改为MySQL连接

vi config/application.yml

> :set number 可查看行号

大概133 行 修改h2为mysql

storage:
          selector: ${
        SW_STORAGE:mysql}

![mysql][]  
大概183-194行，确认MySQL连接信息（地址、账号、密码），记得新建数据库。

mysql:
             properties:
               jdbcUrl: ${
        SW_JDBC_URL:"jdbc:mysql://localhost:3306/swtest?rewriteBatchedStatements=true"}
               dataSource.user: ${
        SW_DATA_SOURCE_USER:root}
               dataSource.password: ${
        SW_DATA_SOURCE_PASSWORD:123456}

![数据库][43fbdb9a75164193989fd0d20091963b.png]

> ESC :wq 保存并退出

下载MySQL驱动jar包到 `/oap-libs` 目录下  
`wget -P /usr/local/apache-skywalking-apm-bin/oap-libs https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.0.32/mysql-connector-j-8.0.32.jar`

--------------------

然后`新建数据库 swtest`  
![新建][6ff627bcd5a6459a8a6db8dd534b7d5e.png]

--------------------

### 4. 启动 SkyWalking OAP 服务 ###

sh bin/oapService.sh

![成功][1fe45b8108ca4289974e00a3f5a0d885.png]  
查看启动日志：`tail -f logs/skywalking-oap-server.log`  
最后一句为  
50 \[main\] INFO \[\] - Version of OAP: 9.4.0-520d531  
skywalking-oap-server服务启动后会暴露11800 和 12800 两个端口，记得放开端口。  
![在这里插入图片描述][84b0521b66bb41ed91b3efcd3afac05c.png]

> 端口开放：  
> 开放指定端口

firewall-cmd --zone=public --add-port=11800/tcp --permanent
    firewall-cmd --zone=public --add-port=12800/tcp --permanent

> `--zone #作用域`  
> `--add-port=11800/tcp #添加端口，格式为：端口/通讯协议`  
> `--permanent #永久生效，没有此参数重启后失效`

### 5. 启动 SkyWalking UI 服务 ###

sh bin/webappService.sh

默认是8080端口，上面更换了  
访问：  
[http://192.168.20.128:8100/][http_192.168.20.128_8100]  
![首页图片][5312ce3268cd452da5af9ca8eb7e75a1.png]

> 官方提供了两个脚本一起启动的脚本，这次启动无误后，下次可直接
> 
>     sh bin/startup.sh

服务开机自启配置，参考8

--------------------

### 6. Java 程序接入SkyWalking ###

#### 6.1在linux中 通过jar包方式接入 ####

写一个shell脚本，通过 -javaagent 参数进行 配置SkyWalking Agent来跟踪微服务

vi SkyWalking-Test-startup.sh

添加内容：

#!/bin/sh
    # SkyWalking Agent 配置
    # 配置Agent名字为项目的 `spring.application.name`
    export SW_AGENT_NAME=SkyWalking-Test
    # 配置 Collector 地址
    export SW_AGENT_COLLECTOR_BACKEND_SERVICES=127.0.0.1:11800
    #配置链路的最大Span数量，默认为 300
    export SW_AGENT_SPAN_LIMIT=2000
    # SkyWalking Agent jar 地址
    export JAVA_AGENT=-javaagent:/usr/local/skywalking-agent/skywalking-agent.jar
    # jar 启动
    java -jar $JAVA_AGENT -jar SkyWalking-Test-0.01-SNAPSHOT.jar

赋权：

chmod u+x SkyWalking-Test-startup.sh

`等同于：`

`java ‐javaagent:usr/local/skywalking-agent/skywalking-agent.jar ‐DSW_AGENT_COLLECTOR_BACKEND_SERVICES=127.0.0.1:11800 ‐DSW_AGENT_NAME=SkyWalking-Test ‐jar SkyWalking-Test-0.01-SNAPSHOT.jar`  
![脚本][3f4d19118e614c668354e2414c529b88.png]

--------------------

#### 6.2 在Windows中 ####

IDEA中配置JVM参数，编辑VM Options，如果应用程序和SkyWalking部署在同一机器，backend\_service可以不写

# skywalking‐agent.jar的本地磁盘的路径
    -javaagent:F:\Apache\skywalking-agent\skywalking-agent.jar
    # 在skywalking上显示的服务名
    -Dskywalking.agent.service_name=SkyWalking-Test
    # skywalking的collector服务的IP及端口
    -Dskywalking.collector.backend_service=192.168.20.128:11800

> \-DSW\_AGENT\_COLLECTOR\_BACKEND\_SERVICES  
> 可以指定远程地址，但-javaagent必须绑定本地路径的 skywalking- agent.jar

IDEA新版添加JVM参数：  
![modi][]  
![vm][]  
![添加vm][vm 1]

--------------------

### 7.SkyWalking 自定义链路追踪 ###

<dependency>
       <groupId>org.apache.skywalking</groupId>
      <artifactId>apm-toolkit-trace</artifactId>
      <version>8.15.0</version>
    </dependency>

只需要在业务方法上加上@Trace注解

在方法上增加@Tag或者@Tags。  
@Tag 注解中 key = 方法名 ； value = returnedObj 返回值 arg\[0\] 参数  
![trace][]  
然后启动项目，再去刷新下项目，就有记录了  
![记录][836b71a3dc374748b38cbe328a9bc1aa.png]  
![记录][510161d5bc06478994bebe36c40c1ab0.png]

--------------------

###  ###

### 8.设置SkyWalking OAP 服务、SkyWalking UI 服务开机自启 ###

> 准备设置一个.service，开机执行这个脚本文件，以此实现自启效果  
> 系统启动脚本目录 /etc/systemd/system/

#### 新建服务文件 ####

vi /etc/systemd/system/skyWalking.service

#### 添加： ####

[Unit]
    Description=skyWalking
    After=network.target remote-fs.target nss-lookup.target mysql8.service zookeeper.service kafka.service nacos-cluster.service
    
    [Service]
    Type=forking
    ExecStart=sh /usr/local/apache-skywalking-apm-bin/bin/startup.sh start
    PrivateTmp=true
    
    [Install]
    WantedBy=multi-user.target

> 按ESC :wq保存并退出

#### 赋权： ####

chmod 754 /etc/systemd/system/skyWalking.service

#### 设置开机自启： ####

systemctl enable skyWalking.service

#### 重载配置 ####

systemctl daemon-reload

> 可重启尝试脚本可行性（reboot）

#### 查看状态 ####

systemctl status skyWalking.service

--------------------

暂时到这，感谢阅览~  
END

--------------------

[http_skywalking.apache.org]: http://skywalking.apache.org/
[http_skywalking.apache.org_downloads]: http://skywalking.apache.org/downloads/
[https_github.com_apache_skywalking]: https://github.com/apache/skywalking
[https_skywalking.apache.org_docs_main_v9.4.0_readme]: https://skywalking.apache.org/docs/main/v9.4.0/readme/
[https_skyapm.github.io_document-cn-translation-of-skywalking]: https://skyapm.github.io/document-cn-translation-of-skywalking/
[39244abdca204373bcfb269a4d8ec516.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/255feb5bc138425b85b4f0ca2c9c551b.png
[https_skywalking.apache.org_downloads]: https://skywalking.apache.org/downloads/
[90e532f040d348f390e498174f815087.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/d94cd9279fb042d8a70a81a05690bcd5.png
[8.15]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/2493019ad57240b5bb90e7c7abb52f3a.png
[016596d0b84548f8b49e1412a8b9cabf.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/2da59c27a7c94e0cb4bbce464149a516.png
[8100]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/f625068cbdf2424fb9aa5b0a4f2636a7.png
[mysql]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/1fadcd5d0e304fa6a602855d6c5ca6b1.png
[43fbdb9a75164193989fd0d20091963b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/5dd9e5a1491b4579887a2ecea0ad3401.png
[6ff627bcd5a6459a8a6db8dd534b7d5e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/b0be63bbb3834b8e97b2abd937f58e39.png
[1fe45b8108ca4289974e00a3f5a0d885.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/48e2e0d5169a4e63a76668af57b53dfc.png
[84b0521b66bb41ed91b3efcd3afac05c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/13110a2631764aafa351cc47ec4d04c1.png
[http_192.168.20.128_8100]: http://192.168.20.128:8100/
[5312ce3268cd452da5af9ca8eb7e75a1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/a2c04ecc5e8d4a79afb7dbce337b8409.png
[3f4d19118e614c668354e2414c529b88.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/09219c2331724079a7b9461084aad4d3.png
[modi]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/90daccff91e0441abbd7e981a7853e5c.png
[vm]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/be5be5f8546247caa6acaa700f97feb4.png
[vm 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/5e9c12e6764a41819b9993a31b374d65.png
[trace]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/89848c4de8204a5599258f8d6a823a37.png
[836b71a3dc374748b38cbe328a9bc1aa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/d3a2cc62ccf14be391920cecfc1e59e5.png
[510161d5bc06478994bebe36c40c1ab0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/00ac7d9f9a3347f78f7d81bc3cd6f7c8.png