본문으로 건너뛰기

이슈 추적

모니터링 중 발견된 장애와 이슈를 체계적으로 추적하고 관리합니다.

1. 페이지 개요​

1.1 기능 설명​

이슈 추적 페이지는 모니터링 활동 중 발견된 문제점을 기록하고 추적할 수 있는 기능을 제공합니다.

  • 이슈 관리: 제목, 내용, 우선순위, 상태 관리
  • 댓글 시스템: 이슈별 토론 및 의사결정 기록 (상태 머신 패턴)
  • 라벨링: 이슈 분류 및 필터링 (2-Step Display-Manage)
  • 관련 이슈: 이슈 간 연결 관계 관리 (의존성, 차단, 중복) — 현재 비활성 상태
  • 첨부파일: 관련 파일 첨부, 이미지 확대 보기

1.2 접근 경로​

URL: /workgroup/[workgroupId]/tracking
메뉴: 대시보드 > 이슈 추적 > 이슈 추적
접근 권한

읽기 권한이 있는 모든 사용자가 조회할 수 있습니다. 쓰기 권한이 있어야 이슈를 생성/수정할 수 있습니다.

2. 화면 구성​

2.1 주요 영역​

영역설명
헤더페이지 제목, 신규 이슈 생성 버튼
통계 카드전체, 진행중, 완료 이슈 수
필터 영역검색어, 상태, 우선순위, 라벨 필터
이슈 목록데이터 테이블(DataGrid) 형태의 이슈 목록

2.2 전체 화면​

이슈 추적 전체 화면

2.3 UI 구성도​

3. 사용 방법​

3.1 이슈 생성​

  1. 신규 이슈 버튼 클릭: 우측 상단의 [+ 신규 이슈] 버튼을 클릭합니다
  2. 제목 입력: 이슈 제목을 입력합니다
  3. 내용 작성: 이슈 상세 내용을 작성합니다 (마크다운 지원)
  4. 우선순위 선택: HIGH, MEDIUM, LOW 중 선택합니다
  5. 라벨 지정: 필요한 라벨을 선택합니다
  6. 저장: 저장 버튼을 클릭하여 이슈를 생성합니다
우선순위 가이드라인
  • HIGH: 서비스 중단, 데이터 손실 등 즉각적인 대응이 필요한 경우
  • MEDIUM: 기능 장애, 성능 저하 등 정상 운영에 영향을 주는 경우
  • LOW: 개선 사항, 문서 요청 등 당장 처리가 급하지 않은 경우

3.2 이슈 조회​

3.2.1 필터 사용​

필터 항목설명
검색어제목 또는 내용의 키워드 검색
상태전체, 진행중(OPEN), 완료(CLOSED)
우선순위전체, 높음(HIGH), 중간(MEDIUM), 낮음(LOW)
라벨특정 라벨이 지정된 이슈만 표시
필터 초기화

필터가 적용된 상태에서 [초기화] 버튼을 클릭하면 모든 필터가 해제됩니다.

3.2.2 정렬 및 페이지네이션​

  • 컬럼 헤더를 클릭하여 정렬할 수 있습니다
  • 페이지당 20건씩 표시됩니다
  • 하단 페이지네이션으로 이동합니다

3.3 이슈 수정 (직접 편집)​

이슈 상세 페이지에서 별도의 편집 페이지로 이동하지 않고 직접 수정할 수 있습니다.

  1. 이슈 선택: 목록에서 수정할 이슈를 찾습니다
  2. 상세 페이지 이동: 행을 클릭하여 상세 페이지로 이동합니다
  3. 직접 편집: 수정할 필드를 직접 클릭하여 편집합니다
  4. 저장: 변경 사항은 즉시 또는 저장 버튼으로 반영됩니다
직접 편집 가능 필드
  • 제목: 제목을 클릭하면 입력 필드로 변환됩니다 (Enter로 저장)
  • 우선순위: 우선순위 태그를 클릭하면 선택 메뉴가 표시됩니다 (선택 시 자동 저장)
  • 본문: 본문 영역을 클릭하면 편집 모드로 진입합니다 (저장 버튼 클릭)

