运维监控日志与流式传输

日志与流式传输

Zeabur 为每个服务提供实时日志流式传输,让你能直接从仪表板实时掌握应用程序的运行状况。

查看日志

查看服务日志的步骤:

  1. 在 Zeabur 仪表板中打开你的项目。
  2. 选取你要查看的服务。
  3. 点击 Logs 分页。

日志查看器会实时显示应用程序的 stdoutstderr 输出。新的日志条目会在产生时自动出现,不需要手动刷新。

构建日志与运行时日志

Zeabur 将日志分为两类:

  • 构建日志 — 在构建阶段产生的输出(例如安装依赖包、编译等)。可以在每个部署的 Deployments 分页中查看。
  • 运行时日志 — 服务运行期间产生的输出。显示在 Logs 分页中,并以实时流式传输方式呈现。

搜索与筛选

日志查看器支持关键字搜索,帮助你定位特定的条目。在日志查看器顶端的筛选栏中输入搜索词,即可高亮显示并筛选匹配的行。

这在以下情况特别有用:

  • 寻找错误信息或堆栈追踪
  • 追踪特定的请求 ID
  • 依日志等级筛选(例如 ERRORWARN

日志保留

运行时日志在服务运行期间可供查阅。当服务重新启动或重新部署时,先前实例的日志将无法在仪表板中访问。

💡

Zeabur 不提供长期日志存储。如果你需要在当前服务生命周期之外保留日志,请集成外部日志服务,例如 LogflareBetter StackDatadog。你可以通过设定应用程序直接将输出发送至这些服务来转发日志。

最佳实践

  • 使用结构化日志。 以 JSON 格式输出日志,使其更易于搜索和解析,尤其是在转发至外部服务时。
  • 包含时间戳。 虽然 Zeabur 会为日志条目加上时间戳,但在应用程序输出中也加入时间戳可确保跨环境的一致性。
  • 使用适当的日志等级。 使用 INFO 记录例行事件,WARN 记录可恢复的问题,ERROR 记录需要关注的故障。避免在正式环境中输出过多的 DEBUG 信息。
  • 避免记录敏感数据。 绝不要记录密码、API 密钥或个人身份识别信息。