用途:从 AppFolio 物业管理 API 集成中收集诊断证据,用于支持升级和根因分析,避免支持工程师直接访问用户环境。
主要能力:对 properties、tenants、work_orders 端点做连通性探测,记录 HTTP 状态与延迟;检查客户端凭证对是否配置(仅记录是否设置并脱敏);收集限流响应头;生成日志文件清单(仅文件名与大小,不含原始日志体);收集 AppFolio 相关 npm 依赖版本;输出为可审查的脱敏 tarball,并给出事件范围与敏感数据排除的支持交接凭据;无法安全收集时采用失败即关闭策略。
必要用法:需预先安装 curl、jq、tar;配置 APPFOLIO_CLIENT_ID、APPFOLIO_CLIENT_SECRET(基本认证对)与 APPFOLIO_BASE_URL。收集前须获得事件批准并定义受影响时间窗口、组合与安全读取探针;凭证应通过 netrc 文件传递而不是放进 argv;分享前逐文件审查,用批准的支持渠道加密传输归档,并按事件策略删除本地副本。
适用场景:生产同步超时、认证拒绝、限流、数据同步问题等需要向支持提交诊断证据的情况。
限制:不得因数据可得而收集租户、租约、付款或原始日志体;不得将 API 响应体写入归档;若证据涉及敏感记录,应停止并另行申请批准的最小化导出。探测失败只作为探测失败的证据,不得据此扩大响应采集或绕过凭证控制。401/403 需与凭证负责人核验托管客户端配置,429 需保留限流头并暂停探测,5xx 或超时只收集脱敏的时间与状态证据。
其他信息:官方文档、状态页与工程博客等资料暂未提供具体 URL。