이슈 관리 가이드 (사용자용)

인프라 운영 중 발생하는 각종 장애 및 위협 상황을 확인하고 관리하는 방법을 안내합니다.

📁 이슈 관리 페이지로 이동 →

📋 개요

이슈 관리는 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
```
Parameters:
- ```
status
```
  (Optional):
```
PENDING
```
  ,
```
IN_PROGRESS
```
  ,
```
DONE
```
  ,
```
READY
```
  ,
```
REVIEW
```
  등
- ```
csn
```
  (Optional): 특정 고객사 번호

Response:

{
  "issues": [
    {
      "isn": 123,
      "title": "Disk Usage 95%",
      "status": "PENDING",
      "regdate": "2026-04-30T14:00:00Z",
      "summary": "Disk usage on Web-01 is critical...",
      "cSn": 71199
    }
  ]
}

3. 이슈 상세 조회

Endpoint:
```
GET /api/giipIssuesSk
```
Parameters:
- ```
isn
```
  : 이슈 고유 번호 (Integer)

Response:

{
  "issue": {
    "isn": 123,
    "title": "Disk Usage 95%",
    "content": "Full stack trace or detailed message here...",
    "status": "PENDING",
    "regdate": "2026-04-30T14:00:00Z",
    "cSn": 71199
  }
}

4. 이슈 등록 및 업데이트

Endpoint:

POST /api/giipIssuesSk

(등록) /

PUT /api/giipIssuesSk

(수정)

Body (JSON):
- ```
isn
```
  : (수정 시 필수) 이슈 고유 번호
- ```
title
```
  : 이슈 제목
- ```
content
```
  : 상세 내용
- ```
status
```
  : 상태값 (
```
PENDING
```
  ,
```
IN_PROGRESS
```
  ,
```
DONE
```
  ,
```
READY
```
  ,
```
REVIEW
```
  )
- ```
csn
```
  : 고객사 번호

Example (상태만 업데이트):

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"}'

Success Response:

{
  "success": true,
  "isn": 123,
  "message": "Success"
}

API 참조

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 GIIP 이슈 API 가이드

버전: 1.1 최종 업데이트: 2026-04-30 소스 파일:

giipv3/public/help/giip-issue-user.ko.md