7分钟阅读

仪表板概览指南

引导您如何使用登录 GIIP 平台后显示的整体基础设施状态仪表板。

🚀 前往仪表板 →

📋 概述

仪表板是一个集成监控界面，让您能够一目了然地掌握分布在全球的基础设施状态。它通过可视化实时指标和费用数据，辅助您做出快速决策。

🧭 页面结构 — 三层布局 (giip #2443/#2444/#2445/#2446)

仪表板顶部只先回答两个问题:"我现在必须决策什么"和"所有项目进展如何",其余明细一律下移。目的是即使项目很多,概览依然能装进一个手机屏幕。

① 需要我决策的事项

最多显示 5 条"没有人工判断就无法推进"的议题。

范围:仅限状态为 NEEDS_DECISION 或 WARN 的议题。
REVIEW 滞留、闸门回退、60 分钟无活动等由机器人每小时自动重新判定,因此不会出现在这里(属于第 ③ 层)。
没有待确认事项时,显示"暂无需要确认的事项"一行,而不是空卡片。
超过 5 条时显示前 5 条并附"还有 N 项"链接,跳转到按 NEEDS_DECISION 过滤的议题列表。
点击每一行进入该议题详情。
本层的数量本身就是自动化质量指标,自动化运转越好,数字越小。

② 项目状态

对有访问权限的项目每个显示一行。

项目	含义
进行中	`IN_PROGRESS` 数量
等待中	`READY` + `PENDING` 数量
受阻	`NEEDS_DECISION` + `WARN` + 超过 60 分钟无评论的 `IN_PROGRESS` + 闸门 3 次升级

信号灯:受阻 ≥ 1 为 🔴;受阻为 0 且进行中+等待中 ≥ 1 为 🟢;全为 0 为 ⚪(以"—"代替数字)。
⚠️ 第 ② 层的**"受阻"比第 ① 层更宽**。第 ① 层是"需要人来决策的",第 ② 层的受阻是"项目健康度"。
同一议题命中多个条件时只计一次(不重复统计)。
进行中但停滞超过 60 分钟的议题会同时出现在进行中和受阻中 — 这是有意为之,以便在一行内看出"在跑但卡住了"。
点击某行即选中该项目,再次点击取消选中。该选择仅在本仪表板画面内生效(第 ③ 层随后只显示该项目)。
行右侧的**「进入 →」按钮则不同。点击后会像顶部的项目选择一样切换登录会话所属的项目**,页面随之重新加载,整个应用(服务器列表、议题、KVS 等)都会切换到该项目。
- 屏幕较窄时文字会隐藏,只显示 → 箭头,功能相同。
- 在当前已进入的项目上,该按钮会变成灰色的 ✓ 且无法点击 — 因为点击也只会重新加载页面。
- 简而言之:点击行 = 只在本画面内缩小范围,「进入」= 真正切换到该项目。
已完成(DONE)的议题不计入任何统计。

③ 受阻问题

把「问题卡在某处」的所有情形集中到同一个板块。默认折叠（移动端始终折叠），标题旁的数量徽章让您不展开也能知道有多少条。

同一个问题只占一行。以前拆成 5 个小部件，同一个问题会重复出现（实测：问题 #2148 同时出现在 3 个小部件中）。
取而代之的是把受阻原因并列为徽章。有两个原因就会显示两个徽章。

徽章	含义
疑似伪造完成	状态为 `WARN` — 完成判定被反复推翻
等待用户决策	状态为 `NEEDS_DECISION`
关卡已达 3 次	自动退回达到 3 次上限，需要人工确认
关卡退回	已退回 1 次以上，但尚未达到上限
REVIEW 停滞 / PENDING 停滞	该状态下 7 天以上无活动（括号内为天数）
无 PR	处于 `REVIEW` 但任何仓库中都没有对应的 PR
无活动	`IN_PROGRESS` 但 60 分钟以上没有评论（括号内为分钟数）

徽章分三种颜色 — 红色表示必须由人处理，黄色表示自动化正在重试或已停滞，灰色为辅助信息。
在第 ② 层选择项目后，此列表只显示该项目。再次点击同一行即可恢复全部。
已完成（DONE）的问题不会出现。
先显示前 20 条，点击「再显示 N 条」展开其余（不是丢弃数据，只是折叠显示）。

③ 详情 — 其余板块

在受阻问题下方，错误、基础设施与参考统计板块也全部采用折叠式。 它们遵循同样的规则（数量徽章／0 条时置灰并下沉／记忆展开状态）。

板块	标题徽章统计的内容	初始状态	内容
受阻问题	卡住的问题数	仅桌面端展开	参见上文 ③
SES提案	待操作(pending+failed+analyzing)条数	仅uLevel≥70显示	csn=0公开提案的状态别摘要＋前3条操作链接
未解决的问题	未完成问题的总数	始终折叠	进行中／等待中的问题列表（每页 25・50・100 条）
错误日志	未解决的错误数	折叠	总计／已解决／未解决／最近四个卡片 + 按来源和严重度的分布
建议操作	建议条数	折叠	逐条查看并删除长期未巡检的服务器
服务器状态统计	异常服务器数	折叠	项目／服务器数 + 正常·异常环形图 + 异常服务器列表
域名到期日	30 天内到期的域名数	折叠	按到期时间由近到远排序（已到期的条数另有徽章）
项目 & 服务器	项目数	折叠	每个项目的服务器数／正常／异常（异常多的排在前）
KVS 活动摘要	有活动的 Factor 种类数	折叠	最近 24 小时的采集情况

未解决的问题为何默认折叠：它是仪表板上最长的列表，展开后会把下方所有板块挤出屏幕。即使折叠，标题旁的数字就是总条数，不展开也能知道有多少条。
标题徽章不是「当前屏幕上显示的行数」，而是**「值得展开查看的数量」**。例如错误日志显示的是未解决数而非错误总数，服务器状态显示的是异常数而非服务器总数。
查询失败时徽章显示 … 而不是 0 — 写成 0 会发出「没有问题」的错误信号。
错误日志板块仅对 uLevel 70 及以上的账号显示。

折叠 / 展开

各区块标题旁的数量徽章在折叠后依然可见 — 折叠不会让你失去信息。
0 条的区块不隐藏，而是置灰并移到列表最底部，让有内容的区块始终排在上面。
首次打开时：在移动端（视口宽度小于 768px）第 ③ 层全部折叠，因此第 ①② 层能落在首屏内。桌面端只展开第 ③ 层的第一个板块（「受阻问题」）。
折叠状态按浏览器分别记忆，且只要您亲自折叠或展开过一次，您的选择就优先于上述默认值。
在隐私窗口等存储被阻止的环境中页面依然正常，只是不再记忆状态。
折叠内容会从页面移除，展开时再加载(减轻移动端首次渲染负担)。

🔍 核心组件说明

1. 实时资产状态 (Asset Status)

以卡片形式显示当前管理的服务器和数据库总数及状态（Running、Stopped、Warning）。点击卡片可跳转至相应的列表页面。

2. 全球基础设施地图 (Infrastructure Map)

在地图上显示服务器所在的物理区域。如果特定区域的集群发生故障，地图上的图标将闪烁红色。

3. 多云费用摘要

以饼图 (Pie Chart) 形式显示已连接云账号（如 Azure、AWS）本月的累计预计费用占比。您可以查看较上月的增减趋势。

4. 最新问题与警报

列出最近发生的严重 (Critical) 和警告 (Warning) 级别的问题。点击问题可立即跳转至详细的原因分析页面。

🛠️ 使用技巧

过滤: 通过仪表板顶部的 [选择项目] 过滤器，您可以集中监控特定项目的数据。
刷新: 仪表板数据每分钟自动更新一次。如需手动刷新，请点击右上角的 [刷新] 图标。

💡 注意事项

如果特定指标显示为 Unknown，请首先检查对应服务器的 [代理状态]。

API 参考

有关此功能的 API 详细规范，请参阅专用指南。

📘 API 参考概述 (v1.2)

故障排除

症状	原因	解决
指标显示为 `Unknown`	对应服务器的代理未响应	检查服务器的 [代理状态] 并重新启动代理。
仪表板数据不刷新	自动刷新（1分钟周期）延迟或会话已过期	点击右上角的 [刷新] 图标，或重新登录。
费用摘要为空	未连接云账号（Azure、AWS）	检查云账号集成设置。
仅显示特定项目的数据	顶部的 [选择项目] 过滤器已应用	将过滤器更改为全部，以显示所有数据。

版本: 1.2 最后更新: 2026-09-15 源文件: giipv3/public/help/dashboard.zh-CN.md