SpringCloud - Spring Cloud Alibaba 之 SkyWalking 分布式链路跟踪；服务，端点，实例；IDEA配置；告警（十三）

淩亂°似流年 2023-09-28 16:44 84阅读 0赞

#### 阅读本文前参考 ####

[https://blog.csdn.net/MinggeQingchun/article/details/125977930][https_blog.csdn.net_MinggeQingchun_article_details_125977930]

## 一、SkyWalking 服务，端点，实例   ![c1732fbe56fd4945a1e3879eca305cb2.png][] ##

**1、服务(Service)** **：**表示对请求提供相同行为的一系列或一组工作负载，在使用Agent时，可以定义服务的名字，我们可以看到 Spring Boot 应用服务为 "springboot-2-hello"，就是我们在环境变量 SW\_AGENT\_NAME 中所定义的；

**2、服务实例(Service Instance) ：**上述的一组工作负载中的每一个工作负载称为一个实例， 一个服务实例实际就是操作系统上的一个真实进程；

这里我们可以看到 Spring Boot 应用的服务为 \{agent\_name\}-pid:\{pid\}@\{hostname\}，由 Agent 自动生成；

**3、端点(Endpoint) ：**对于特定服务所接收的请求路径, 如HTTP的URI路径和gRPC服务的类名 + 方法签名；

我们可以看到 Spring Boot 应用的一个端点，为API接口 /index

## 二、IDEA中使用SkyWalking ##

1、application.properties配置文件

server.port=8081
    server.servlet.context-path=/springboot-2-hello
    
    spring.mvc.view.prefix=/
    spring.mvc.view.suffix=.jsp

2、controller测试类

@Controller
    public class MyController {
    
        @RequestMapping("/hellospringboot")
        @ResponseBody
        public String helloSpringBoot(){
            return "欢迎使用SpringBoot框架";
        }
    }

3、在运行的程序配置jvm参数和环境变量参数

VM options：**-javaagent:D:\\SoftDevelopMentTools\\SkyWalking\\apache-skywalking-java-agent-8.8.0\\skywalking-agent\\skywalking-agent.jar**

注：Windows下安装 agent 的路径

Environment Variables：**SW\_AGENT\_COLLECTOR\_BACKEND\_SERVICES=192.168.133.129:11800;SW\_AGENT\_NAME=springboot-2-hello-idea**

注：Linux远程服务器的IP地址

![1e4f998520234aceaf726a3c1194840b.png][]

4、可看到本地运行 springboot 项目 控制台输出

DEBUG 2022-07-26 15:10:57:088 main AgentPackagePath : The beacon class location is jar:file:/D:/SoftDevelopMentTools/SkyWalking/apache-skywalking-java-agent-8.8.0/skywalking-agent/skywalking-agent.jar!/org/apache/skywalking/apm/agent/core/boot/AgentPackagePath.class. 
    INFO 2022-07-26 15:10:57:090 main SnifferConfigInitializer : Config file found in D:\SoftDevelopMentTools\SkyWalking\apache-skywalking-java-agent-8.8.0\skywalking-agent\config\agent.config.

![8d899a6e95b14e1288e8a9da2cb92002.png][]

5、输入访问

![dab37bda780e4014849d84fea52455a9.png][]

![7d68b3c2cc954bbd960478d191b42ce5.png][]

## 三、SkyWalking告警通知 ##

skywalking告警的核心由一组规则驱动，这些规则定义在

/xx/apache-skywalking-apm-bin/config/alarm-settings.yml 文件

![d4e9df4222484f80a2b6a937218ce95c.png][]

![bf013d0fa82d411c8840e7f546d27bb9.png][]

告警规则的定义分为三部分：

**1、告警规则**：它们定义了应该如何触发度量警报，应该考虑什么条件

**2、网络钩子(Webhook\}**：当警告触发时，哪些服务终端需要被通知

**3、gRPC钩子**：远程gRPC方法的主机和端口，告警触发后调用

为了方便，skywalking发行版中提供了默认的alarm-setting.yml文件，包括一些规则，每个规则有英文注释，可以根据注释得知每个规则的作用；

如 service\_resp\_time\_rule 规则：

service\_resp\_time\_rule:

metrics-name: service\_resp\_time

op: ">"

threshold: 1000

period: 10

count: 3

silence-period: 5

message: Response time of service \{name\} is more than 1000ms in 3 minutes of last 10 minutes.

该规则表示服务\{name\}的响应时间在最近10分钟的3分钟内超过1000ms；

只有我们的服务请求符合alarm-setting.yml文件中的某一条规则就会触发告警；

####  ####

#### **Webhook回调通知** ####

SkyWalking告警Webhook回调要求接收方是一个Web容器（如Tomcat服务），告警的消息会通过HTTP请求进行发送, 请求方法为POST, Content-Type为application/json, JSON格式基于

List<org.apache.skywalking.oap.server.core.alarm.AlarmMessage>的集合

package org.apache.skywalking.oap.server.core.alarm;
    
    import lombok.Getter;
    import lombok.Setter;
    import org.apache.skywalking.oap.server.core.analysis.manual.searchtag.Tag;
    
    import java.util.List;
    
    /**
     * Alarm message represents the details of each alarm.
     */
    @Setter
    @Getter
    public class AlarmMessage {
        private int scopeId;
        private String scope;
        private String name;
        private String id0;
        private String id1;
        private String ruleName;
        private String alarmMessage;
        private List<Tag> tags;
        private long startTime;
        private transient int period;
        private transient boolean onlyAsCondition;
    }

1、scopeId：所有可用的Scope请查阅

org.apache.skywalking.oap.server.core.source.DefaultScopeDefine

2、name：目标 Scope 的实体名称

3、id0：Scope 实体的 ID

4、id1：未使用

5、ruleName：在 alarm-settings.yml 中配置的规则名

6、alarmMessage：报警消息内容；

7、startTime：告警时间, 位于当前时间与 UTC 1970/1/1 之间

![4fabf5e844d74b129df57973018955cd.png][]

#### 告警应用 ####

1、/xx/apache-skywalking-apm-bin/config/alarm-settings.yml 文件 配置告警规则

该规则表示服务\{name\}的响应时间在最近10分钟的3分钟内超过1000ms

![6271718c5d0b475d88fd4d4c3ca8a22d.png][]

**2、配置Webhook回调通知！！！**

webhooks:
       - http:10.10.67.27:8081/notify
    #  - http://127.0.0.1/notify/
    #  - http://127.0.0.1/go-wechat/

输出到本地 IP 下的 notify接口

![b80978bf12e0484d8bd14895eaf052b5.png][]

3、编写controller测试类，notify 接口 对应上述 Webhook回调通知 webhooks:  
\- http:10.10.67.27:8081/notify

@Controller
    public class MyController {
    
        @RequestMapping("/hellospringboot")
        @ResponseBody
        public String helloSpringBoot(){
            return "欢迎使用SpringBoot框架";
        }
    
        @RequestMapping("/timeout")
        public @ResponseBody String timeout(){
            try{
                Thread.sleep(2000L);
            }catch (InterruptedException e){
                e.printStackTrace();
            }
            return "timeout";
        }
    
        @RequestMapping("/notify")
        public void notify(@RequestBody Object object){
            //给技术负责人发送警告短信、邮件等通知
            System.out.println(object.toString());
        }
    }

4、IDEA中配置使用SkyWalking

\-javaagent:D:\\SoftDevelopMentTools\\SkyWalking\\apache-skywalking-java-agent-8.8.0\\skywalking-agent\\skywalking-agent.jar

SW\_AGENT\_COLLECTOR\_BACKEND\_SERVICES=192.168.133.129:11800;SW\_AGENT\_NAME=springboot-1-hello-idea

![677ba277a69b44faac99b07f176e4564.png][]

5、启动运行，浏览器输入访问

![3368185413b3410e8ca5a48ba39ab6bb.png][]

6、SkyWalking-UI 查看告警

![4f17d2b46f614637b7d7c810738ed133.png][]

IDEA控制台输出告警信息

![bf8bee8949864c16b3cedf8b6869bbba.png][]

[https_blog.csdn.net_MinggeQingchun_article_details_125977930]: https://blog.csdn.net/MinggeQingchun/article/details/125977930
[c1732fbe56fd4945a1e3879eca305cb2.png]: https://img-blog.csdnimg.cn/c1732fbe56fd4945a1e3879eca305cb2.png
[1e4f998520234aceaf726a3c1194840b.png]: https://img-blog.csdnimg.cn/1e4f998520234aceaf726a3c1194840b.png
[8d899a6e95b14e1288e8a9da2cb92002.png]: https://img-blog.csdnimg.cn/8d899a6e95b14e1288e8a9da2cb92002.png
[dab37bda780e4014849d84fea52455a9.png]: https://img-blog.csdnimg.cn/dab37bda780e4014849d84fea52455a9.png
[7d68b3c2cc954bbd960478d191b42ce5.png]: https://img-blog.csdnimg.cn/7d68b3c2cc954bbd960478d191b42ce5.png
[d4e9df4222484f80a2b6a937218ce95c.png]: https://img-blog.csdnimg.cn/d4e9df4222484f80a2b6a937218ce95c.png
[bf013d0fa82d411c8840e7f546d27bb9.png]: https://img-blog.csdnimg.cn/bf013d0fa82d411c8840e7f546d27bb9.png
[4fabf5e844d74b129df57973018955cd.png]: https://img-blog.csdnimg.cn/4fabf5e844d74b129df57973018955cd.png
[6271718c5d0b475d88fd4d4c3ca8a22d.png]: https://img-blog.csdnimg.cn/6271718c5d0b475d88fd4d4c3ca8a22d.png
[b80978bf12e0484d8bd14895eaf052b5.png]: https://img-blog.csdnimg.cn/b80978bf12e0484d8bd14895eaf052b5.png
[677ba277a69b44faac99b07f176e4564.png]: https://img-blog.csdnimg.cn/677ba277a69b44faac99b07f176e4564.png
[3368185413b3410e8ca5a48ba39ab6bb.png]: https://img-blog.csdnimg.cn/3368185413b3410e8ca5a48ba39ab6bb.png
[4f17d2b46f614637b7d7c810738ed133.png]: https://img-blog.csdnimg.cn/4f17d2b46f614637b7d7c810738ed133.png
[bf8bee8949864c16b3cedf8b6869bbba.png]: https://img-blog.csdnimg.cn/bf8bee8949864c16b3cedf8b6869bbba.png