SuperAPI AI 工具集

glean-debug-bundle

测试与质量

查看项目

更新于 10-15 23:26

技能介绍

用途:从 Glean 企业搜索集成中收集诊断证据,用于排查数据源配置、文档索引流水线及搜索质量问题,无需管理员控制台访问即可定位连接器故障、索引过期、文档结果缺失和基于权限的搜索缺口。

前置条件:需安装 curl、jq、tar;设置 GLEAN_DOMAIN(如 your-company-be.glean.com)、GLEAN_INDEXING_TOKEN(数据源/索引端点用)和 GLEAN_CLIENT_TOKEN(搜索 API 用)。

主要能力:脚本会采集环境信息(令牌仅标记是否设置并脱敏)、数据源配置、索引状态、搜索质量测试、最近连接器日志、速率限制响应头及依赖版本,并打包为 tar.gz。分析时可解压后用 jq 检查 objectType、status、results 数量等字段。

常见问题排查:索引 API 返回 401 检查令牌是否设置;数据源配置为空需设置 GLEAN_DATASOURCE;搜索 0 结果检查索引状态和爬取完成情况(新数据源需 15-60 分钟);搜索端点 403 表示客户端令牌权限不足;结果陈旧需触发重新爬取;批量索引被限流时按 100 条分批并遵守每秒 10 次限制。

采集规范:使用合成探测和限定时间窗口,仅收集状态码、时间区间、配置版本和不透明关联 ID;写入前必须脱敏或排除授权头、令牌、查询文本、文档正文、结果片段、用户标识和组成员关系。将压缩包加密存放在批准的事件位置,授予最小支持范围,并按保留日期删除。若无法验证脱敏、目标位置未获批准或命令可能泄露生产凭证,应停止收集并升级给事件负责人。

输出:生成含事件 ID、采集窗口、检查组件、关联 ID、聚合计数、策略/配置版本、探测结果、责任人、目标和保留日期的脱敏清单,清单不得包含敏感源数据。适用场景为 Glean 搜索集成运维与支持排障;限制包括需有效令牌、生产环境须遵循脱敏与保留政策、具体 API 参数与速率限制以 Glean 官方文档为准。