3.4 이슈 상태 변경​

3.4.1 완료 처리​

  1. 목록에서 완료할 이슈를 찾습니다
  2. 체크 아이콘을 클릭하거나 상세 페이지에서 [완료] 버튼을 클릭합니다
  3. 확인 대화상자에서 확인을 선택합니다
  4. 이슈 상태가 CLOSED로 변경됩니다

3.4.2 재개​

  1. 완료된 이슈를 찾습니다
  2. 새로고침 아이콘을 클릭하거나 상세 페이지에서 [재개] 버튼을 클릭합니다
  3. 이슈 상태가 OPEN(진행중)으로 변경됩니다

3.5 댓글 관리​

이슈 상세 화면에서 댓글을 관리할 수 있습니다.

  1. 이슈 상세 화면으로 이동합니다
  2. 댓글 입력창에 내용을 작성합니다
  3. [작성] 버튼을 클릭합니다
  4. 댓글이 목록에 추가됩니다
대댓글 및 상태 머신

기존 댓글의 [답글] 버튼을 클릭하여 대댓글을 작성할 수 있습니다. 댓글 시스템은 상태 머신(State Machine, idle → creating/updating/deleting)으로 관리되어 일관된 UI를 제공합니다.

3.6 라벨 관리​

라벨은 2-Step Display-Manage 패턴으로 관리됩니다.

  1. 이슈 상세 화면의 라벨 섹션으로 이동합니다
  2. 현재 할당된 라벨만 표시됩니다 (읽기 모드)
  3. 편집 버튼(연필 아이콘)을 클릭하여 라벨 관리 팝업창을 엽니다
  4. 라벨을 추가 또는 제거합니다
  5. 팝업창이 닫히면 변경사항이 반영됩니다
라벨 표시 방식
  • 읽기 모드: 현재 할당된 라벨만 태그로 표시됩니다
  • 편집 팝업창: 전체 라벨 목록에서 선택/해제할 수 있습니다
  • 삭제 확인: 라벨 제거 시 확인 팝업창이 표시됩니다

4. 필터 및 검색​

4.1 필터 옵션​

필터 항목설명사용 예시
검색어제목/내용 키워드API 오류
상태이슈 상태진행중, 완료
우선순위중요도높음, 중간, 낮음
라벨분류 라벨버그, 개선, 문의

4.2 검색 방법​

  1. 검색어 입력창에 키워드를 입력합니다
  2. 선택 메뉴에서 필터 조건을 선택합니다
  3. 결과가 자동으로 갱신됩니다 (디바운스 적용)
검색 피드백

검색어 입력 시 로딩 아이콘이 표시되며 검색 중임을 알립니다.

5. 첨부파일 관리​

5.1 파일 지원​

파일 유형지원 여부추가 기능
이미지 (PNG, JPG, GIF)✅확대 미리보기
PDF✅다운로드
동영상✅다운로드
기타 문서✅다운로드

5.2 이미지 확대 보기​

이미지 첨부파일은 확대 미리보기가 가능합니다.

  1. 이미지 썸네일에 마우스를 올리면 확대 아이콘이 표시됩니다
  2. 이미지를 클릭하면 확대 보기가 열립니다
  3. 확대 보기에서 확대/축소, 이동이 가능합니다

6. 데이터 갱신​

6.1 자동 갱신​

  • 갱신 주기: 자동 갱신 없음
  • 갱신 방법: 수동 새로고침

6.2 수동 갱신​

  • 상단의 새로고침 아이콘을 클릭합니다
  • 또는 이슈 생성/수정 후 자동으로 목록이 갱신됩니다

7. 문제 해결​

7.1 자주 발생하는 문제​

증상원인해결 방법
신규 이슈 버튼 없음읽기 전용 권한관리자에게 권한 요청
이슈가 표시되지 않음필터 조건필터 초기화
수정 실패권한 없음관리자에게 문의
원본 페이지 이동 실패페이지 접근 권한 없음관리자에게 권한 요청
주의사항
  • 이슈 삭제는 되돌릴 수 없습니다. 삭제 전 확인 대화상자를 주의 깊게 확인하십시오.
  • 완료된 이슈를 재개할 수 있습니다.
  • ALERT 타입 이슈는 원본 페이지 이동 기능이 지원되지 않습니다 (알림 참조는 내부 ID이므로).

