运行状况和就绪性检查端点

运行状况和就绪性检查端点

Langfuse 提供监控端点，用于检查自主部署的运行状况和就绪情况。这些端点对于负载均衡器、编排系统和监控工具至关重要。

概述

运行状况检查端点

运行状况检查验证应用程序是否正在运行和运行。

Web 容器运行状况检查

curl http://localhost:3000/api/public/health

默认行为：

• 默认情况下，此端点仅检查 API 是否正在运行。
• 即使数据库暂时不可用，也不验证数据库连接是否允许提供流量。
• 要在运行状况检查中包含数据库连接，请添加查询参数：

  curl http://localhost:3000/api/public/health?failIfDatabaseUnavailable=true

响应代码：

• 200 OK-API 正常运行 (使用参数时，数据库可访问)
• 503 服务不可用 - API 无法正常运行或数据库无法访问 (使用参数时)

工作容器运行状况检查

curl http://localhost:3030/api/health

响应代码：

• 200 OK—— 工作人员服务正常运行，数据库连接成功
• 503 服务不可用 —— 工作服务无法正常运行或无法连接到数据库

就绪检查端点

就绪检查表明 Web 应用程序是否准备好接收流量，这在优雅关闭时特别有用。

curl http://localhost:3000/api/public/ready

响应代码：

• 200 OK—— 应用程序已准备好服务流量
• 500 内部服务器错误 —— 应用程序已收到关闭信号 (SIGTERM 或 SIGINT), 不应接收新流量