问题管理指南 (用户用)

引导您如何查看并管理基础设施运行过程中发生的各种故障及威胁情况。

📁 前往问题管理 →

📋 概述

问题管理是一个中央管理菜单，汇总了由 GIIP 代理和安全模块检测到的所有异常状态。管理员可以在此确定故障的优先级并记录处置结果。

🔍 核心功能说明

1. 问题列表与过滤

按严重程度 (Severity) 分类: 分为
```
Critical
```
(需立即处理)、
```
Warning
```
(警告)、
```
Info
```
(单纯信息)。
状态 (Status) 过滤器: 区分查看尚未解决的
```
Pending
```
问题及已完成处置的
```
Done
```
问题。
CSN 切换器: 如果管理多个客户账号 (CSN)，可通过顶部的切换器筛选特定 CSN 的问题。

2. 查看问题详情

在列表中点击问题可查看以下详细信息：

发生时间及对象: 显示故障起始于哪台服务器及具体时间。
故障内容: 提供错误信息或安全威胁类型等具体的文本数据。
关联日志: 可立即调阅问题发生前后的系统日志。

🛠️ 处置与状态变更

完成处理 (Done): 若已完成故障处置，请点击详情页下方的 [Done] 按钮。该问题将从列表中消失或以“已完成”状态存档。
强制完成 (Force Done): 对于持续发生的已知问题，可使用管理员权限进行强制完成处理，以暂停相关警报。

💡 使用技巧

定期检查: 每天早晨检查是否仍有
```
Pending
```
状态的问题，防止技术债堆积。
搜索: 通过特定关键词（如
```
Disk Full
```
、
```
Unauthorized
```
）搜索，快速查找类似的故障案例。

🛠️ API 规范 (开发人员用)

GIIP 提供专用 API (基于 SK)，支持从外部系统或脚本集成问题管理功能。

1. 认证方式

Header:
```
x-api-key: {YOUR_SECRET_KEY}
```
Query:
```
?sk={YOUR_SECRET_KEY}
```

2. 查询问题列表

Endpoint:
```
GET /api/giipIssuesSk
```
参数:
- ```
status
```
  (可选):
```
PENDING
```
  ,
```
IN_PROGRESS
```
  ,
```
DONE
```
  等
- ```
csn
```
  (可选): 特定客户序列号 (CSN)

示例:

curl -X GET "https://giipfaw.azurewebsites.net/api/giipIssuesSk?status=PENDING" \
  -H "x-api-key: YOUR_SECRET_KEY"

3. 查看问题详情

Endpoint:
```
GET /api/giipIssuesSk
```
参数:
- ```
isn
```
  : 问题唯一编号 (ISN)

示例:

curl -X GET "https://giipfaw.azurewebsites.net/api/giipIssuesSk?isn=123" \
  -H "x-api-key: YOUR_SECRET_KEY"

4. 更新问题状态

Endpoint:
```
PUT /api/giipIssuesSk
```
Body (JSON):
- ```
isn
```
  : 问题唯一编号 (ISN)
- ```
status
```
  : 目标状态 (例如:
```
DONE
```
  )

示例:

curl -X PUT "https://giipfaw.azurewebsites.net/api/giipIssuesSk" \
  -H "Content-Type: application/json" -H "x-api-key: YOUR_SECRET_KEY" \
  --data '{"isn": 123, "status": "DONE"}'

API 参考

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

📘 GIIP 问题 API 指南

故障排除

症状	原因	解决
问题列表显示为空	顶部的 CSN 切换器被设置为其他客户账号	在 CSN 切换器中重新选择要查看的客户账号 (CSN)。
已完成 (Done) 处理后问题仍显示在列表中	状态过滤器被设置为包含 `Done`	将状态过滤器切换为 `Pending` ，仅显示未解决的问题。
同一问题的警报反复发生	已知的持续性问题每次都被重新检测	使用管理员权限进行强制完成 (Force Done) 处理，以暂停警报。
问题详情中不显示关联日志	未从列表打开问题详情，或发生时间点没有日志	在列表中点击该问题，查看详情视图中的关联日志区域。

版本: 1.1 最后更新: 2026-04-30 源文件:

giipv3/public/help/giip-issue-user.zh-CN.md