文档导航与搜索
常见问题与故障反馈
按现象定位登录、接入、作业和通知问题，并准备支持人员可以使用的脱敏信息。
本页目录
排查前先保留哪些信息
- 发生时间和时区、操作页面、期望结果与实际现象。记录最后一次正常时间，以及近期是否升级或修改配置。
- 平台与 Agent 版本、部署方式、操作系统和影响范围。区分所有用户异常、单个项目异常和单台目标异常。
- 保存原执行或会话记录。结果未知时先查询状态，不连续提交新的操作。
按现象检查
| 现象 | 先检查 | 不要这样处理 |
|---|---|---|
| 安装后打不开页面 | 安装健康检查、实际访问地址、网络入口和 HTTPS | 在另一台电脑把 127.0.0.1 当作服务器地址 |
| 登录或 MFA 失败 | 租户、身份源、账号状态与设备时间 | 关闭 MFA 或共享管理员密码 |
| 资源清单为空 | 项目权限、筛选条件、同步结果 | 直接认为资源已删除 |
| Agent 离线 | 主机服务、最近心跳、网关网络与证书 | 先注销再反复注册 |
| 作业超时或部分失败 | 逐目标状态、失败阶段和是否部分生效 | 不核对结果就对所有主机重跑 |
| 没有收到通知 | 真实发送配置、通道、静默、队列与投递记录 | 把消息已登记当作人已收到 |
| AI 无法分析 | 接入模式、模型连接、凭据、知识检索状态，以及 License 页面的授权项中是否有 ai | 把未知输出改成正常或已修复 |
平台诊断包
Compose 交付环境如包含诊断工具，可由获准的管理员在交付目录运行以下命令。它只读采集平台主机和容器信息，不是 Agent 目标主机的诊断入口。
- 内容包括主机资源、容器健康和退出状态、近期脱敏日志、数据库健康元数据与卷占用。环境变量只收集名称，不收集值。
- 默认在 /tmp 下生成 chronoops-diag-时间戳.tar.gz，文件权限为 0600。发送前自行检查清单与内容，自动脱敏不能替代人工审核。
- 诊断包不包含业务表数据、会话录制或完整作业输出。Helm 环境应使用适配该部署方式的支持流程。
bash scripts/delivery/diagnostics/chronoops-diagnostic-bundle.sh如何提交有效的问题反馈
联系 weiwendi@aiops.red，先提供问题摘要与必要范围。生产日志、数据库导出和录制文件不要作为普通邮件附件；如确需进一步材料，先确认授权与传输方式。
Version / 版本:
Deployment / 部署方式:
Time and timezone / 时间与时区:
Affected feature / 功能页面:
Expected result / 预期结果:
Observed result / 实际现象:
Reproduction steps / 复现步骤:
Recent changes / 最近变更:
Redacted error summary / 脱敏错误摘要:需要先停下来的情况
发现目标身份不符、签名校验失败、主机指纹变化、凭据可能泄露或恢复将覆盖现有数据时，先停止继续操作并联系负责人。不要为“让流程跑通”跳过安全检查、删除记录或扩大执行范围。
遇到与文档不一致的情况
请提供部署版本、页面和脱敏后的现象，我们会协助核对并更新文档。
weiwendi@aiops.red