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

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

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

📋 개요

이슈 관리는 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 가이드

문제 해결

증상	원인	해결
이슈 목록이 비어 있게 보인다	상단 CSN 스위처가 다른 고객사로 설정되어 있음	CSN 스위처에서 조회하려는 고객사(CSN)를 다시 선택합니다.
Done 처리했는데도 이슈가 목록에 계속 보인다	Status 필터가 `Done` 을 포함하도록 설정됨	Status 필터를 `Pending` 으로 변경하여 미해결 이슈만 표시합니다.
동일한 이슈 알람이 반복적으로 발생한다	알려진 지속성 이슈로 매번 새로 탐지됨	관리자 권한으로 강제 완료(Force Done) 처리하여 알람을 일시 중지합니다.
이슈 상세에서 연관 로그가 보이지 않는다	목록에서 이슈 상세를 열지 않았거나 발생 시점 로그가 없음	목록에서 해당 이슈를 클릭해 상세 보기의 연관 로그 영역을 확인합니다.

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

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