可观测性与稳定性 / 系统课时
用健康接口确认集群真正可用
用健康接口确认集群真正可用
容器显示 Up 只能证明进程还在运行,不能证明 Elasticsearch 已经能够接收查询,也不能证明 Kibana、Logstash 等组件已经建立正常连接。本节建立一套从容器状态到 HTTP API、再到集群健康信息的验证顺序。
学习目标
- 区分容器运行、端口响应与服务真正可用
- 使用 Elasticsearch HTTP API 检查节点和集群健康状态
- 根据 Kibana、Logstash 和 Filebeat 日志定位启动阶段异常
先确认容器没有退出
在 Compose 项目目录执行:
docker compose ps预期结果是目标服务处于运行状态,实际容器名和运行时间可能不同:
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 请求:
curl -s http://localhost:9200/预期结果会包含节点名、集群名和版本信息,动态字段可能不同:
{
"name" : "<NAME>",
"cluster_name" : "docker-cluster",
"version" : { ... },
"tagline" : "You Know, for Search"
}能获得该响应说明 HTTP 层已经工作,但判断集群状态还应查询 _cluster/health:
curl -s "http://localhost:9200/_cluster/health?pretty"单节点实验环境常见结果如下,分片数量等字段会随索引变化:
{
"cluster_name" : "docker-cluster",
"status" : "green",
"number_of_nodes" : 1,
"number_of_data_nodes" : 1
}green 表示主分片和副本分片都已分配;yellow 表示主分片可用但至少有副本未分配;red 表示至少存在未分配的主分片。单节点环境出现 yellow 并不等同于 Elasticsearch 无法查询,常见原因是索引配置了副本,但没有第二个节点承载它。
检查节点是否真的加入集群
当健康接口返回异常,继续查看节点列表比只盯着容器状态更有效:
curl -s "http://localhost:9200/_cat/nodes?v"预期结果至少出现当前实验节点,IP、负载和节点名属于动态值:
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 提供状态接口,可直接判断服务是否已经完成初始化:
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5601/api/status预期结果通常为成功状态码:
200如果返回连接失败,先确认 Kibana 容器仍在运行,再查看日志:
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,而是确定故障发生在哪一层,再针对该层读取日志和配置。