SuperAPI AI 工具集

notion-observability

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:为 Notion 集成定义一套可审计的观测性契约,覆盖指标、日志、追踪、告警与对账信号,确保运维可诊断的同时不泄露内容。

主要能力与当前契约:运维信号应区分操作类别、状态、结构化错误码、请求 ID、延迟、重试、队列年龄、游标年龄与对账差值。页面 ID、标题、内容、用户数据、令牌和签名 URL 属于不安全的默认标签。依赖可变字段、端点、版本、限制或投递行为前,需重新核对带日期的证据映射。

认证与数据边界:遥测管道不接收 bearer 或验证令牌,改用租户别名与经监控边界批准的有界指纹。要求先做脱敏再序列化,并在保留安全事件之后再做采样。用内部操作 ID 与厂商请求 ID 关联重试,但不含内容。

使用方式:先定义服务、新鲜度、正确性与安全目标及负责人;建立低基数的操作分类,覆盖读取、写入、Webhook、队列、文件与对账;对持续错误类别、Retry-After 压力、队列年龄、游标过期与对账漂移告警;用合成故障演练仪表盘与告警并记录响应归属。工具纪律上,用 Read、Glob、Grep 检查文档、配置、代码与证据,Write 和 Edit 仅用于已批准的仓库产物;仅调用不授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、花费或删除。

审批与错误处理:新增标识符、载荷片段、用户字段或第三方遥测处理器前需数据与安全审批。不得用页面或工作区 ID 作为无界指标标签;请求率仪表盘变绿不能证明同步完整;脱敏不可用时失败关闭。

输出与限制:返回信号目录、脱敏契约、目标定义、仪表盘、告警、运行手册链接与测试回执,明确假设、负责人、过期时间与证据缺口。验证路径包括密钥金丝雀、内容金丝雀、基数、告警触发、对账漂移与遥测中断。资料未提供具体定价、平台支持范围或安装命令。