可观测性

FrankenPHP 提供内置的可观测性功能：兼容 Prometheus 的指标和结构化日志。 这些功能与以下推荐工具结合使用，可让你在开发和生产环境中全面了解 PHP 应用的运行状态。

Ember 是监控 FrankenPHP 最友好的方式。

它连接到 Caddy 的管理 API，并与 FrankenPHP 深度集成，提供零配置、无需外部基础设施的实时可见性。

它专为开发和生产环境设计，提供用于本地使用的 TUI 仪表盘，以及用于生产监控的 Prometheus 导出守护进程模式。

Tip

请参阅 Ember 文档了解完整功能列表和设置详情。

当启用 Caddy 指标时，FrankenPHP 会暴露兼容 Prometheus 的指标，涵盖线程、worker、请求处理和队列深度。

请参阅指标页面获取可用指标的完整列表。

FrankenPHP 集成了 Caddy 的日志系统，并提供 frankenphp_log() 函数用于结构化日志记录，支持严重级别和上下文数据，便于接入 Datadog、Grafana Loki 或 Elastic 等平台。

请参阅日志页面获取使用详情。

如果你更倾向于自定义监控方案，可以直接抓取 FrankenPHP 的指标。 有两种方式：

1. 直接抓取 Caddy：Caddy 在其管理端点暴露指标（默认：localhost:2019/metrics）
2. 通过 Ember 抓取：当 Ember 以 --expose 模式运行时，它会在专用端点上暴露 FrankenPHP 指标以及从 Caddy 数据计算得出的指标（RPS、延迟百分位数、错误率）。