---
url: /docs/deployment/monitoring.md
---
# 日志与监控

## 服务端日志

```sh
bun wrangler tail --config apps/api/wrangler.jsonc --env staging
```

生产选择空环境名。先确认目标服务和环境，再用请求标识关联接口错误、用户操作和数据库状态。三个 Worker 的日志分别查看，入口成功不等于下游接口成功。

## 本地排查

`bun run preview:status` 显示受管理服务状态，`.local` 保存对应日志和邮件捕获记录。更改构建产物后重新启动预览；不要误停其他对比模板服务。

## 观察什么

关注接口错误率、响应耗时、数据库连接、邮件发送失败、支付回调失败、工具失败与重复请求。公开站访问统计由 `websiteConfig.analytics` 控制，可按需接入 Cloudflare 的公开页面统计；它不是业务错误监控。

日志只保存必要的错误类型和标识，不记录密码、认证 token、支付密钥或用户文件正文。建立告警时先确认通知通道真实可用。

## 回滚与成本

发布失败先确认各服务版本及数据库迁移是否已执行，再选择补齐发布或回滚兼容代码。Worker 回滚不会恢复数据库和第三方订阅状态。

分别观察 Worker、数据库、存储与外部服务用量。当前主站未接入对象存储、队列或生成模型，不应把这些模块的费用纳入“已验证免费运行”结论。