7.2 관련 이슈 기능​

개발 중 기능

이 기능은 현재 비활성 상태입니다. 향후 업데이트에서 활성화될 예정입니다.

관련 이슈 기능은 이슈 간 연결 관계를 표현합니다.

관계 유형설명
의존성이 이슈가 다른 이슈에 의존함
차단이 이슈가 다른 이슈 진행을 차단함
중복동일한 문제를 다루는 이슈

7.3 소스 유형별 이슈 UI​

이슈는 생성 방식에 따라 3가지 소스 유형으로 구분되며, 상세 페이지에 표시되는 정보가 달라집니다.

소스 유형생성 방식상세 UI 특징
MANUAL사용자가 직접 생성기본 이슈 폼 (제목, 내용, 우선순위)
CAPTURE화면 캡처 후 이슈 생성캡처 이미지 첨부 + 원본 페이지 링크
ALERT알람 자동 생성알람 정보 카드(AlarmInfoCard) + 진단 보고서 패널
ALERT 타입 이슈

ALERT 타입 이슈는 알람 이벤트 상세 정보를 담은 알람 정보 카드가 상단에 표시됩니다. 발생 알람의 종류, 심각도, 발생 시각을 한눈에 확인할 수 있습니다.

7.4 이슈 상세 헤더 직접 편집​

이슈 상세 페이지 헤더에서 제목과 우선순위를 직접 편집할 수 있습니다.

구성 요소설명
EditableTitle제목 클릭 시 입력 필드로 전환, Enter로 저장
EditablePriority우선순위 태그 클릭 시 선택 메뉴 표시, 선택 즉시 저장

7.5 대댓글 팝업창​

댓글에 답글을 달 때 **대댓글 팝업창(CommentReplyDialog)**이 열립니다. 팝업창에서 답글을 작성하면 원본 댓글과 함께 들여쓰기 형태로 표시됩니다.

  1. 댓글 목록에서 답글을 달 댓글의 [답글] 버튼을 클릭합니다.
  2. 대댓글 팝업창이 표시됩니다.
  3. 내용을 작성하고 [작성] 버튼을 클릭합니다.
  4. 답글이 원본 댓글 하단에 들여쓰기 형태로 추가됩니다.

8. 자동 이슈 생성​

8.1 개요​

자동 이슈 생성 기능은 성능 알람이 발생하면 자동으로 추적 이슈를 생성합니다. 사용자가 수동으로 이슈를 생성하지 않아도 알람 기반 이슈가 자동으로 기록됩니다.

8.2 동작 방식​

  1. 알람 감시: 성능 알람 스토어를 실시간으로 감시합니다
  2. 규칙 확인: 자동 규칙이 활성화되어 있는지 확인합니다
  3. 조건 판단: 알람의 심각도가 최소 레벨 이상인지 확인합니다
  4. 중복 방지: 쿨다운 시간과 중복 제거 기간을 확인합니다
  5. 진단 데이터 수집: 현재 시스템 상태(CPU, 메모리, TPS 등)를 수집합니다
  6. 스크린샷 캡처: 자동 스크린샷 설정 시 현재 화면을 캡처합니다
  7. 이슈 생성: 수집된 정보로 추적 이슈를 생성합니다
중복 방지

동일한 알람이 반복 발생해도 쿨다운 시간 내에는 중복 이슈가 생성되지 않습니다. 또한 STOMP 프로토콜을 통해 다른 브라우저 탭에서도 중복 이슈 생성이 방지됩니다.

8.3 알람 심각도 레벨​

레벨설명
INFO정보 수준 알람
WARN경고 수준 알람
ERROR오류 수준 알람
FATAL치명적 오류 알람

8.4 자동 생성된 이슈 특징​

