天天看点

聊一聊对外API接口的存活检查可以怎么做

公司内部的API接口一般会分为两大类,一类是直接暴露在公网可以访问的,一类是只能在局域网内访问的。

暴露在公网的一般就是业务网关以及一些和第三方公司有着某些合作,从而进行数据交互的接口。

检查API接口是否存活,第一反应应该就是健康检查了。

在局域网环境内搭配 nginx 或注册中心之类的健康检查机制,一定程度的保证了只有健康的实例才会进行服务。

把这一块放到公网环境,判断一个API接口是否存活,情况就复杂很多了。

域名解析

SSL证书

响应情况

...

举个老黄待过的两个公司的实际例子,这两个公司遇到的都是SSL证书过期,没有及时更换的问题,直接就是最高级故障。

在这种情况下,其实接口在局域网内是能正常访问,可以理解成它是存活的,但是放到公网环境,用户就是不能访问到,这个时候对用户来说就是故障的。

所以涉及到对外服务API存活的检查,光一个简单的健康检查还是不够的,还需要站在用户的层面去考虑。

或许大家会说,这种事情不是运维负责的吗?怎么还要我们开发去操心?

这个很大程度是看团队的,有的团队都不一定有运维这个角色,都是开发搞定的。

另外,多丰富一点自己的技术栈和技术广度并不是什么坏事哈。

下面就简单介绍一下老黄的处理方案吧。

老黄这边选择的处理方案是 【Prometheus + Blackbox + Grafana + Alertmanager + PrometheusAlert】

Prometheus,Grafana 和 Alertmanager 这三个就不过多的介绍了。

下面主要介绍一下 Blackbox 和 PrometheusAlert:

Blackbox 是 Prometheus 官方提供的一种黑盒监测方案,也是本文一个最关键的点。

下面是一些常见的应用场景

HTTP 测试,定义 Request Header 信息,判断 Http status / Http Respones Header / Http Body 内容

TCP 测试, 业务组件端口状态监听,应用层协议定义与监听

ICMP 测试,主机探活机制

POST 测试,接口联通性

SSL 证书过期时间

PrometheusAlert 是开源的运维告警中心消息转发系统,支持主流的监控系统Prometheus、Zabbix,日志系统Graylog2,Graylog3、数据可视化系统Grafana、SonarQube等支持WebHook接口的系统发出的预警消息,支持将收到的这些消息发送到钉钉,微信,飞书,腾讯短信,腾讯电话,阿里云短信,阿里云电话,华为短信,容联云电话等。

换句话就是说,把告警消息通过 PrometheusAlert 发送个体企业微信机器人或钉钉机器人。

整个链路大概是这样的:

BlackBox 负责探测

Prometheus 主动 pull 探测的结果并进行存储

Prometheus 根据告警规则进行评估,将告警仍到 AlertManager

AlertManager 收到 Prometheus 的消息后,通知给 PrometheusAlert

PrometheusAlert 收到 AlertManager 的消息后,通知到对应的端

下面先用 docker 启动一个 blackbox-exporter 实例

运行后看到的大概就是这个样子。

聊一聊对外API接口的存活检查可以怎么做

这一块的配置基本不用变更,用默认的即可,主要的配置还是在 Prometheus 那边。

可以点击上图的 Configuration 去看默认的配置。

聊一聊对外API接口的存活检查可以怎么做

下面就去调整 Prometheus 的配置。

这里只以 http 检测为例来说明。

其中 <code>scrape_configs</code> 里面是最为重要的,一个是 params ,一个是 relabel_configs, 一个是 file_sd_configs。

剩下的就是一些常规配置了。

然后是 file_sd_configs 里面一堆可以变化的 yml 文件,也就是那些对外的域名要进行 http 检测的。

配置里面的 labels 是一些辅助信息,可以按需添加,可以在 grafana 里面进行展示的。

到这里,关于 blackbox 的配置基本就差不多了。

接下来是在 grafana 里面展示,看一下结果。

聊一聊对外API接口的存活检查可以怎么做
PS: 这里用的是 【9965】 这个模板。

面板虽然好看,但是我们不能每时每刻都在盯着这个面板的,所以还是离不开告警这一监控领域的大头。

下面是告警规则的配置

上面这个主要是3个告警规则,看描述就知道它的作用的,也不用过多的说明了,这些告警表达式是参考 Awesome Prometheus alerts 调整的。

再下一步就到告警消息的配置了。

先用 docker 启动一个 prometheus-alert 的实例

这里默认带了很多模板

聊一聊对外API接口的存活检查可以怎么做

这里选择自己定义一个告警模板

聊一聊对外API接口的存活检查可以怎么做

这里的模板是做了一个颜色的区分,告警的用红色,恢复的用绿色,由于 Prometheus 和 AlertManager 用的都是 UTC 时间,所以这里用 GetCSTtime 转化成北京时间。

最后是回到 alertmanager 里面去配置

最后来看一些实际告警和恢复的例子

聊一聊对外API接口的存活检查可以怎么做
聊一聊对外API接口的存活检查可以怎么做
聊一聊对外API接口的存活检查可以怎么做

如果不想考虑自己搭建的话,不少云产商也有提供类似的功能,好比阿里云有一个叫站点监控的产品也可以帮我们搞定这个问题,不过只能免费一个月,超过还是需要购买的。

聊一聊对外API接口的存活检查可以怎么做

API接口存活的检查其实也是一门不小的学问,考虑的内容还是不少的。经历过生产事故,所以对这一块会特别看重。

目前中小团队的监控体系应该是离不开事实标准的 Prometheus,所以在其基础上去拓展会有比较多成熟的可以借鉴的经验来落地。

https://github.com/prometheus/blackbox_exporter

https://grafana.com/grafana/dashboards/9965

https://awesome-prometheus-alerts.grep.to/rules

https://feiyu563.github.io

聊一聊对外API接口的存活检查可以怎么做

如果您认为这篇文章还不错或者有所收获,可以点击右下角的【推荐】按钮,因为你的支持是我继续写作,分享的最大动力!

作者:Catcher Wong ( 黄文清 )

来源:http://catcher1994.cnblogs.com/

声明:

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。如果您发现博客中出现了错误,或者有更好的建议、想法,请及时与我联系!!如果想找我私下交流,可以私信或者加我微信。

继续阅读