redislabs/healthcheck

Redis Enterprise集群健康检查工具

镜像概述

该Docker镜像包含一个命令行工具，专门用于监控和检查Redis Enterprise集群的健康状态。通过执行一系列预定义检查，帮助管理员快速评估集群的运行状况，及时发现潜在问题并进行干预。

核心功能与特性

• 集群状态检查：验证Redis Enterprise集群的整体可用性和运行状态
• 节点健康检测：检查集群中各节点的服务状态、资源使用情况
• 服务可用性验证：确认Redis数据库服务是否正常提供服务
• 数据同步检查：验证主从节点间的数据同步状态
• 灵活配置：支持通过命令行参数自定义检查项和阈值
• 多输出格式：提供文本和JSON格式的检查结果，便于集成到监控系统

使用场景与适用范围

• 日常运维监控：定期执行集群健康检查，确保系统稳定运行
• 部署验证：新集群部署或升级后，验证系统是否正常工作
• 故障排查：集群出现异常时，快速定位问题节点和服务
• 监控告警集成：与Prometheus、Grafana等监控工具配合，实现告警机制
• 自动化运维：集成到CI/CD流程或自动化脚本中，作为集群健康验证步骤

使用方法

基本使用

拉取镜像：

bash
docker pull docker.xuanyuan.run/redislabs/healthcheck:latest

执行基本健康检查：

bash
docker run --rm docker.xuanyuan.run/redislabs/healthcheck \
  --cluster-url https://<redis-enterprise-cluster-ip>:8443 \
  --username <admin-username> \
  --password <admin-password>

详细检查

执行包含节点和数据同步的详细检查：

bash
docker run --rm docker.xuanyuan.run/redislabs/healthcheck \
  --cluster-url https://<redis-enterprise-cluster-ip>:8443 \
  --username <admin-username> \
  --password <admin-password> \
  --check-nodes true \
  --check-sync true \
  --timeout 30

JSON格式输出

获取JSON格式的检查结果，便于机器解析：

bash
docker run --rm docker.xuanyuan.run/redislabs/healthcheck \
  --cluster-url https://<redis-enterprise-cluster-ip>:8443 \
  --username <admin-username> \
  --password <admin-password> \
  --output json

配置参数说明

输出说明

文本格式输出示例

Redis Enterprise Cluster Health Check Results
=============================================
Cluster URL: https://192.168.1.100:8443
Check Time: 2023-10-15T14:30:00Z

Overall Status: HEALTHY

Cluster Information:
- Cluster Name: redis-enterprise-cluster
- Version: 6.2.18
- Nodes: 3 (all healthy)
- Databases: 5 (all running)

Node Health:
- Node 192.168.1.101: Healthy (CPU: 25%, Memory: 40%)
- Node 192.168.1.102: Healthy (CPU: 30%, Memory: 35%)
- Node 192.168.1.103: Healthy (CPU: 20%, Memory: 38%)

Data Sync:
- Database "mydb": In sync (Master: 192.168.1.101, Slave: 192.168.1.102)

JSON格式输出示例

json
{
  "cluster_url": "[***]",
  "check_time": "2023-10-15T14:30:00Z",
  "overall_status": "HEALTHY",
  "cluster_info": {
    "name": "redis-enterprise-cluster",
    "version": "6.2.18",
    "node_count": 3,
    "healthy_node_count": 3,
    "database_count": 5,
    "running_database_count": 5
  },
  "nodes": [
    {
      "ip": "192.168.1.101",
      "status": "HEALTHY",
      "cpu_usage": 25,
      "memory_usage": 40
    },
    {
      "ip": "192.168.1.102",
      "status": "HEALTHY",
      "cpu_usage": 30,
      "memory_usage": 35
    },
    {
      "ip": "192.168.1.103",
      "status": "HEALTHY",
      "cpu_usage": 20,
      "memory_usage": 38
    }
  ],
  "data_sync": [
    {
      "database": "mydb",
      "status": "IN_SYNC",
      "master_node": "192.168.1.101",
      "slave_node": "192.168.1.102"
    }
  ]
}