問題管理指南 (用戶用)

引導您如何查看並管理基礎設施運行過程中發生的各種故障及威脅情況。

📁 前往問題管理 →

📋 概述

問題管理是一個中央管理菜單，匯總了由 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-TW.md