Apache APISIX 网关健康检查与Prometheus监控实战指南

最新推荐文章于 2025-06-03 09:00:42 发布

刘冶琳Maddox

最新推荐文章于 2025-06-03 09:00:42 发布

阅读量416

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00697/article/details/148391580

Apache APISIX 网关健康检查与Prometheus监控实战指南

apisix The Cloud-Native API Gateway 项目地址: https://gitcode.com/gh_mirrors/ap/apisix

前言

在现代微服务架构中，API网关的健康状况直接影响着整个系统的稳定性。Apache APISIX作为高性能API网关，提供了完善的健康检查机制和监控能力。本文将深入讲解如何利用APISIX的健康检查功能配合Prometheus构建完整的API监控体系。

核心概念解析

健康检查机制

APISIX的健康检查分为两种模式：

主动检查(Active Checks)：网关定期主动向上游服务发送健康检查请求
被动检查(Passive Checks)：根据实际请求的响应情况判断服务健康状态

监控指标

健康检查会产生以下关键指标：

apisix_upstream_status：上游节点健康状态(1健康/0不健康)
apisix_http_status：请求响应状态码统计
apisix_http_requests_total：请求总量统计

环境准备

基础组件

APISIX网关：核心流量入口
etcd：配置存储
Prometheus：指标收集与存储
示例后端服务：web1和web2两个服务节点

开发工具

Docker及Docker Compose：容器化部署
cURL：API测试工具

详细配置步骤

1. 配置上游服务健康检查

通过APISIX Admin API配置包含健康检查的上游服务：

curl "http://127.0.0.1:9180/apisix/admin/upstreams/1" \
-H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
-X PUT -d '
{
   "nodes":{
      "web1:80":1,
      "web2:80":1
   },
   "checks":{
      "active":{
         "timeout":5,
         "type":"http",
         "http_path":"/health",
         "healthy":{
            "interval":2,
            "successes":1
         },
         "unhealthy":{
            "interval":1,
            "http_failures":2
         }
      }
   }
}'

参数说明：

healthy.interval：健康检查间隔(秒)
healthy.successes：成功次数判定为健康
unhealthy.http_failures：失败次数判定为不健康

2. 启用Prometheus插件

创建全局规则启用指标收集：

curl "http://127.0.0.1:9180/apisix/admin/global_rules" \
-H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
-X PUT -d '
{
   "id":"rule-for-metrics",
   "plugins":{
      "prometheus":{}
   }
}'

3. 创建路由规则

将请求路由到配置的上游服务：

curl "http://127.0.0.1:9180/apisix/admin/routes/1" \
-H "X-API-KEY: edd1c9f034335f136f87ad84b625c8f1" \
-X PUT -d '
{
   "name":"backend-service-route",
   "methods":["GET"],
   "uri":"/",
   "upstream_id":"1"
}'

监控数据验证

1. 生成测试流量

curl -i -X GET "http://localhost:9080/"

多次执行可观察到请求被负载均衡到不同后端节点。

2. 查看原始指标

curl -i http://127.0.0.1:9091/apisix/prometheus/metrics

典型输出示例：

apisix_upstream_status{name="/apisix/upstreams/1",ip="172.27.0.5",port="80"} 1
apisix_upstream_status{name="/apisix/upstreams/1",ip="172.27.0.7",port="80"} 1