Plausible社区版健康检查端点配置指南

健康检查的重要性

在Kubernetes环境中部署Plausible社区版时，配置正确的健康检查端点对于确保服务高可用性至关重要。健康检查机制可以帮助Kubernetes及时发现并处理服务异常，包括数据库连接中断等问题。

Plausible的健康检查端点

Plausible社区版提供了一个专门用于健康检查的API端点：/api/health。这个端点会检查以下关键组件的状态：

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

当所有组件都正常工作时，该端点会返回HTTP状态码200；如果任何组件出现异常，则会返回500状态码。

Kubernetes探针配置建议

对于Kubernetes部署，建议配置以下两种探针：

就绪探针(ReadinessProbe)

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

存活探针(LivenessProbe)

livenessProbe:
  httpGet:
    path: /api/health
    port: 8000
  initialDelaySeconds: 60
  periodSeconds: 15

关于数据库连接恢复的说明

值得注意的是，Plausible社区版已经内置了数据库连接恢复机制。当与ClickHouse的连接中断时，应用会自动尝试重新建立连接，这个过程可以在容器日志中观察到。这意味着即使连接暂时中断，也不一定需要重启Pod。

最佳实践建议

1. 为ReadinessProbe设置较短的检查间隔(如10秒)，以便快速发现服务不可用情况
2. 为LivenessProbe设置稍长的间隔(如15秒)，避免因短暂性能波动导致不必要的Pod重启
3. 适当延长initialDelaySeconds，给应用足够的启动时间
4. 监控容器日志中的数据库连接信息，了解连接状态变化

通过合理配置这些健康检查参数，可以显著提高Plausible在Kubernetes环境中的稳定性和可靠性。