Plausible Analytics健康检查端点配置指南

概述

在使用Plausible Analytics时，特别是在Kubernetes环境中部署时，配置正确的健康检查端点对于确保服务可靠性至关重要。本文将详细介绍Plausible的健康检查机制及其在容器化环境中的最佳实践。

健康检查端点

Plausible提供了一个内置的健康检查端点/api/health，该端点会返回HTTP状态码200表示服务健康，500表示服务异常。这个端点会全面检查以下组件状态：

1. PostgreSQL数据库连接状态
2. ClickHouse数据库连接状态
3. 站点缓存预热状态

Kubernetes探针配置建议

在Kubernetes中部署Plausible时，建议配置以下探针：

LivenessProbe配置

livenessProbe:
  httpGet:
    path: /api/health
    port: 8000
  initialDelaySeconds: 60
  periodSeconds: 10
  failureThreshold: 3

ReadinessProbe配置

readinessProbe:
  httpGet:
    path: /api/health
    port: 8000
  initialDelaySeconds: 30
  periodSeconds: 10
  failureThreshold: 3

连接恢复机制

Plausible具有自动重连机制，当检测到ClickHouse连接断开时，会自动尝试重新建立连接。这一特性意味着：

1. 短暂的网络问题不会导致服务中断
2. 不需要通过重启容器来恢复数据库连接
3. 连接恢复过程可以在日志中查看（通过docker compose logs plausible命令）

最佳实践

1. 初始延迟设置：建议为LivenessProbe设置较长的初始延迟（60秒），给应用充分的启动时间
2. 检查频率：10秒的检查间隔是一个合理的平衡点
3. 故障阈值：3次连续失败才判定为不健康，避免短暂问题导致的误判
4. 日志监控：定期检查Plausible日志，了解连接状态变化

注意事项

1. 健康检查端点会检查所有关键依赖，包括PostgreSQL和ClickHouse
2. 当返回500状态码时，应检查日志确定具体是哪个组件出现了问题
3. 在Kubernetes环境中，确保网络策略允许Pod访问健康检查端点

通过合理配置这些健康检查机制，可以确保Plausible Analytics服务在Kubernetes环境中保持高可用性，并在出现问题时能够及时被发现和处理。