该技能用于识别并冻结长期无人访问的看板,基于审计项目中的 dashboard_search 事件数据进行判断。
用途 自动找出过去指定天数(默认 30 天,可配置为 60/90 天)内查询次数低于阈值(默认 1)的看板,并在用户确认后执行冻结。默认行为是冻结而非删除。
主要能力
- 通过 dashboard_search 事件统计各看板的查询次数。
- 可配置参数包括 INACTIVE_DAYS(默认 30)、TARGET_PROJECT(默认当前对话项目)、AUDIT_PROJECT(需用户指定或从项目列表中识别)、MIN_QUERY_COUNT(默认 1)、OUTPUT_FORMAT(table/json/csv)。
- 输出分为不活跃候选表、活跃看板汇总行、已删除看板表三部分;不活跃表按查询次数升序排列。
使用方式
- 仅使用 ae-cli,不使用其他 HTTP 端点或外部工具。
- 执行前需满足 PROJECT_ID_GATE:通过
ae-cli team +list-projects确认目标项目与审计项目;若审计项目未找到则立即停止,区分“无权限(联系管理员)”与“未部署(联系 CSM)”两种情况。 - 步骤包括:检索全部看板(分页合并)→ 在审计项目中查询看板活动 → 计算不活跃集合与已删除集合 → 输出结果并确认冻结意图 → 对确认目标调用 dashboard get 检查状态 → 最终确认后执行冻结。
- 冻结命令为:
ae-cli analysis dashboard freeze --project-id <TARGET_PROJECT_ID> --dashboard-ids '[<id1>, <id2>, ...]' --freeze true。
适用场景
- 需要清理或冻结长期无人使用的分析看板。
- 需要基于真实访问数据(而非更新时间等代理指标)判断看板活跃度。
限制
- 分析查询必须在审计项目中运行,而非目标项目。
- 不得猜测 project_id、dashboard_id 或 project_name,必须通过 API 获取。
- 任何写操作前必须展示候选并获得用户明确确认;不活跃候选的 dashboard get 调用是惰性的,仅在用户确认后才执行。
- 不活跃集合中不得包含已冻结或已删除的看板。
- 若审计项目无 dashboard_search 数据,则警告并将全部看板视为候选。
- 若 INACTIVE_DAYS 超出审计数据历史范围,需警告数据范围限制。
- 具体平台、收费、价格等信息暂未提供。