日志与流式传输
Zeabur 为每个服务提供实时日志流式传输,让你能直接从仪表板实时掌握应用程序的运行状况。
查看日志
查看服务日志的步骤:
- 在 Zeabur 仪表板中打开你的项目。
- 选取你要查看的服务。
- 点击 Logs 分页。
日志查看器会实时显示应用程序的 stdout 和 stderr 输出。新的日志条目会在产生时自动出现,不需要手动刷新。
构建日志与运行时日志
Zeabur 将日志分为两类:
- 构建日志 — 在构建阶段产生的输出(例如安装依赖包、编译等)。可以在每个部署的 Deployments 分页中查看。
- 运行时日志 — 服务运行期间产生的输出。显示在 Logs 分页中,并以实时流式传输方式呈现。
搜索与筛选
日志查看器支持关键字搜索,帮助你定位特定的条目。在日志查看器顶端的筛选栏中输入搜索词,即可高亮显示并筛选匹配的行。
这在以下情况特别有用:
- 寻找错误信息或堆栈追踪
- 追踪特定的请求 ID
- 依日志等级筛选(例如
ERROR、WARN)
日志保留
运行时日志在服务运行期间可供查阅。当服务重新启动或重新部署时,先前实例的日志将无法在仪表板中访问。
💡
Zeabur 不提供长期日志存储。如果你需要在当前服务生命周期之外保留日志,请集成外部日志服务,例如 Logflare、Better Stack 或 Datadog。你可以通过设定应用程序直接将输出发送至这些服务来转发日志。
最佳实践
- 使用结构化日志。 以 JSON 格式输出日志,使其更易于搜索和解析,尤其是在转发至外部服务时。
- 包含时间戳。 虽然 Zeabur 会为日志条目加上时间戳,但在应用程序输出中也加入时间戳可确保跨环境的一致性。
- 使用适当的日志等级。 使用
INFO记录例行事件,WARN记录可恢复的问题,ERROR记录需要关注的故障。避免在正式环境中输出过多的DEBUG信息。 - 避免记录敏感数据。 绝不要记录密码、API 密钥或个人身份识别信息。