部署托管/Logging_and_monitoring
监控#
你可以调用三个 API 端点来检查实例的状态:/healthz、/healthz/readiness 和 /metrics。
healthz 与 healthz/readiness#
/healthz 端点返回标准的 HTTP 状态码。200 表示实例可访问,但不反映数据库(DB)状态。该端点对自托管和云版本用户均可用。
访问该端点:
1| ``` /healthz
---|---
`/healthz/readiness` 端点与 `/healthz` 类似,但它仅在数据库已连接且完成迁移(即实例已准备好接收流量)时返回 HTTP 状态码 200。
访问该端点:1
| ```
<your-instance-url>/healthz/readiness---|---
metrics#
/metrics 端点提供有关实例当前状态的更详细信息。
访问该端点:
1| ``` /metrics
---|---
功能可用性
`/metrics` 端点在 n8n Cloud 上不可用。
## 为自托管 n8n 启用 metrics 和 healthz#
默认情况下,`/metrics` 和 `/healthz` 端点是禁用的。要启用它们,请配置你的 n8n 实例:1 2 3 4
| ```
# metrics
N8N_METRICS=true
# healthz
QUEUE_HEALTH_CHECK_ACTIVE=true---|---
有关如何使用环境变量配置实例的更多信息,请参考 配置方法(Configuration methods)。