Odoo 模块详解

1安装与连接

从 apps.odoo.com 获取 blipit_monitor，或将仓库添加到你的 addons 路径（在 Odoo.sh 上作为 submodule），更新应用列表并安装 Blipit Error Monitoring。Odoo Online 不允许第三方模块；Odoo.sh 和本地部署可以。在“设置 › Blipit”中粘贴项目的私密密钥（blipit_sk_...），勾选“我同意 Blipit 服务条款和模块许可证”，然后保存。模块会用 database.uuid 的指纹调用 activate endpoint，并显示“已连接到 <project>（<org>）”。它会拒绝公钥（403）、已替换的密钥（401）和已在别处注册的数据库（409），并说明各自的原因。

2负责人

每家公司都有“Blipit：负责人”。在单席位套餐上，设置页面要求指定一个覆盖所有公司的人；席位更多且只有一家公司时，列出该公司的人员；有多家公司时，链接到“配置 › 负责人”。每个人需要邮箱和该公司的访问权限，并获得“Blipit：查看上报的问题”用户组。每次更改都会发送到 Blipit，由 Blipit 按套餐席位统计不同的人员，并拒绝超出席位的新增；Odoo 随后回滚更改并显示原因。新问题或回归的告警会发给事件所属公司的负责人；没有公司的事件或没有负责人的公司，会发给所有负责人。

3多公司访问

每个 Python 错误都带有当前公司作为标签，浏览器 SDK 也一样。Blipit 保留每个问题涉及的公司，同步时会存储它们。记录规则会向被允许访问其中某家公司的用户显示该问题；没有公司的问题（计划任务、公司之外的请求）对 Blipit 用户组中的所有人可见。

4Odoo 中的回归

Blipit 应用列出问题（默认为未解决；可按状态、异常类型或 release 分组）。已修复后复发的问题会在顶部注明，并区分两种情况：在同一个 release 中（修复可能从未上线）或在后续 release 中（有东西重新引入了它）。筛选器：修复后复发、修复从未上线。解决、忽略和重新打开会写回 Blipit；“在 Blipit 中打开”跳转到控制台。

5登录监控

“监控交互式登录”会上报失败、被拦截以及（勾选“上报成功登录”后）成功的登录，附带尝试的登录名、数据库、IP、user agent 和时间；绝不包含密码。全新安装时两者都已勾选；从旧版本升级时保持关闭，直到管理员勾选。它需要 Scale 套餐：在其他套餐上接入端会拒绝，模块会暂停十分钟并记录一次日志。只有当 Odoo 以 --proxy-mode 运行时，代理后面的客户端 IP 才是正确的。

6同步与刷新

计划任务“Blipit：同步问题”每十分钟运行一次；“从 Blipit 刷新”可立即执行。在 Blipit 侧删除的问题会从 Odoo 中移除。负责人列表在每次同步时重新发送，因此更改的邮箱会在十分钟内到达 Blipit。套餐和公钥由后台发送线程最多每十分钟从 Blipit 重新读取一次，绝不在请求或登录路径上读取。

须知

• 恢复的副本：生产环境的副本带有生产环境的 database.uuid，会被拒绝并返回 409“this database is already reporting to a different Blipit project”。请给副本一个新的 database.uuid（设置 › 技术 › 系统参数），并用自己的密钥连接到自己的项目。测试和生产环境应始终是两个项目。
• 错误通过一个容量为 100 个事件的队列从后台线程发送；错误风暴时其余部分会被丢弃并记录警告，请求绝不会因 Blipit 而变慢或失败。UserError 和 AccessError 不会发送，因为 Odoo 记录它们时不带 traceback。
• 离开 Odoo 的内容：错误、不含查询字符串的请求 URL、用户的 id 和登录名、公司，以及你启用的登录尝试。密码、会话 token 和请求体绝不会离开。私密密钥绝不会到达浏览器。
• Odoo 自身代码和 site-packages 下的帧被标记为库帧，因此分组和可疑 commit 聚焦于你的模块。
• 版本历史：blipit.io/changelog。支持：support@blipit.io。