항목설명
소스 유형ALERT (알람 기반 자동 생성)
제목자동 규칙의 템플릿 제목 + 알람 정보
내용알람 상세 정보 + 진단 데이터
첨부파일자동 스크린샷 (설정 시)
자동 이슈 생성 알림

자동 이슈가 생성되면 "자동 이슈가 생성되었습니다" 알림이 표시됩니다.

9. 자동 규칙 설정​

9.1 개요​

자동 규칙 설정에서는 자동 이슈 생성의 조건을 관리합니다. 이슈 추적 페이지의 설정 아이콘을 클릭하여 접근합니다.

9.2 화면 구성​

화면설명
규칙 목록등록된 자동 규칙 목록
규칙 생성/수정규칙 상세 설정 폼
규칙 삭제 확인삭제 확인 팝업창

9.3 규칙 설정 항목​

항목설명기본값
활성화 (enabled)자동 이슈 생성 활성화 여부사용 안 함
최소 알람 레벨 (minLevel)이슈를 생성할 최소 알람 심각도WARN
쿨다운 시간 (cooldownSeconds)동일 알람에 대한 재생성 방지 시간(초)300초
중복 제거 기간 (dedupWindowMinutes)중복 알람 무시 기간(분)60분
자동 스크린샷 (autoScreenshot)이슈 생성 시 화면 자동 캡처 여부사용 안 함
템플릿 제목 (templateTitle)자동 생성 이슈의 제목 템플릿없음

9.4 규칙 관리​

액션설명
규칙 추가새 자동 규칙 생성
규칙 수정기존 규칙 조건 변경
규칙 삭제불필요한 규칙 제거 (확인 팝업창 표시)
활성화/비활성화규칙의 동작 전환

10. 진단 보고서​

10.1 개요​

진단 보고서 패널은 자동 이슈 생성 시 수집되는 시스템 진단 정보를 표시합니다. 이슈 상세 화면에서 ALERT 타입 이슈의 진단 데이터를 확인할 수 있습니다.

진단 보고서는 별도의 탭이 아닌 수직 스택 구조로 표시됩니다. 시스템 지표 카드 → SparkLine 미니 차트 → 상위 URL/SQL 테이블 → 알람 타임라인 순서로 세로로 배치됩니다.

헤더 액션:

  • PDF 다운로드: 진단 보고서 우측 상단의 PDF 버튼을 클릭하면 이슈 메타데이터와 진단 데이터를 PDF 파일로 저장할 수 있습니다. (useDiagnosticCapture 기반으로 현재 화면을 캡처하여 PDF로 변환합니다.)
  • 새로고침: 진단 데이터를 최신 상태로 갱신합니다.

10.2 진단 항목​

10.2.1 시스템 지표 카드​

지표설명
CPU 사용률현재 CPU 사용 퍼센트
메모리 사용률현재 메모리 사용 퍼센트
Active Service현재 처리 중인 서비스 수
TPS초당 트랜잭션(Transactions Per Second) 처리 수
GC 횟수가비지 컬렉션(Garbage Collection) 발생 횟수

각 지표 카드에는 SparkLine 미니 차트가 포함되어 시간 추이를 확인할 수 있습니다. SparkLine은 CPU 사용률, 메모리 사용률, Active Service 수, TPS, GC 횟수 각각에 대해 시간 흐름에 따른 추이를 소형 선형 그래프로 표시합니다.

10.2.2 상위 URL / SQL 테이블​

테이블설명
상위 URL응답시간 기준 상위 URL 목록
상위 SQL실행시간 기준 상위 SQL 쿼리 목록

10.2.3 알람 타임라인​

진단 시점 전후의 알람 발생 이력을 시간순으로 표시합니다.

10.3 페이지 이동 링크​

진단 보고서 하단에는 관련 분석 페이지로 바로 이동할 수 있는 링크가 제공됩니다.

링크이동 대상
트랜잭션 익스플로러트랜잭션 익스플로러 검색 페이지
XLOGXLOG 조회 페이지
성능 조회성능 분석 페이지

11. 통계 정보​

11.1 통계 카드​

항목설명
전체등록된 총 이슈 수
진행중상태가 OPEN인 이슈 수
완료상태가 CLOSED인 이슈 수