SuperAPI AI 工具集

clickup-observability

部署与运维

查看项目

更新于 10-15 22:42

技能介绍

用途:为 ClickUp 集成建立可观测性,暴露可靠性、限流压力、投递健康与业务对账情况,同时不导出任务或成员内容。

主要能力:采集 X-RateLimit-* 为有界数值遥测(不采集 Authorization 头);监控 Webhook 健康/失败状态,超过七秒或投递失败计入失败行为;按端点族、版本、状态类、环境、Workspace 别名定义低基数指标;在传输与队列周围加追踪 span,不含请求/响应内容;监控剩余/重置速率、429、Webhook 延迟/状态/失败数、队列年龄与重复抑制;基于基线数据创建带 runbook 链接、负责人和已测试阈值的可执行告警;用合成故障验证仪表盘与告警并记录脱敏检查。

使用方式:用 Read、Glob、Grep 检查仓库、适配器、配置名、测试与证据;仅用 WebFetch 查当前官方 ClickUp 文档;确认目标文件、Workspace 边界与模式后用 Write 或 Edit。认证上,个人令牌仅用于可追责的个人/测试工作,面向用户的集成用 OAuth 授权码;令牌经受治理的密钥引用在服务端注入,放在 Authorization 中发送,校验授权的 Workspace ID,绝不打印令牌、OAuth 客户端密钥或 Webhook 密钥。

限制与边界:任务名、描述、评论、附件、邮件、原始 body、令牌与 Webhook 密钥均不得作为遥测;不得把用户/任务 ID 作为无界标签,不得为调试导出载荷,不得在无策略下自动重新激活失败 Webhook;无负责人或 runbook 的告警不得启用分页。ClickUp 对事件最多重试五次,失败事件在此之后不再重发。遥测含工作内容或密钥时应停止导出、隔离数据、必要时轮换并修复埋点;标签无界时聚合或哈希为受治理的低基数别名;Webhook 健康下降时排队/隔离并遵循事件 runbook。输出应包含信号清单、SLO、仪表盘、告警测试、脱敏结果、基数风险与 runbook 链接,并区分实测证据与建议埋点。