可观测性与稳定性 / 系统课时

用健康接口确认集群真正可用

用健康接口确认集群真正可用

容器显示 Up 只能证明进程还在运行,不能证明 Elasticsearch 已经能够接收查询,也不能证明 Kibana、Logstash 等组件已经建立正常连接。本节建立一套从容器状态到 HTTP API、再到集群健康信息的验证顺序。

学习目标

  • 区分容器运行、端口响应与服务真正可用
  • 使用 Elasticsearch HTTP API 检查节点和集群健康状态
  • 根据 Kibana、Logstash 和 Filebeat 日志定位启动阶段异常

先确认容器没有退出

在 Compose 项目目录执行:

bash
docker compose ps

预期结果是目标服务处于运行状态,实际容器名和运行时间可能不同:

text
NAME                  SERVICE         STATUS
<NAME>                elasticsearch   Up <TIME>
<NAME>                logstash        Up <TIME>
<NAME>                kibana          Up <TIME>
<NAME>                filebeat        Up <TIME>

如果某个服务显示 Exited 或反复重启,应先查看该服务日志,而不是继续测试上层组件。容器层异常通常意味着配置解析失败、内存不足、权限错误或进程直接退出。

用 HTTP API 验证 Elasticsearch

首先检查 Elasticsearch 是否已经接受 HTTP 请求:

bash
curl -s http://localhost:9200/

预期结果会包含节点名、集群名和版本信息,动态字段可能不同:

text
{
  "name" : "<NAME>",
  "cluster_name" : "docker-cluster",
  "version" : { ... },
  "tagline" : "You Know, for Search"
}

能获得该响应说明 HTTP 层已经工作,但判断集群状态还应查询 _cluster/health:

bash
curl -s "http://localhost:9200/_cluster/health?pretty"

单节点实验环境常见结果如下,分片数量等字段会随索引变化:

text
{
  "cluster_name" : "docker-cluster",
  "status" : "green",
  "number_of_nodes" : 1,
  "number_of_data_nodes" : 1
}

green 表示主分片和副本分片都已分配;yellow 表示主分片可用但至少有副本未分配;red 表示至少存在未分配的主分片。单节点环境出现 yellow 并不等同于 Elasticsearch 无法查询,常见原因是索引配置了副本,但没有第二个节点承载它。

检查节点是否真的加入集群

当健康接口返回异常,继续查看节点列表比只盯着容器状态更有效:

bash
curl -s "http://localhost:9200/_cat/nodes?v"

预期结果至少出现当前实验节点,IP、负载和节点名属于动态值:

text
ip         heap.percent ram.percent cpu load_1m load_5m load_15m node.role master name
<IP>       <VALUE>      <VALUE>     <VALUE> <VALUE> <VALUE> <VALUE>   <ROLE>    *      <NAME>

如果根接口能够响应但节点或集群状态异常,应继续检查 Elasticsearch 日志,而不是通过重启其他组件掩盖问题。

验证 Kibana 和采集链路

Kibana 提供状态接口,可直接判断服务是否已经完成初始化:

bash
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5601/api/status

预期结果通常为成功状态码:

text
200

如果返回连接失败,先确认 Kibana 容器仍在运行,再查看日志:

bash
docker compose logs --tail=50 kibana logstash filebeat

预期结果不是固定文本,因为日志包含时间和运行状态。健康情况下不应持续重复出现 Elasticsearch 连接失败、Logstash pipeline 无法启动或 Filebeat 无法连接 logstash:5044 等错误。

遇到异常时按层定位

docker compose ps 正常但 curl localhost:9200 失败时,重点检查 Elasticsearch 是否仍在初始化、端口映射是否正确以及启动日志。9200 正常而 Kibana 不可用时,则检查 Kibana 配置的 Elasticsearch 地址和自身启动日志。

如果 Elasticsearch 与 Kibana 都正常,但日志迟迟没有进入索引,应把注意力转到 Logstash pipeline 和 Filebeat 输出连接。此时健康检查的价值不是简单得到一个 green,而是确定故障发生在哪一层,再针对该层读取日志和配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用健康接口确认集群真正可用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通