컴포넌트 상태¶
1. 메뉴 개요¶
검색 서비스를 구성하는 API 서비스(Service)와 인프라(MSA)의 가동 상태를 한 화면에서 확인합니다. 각 컴포넌트를 클릭하면 상세 메트릭(요청 수·응답시간 등)을 들여다볼 수 있습니다.
2. 메뉴 위치¶
[좌측 메뉴바] > [운영 현황] > [상태 정보] > [컴포넌트 상태]
URL: /operation/status/api-status
3. 화면 구성¶
| 번호 | 영역 | 설명 |
|---|---|---|
| ① | 컴포넌트 카드 행 | 등록된 API/인프라 컴포넌트가 카드로 나열. 각 카드에 UP/DOWN 배지, 이름, 카테고리(Service/MSA) 표시. 카드 클릭 시 선택 |
| ② | Live 토글 | 우측 상단의 "1초 갱신 / 5초 갱신" 토글. 짧은 주기 갱신이 필요할 때 켭니다 |
| ③ | 상세 패널 | 선택한 컴포넌트의 상세 메트릭. 컴포넌트 종류에 따라 표시 항목이 달라집니다 |
상세 패널의 종류¶
선택한 컴포넌트의 카테고리에 따라 다음 패널이 표시됩니다.
| 컴포넌트 종류 | 패널 |
|---|---|
| 서비스 API (일반) | 요청 수, 응답시간, 오류율 등 서비스 메트릭 |
| 서비스 API (연관검색어) | 연관검색어 전용 통계 (별도 패널) |
| Gateway (MSA) | Gateway 라우팅·트래픽 정보 |
| Discovery (MSA) | 등록된 서비스 디스커버리 정보 |
| Config (MSA) | 설정 서버 정보 |
4. 주요 작업 방법¶
4.1 DOWN 컴포넌트 식별¶
- ① 카드 행에서 빨간색 DOWN 배지가 있는 카드를 찾습니다.
- 해당 카드를 클릭하면 ③ 상세 패널이 표시됩니다.
- 표시되는 사유(예: 응답 없음, 인증 실패 등)를 확인합니다.
4.2 실시간 갱신으로 보기¶
장애 대응 중 메트릭을 즉시 확인해야 할 때:
- ② "1초 갱신 / 5초 갱신" 토글을 [1초 갱신]으로 변경합니다.
- 카드와 상세 패널이 1초마다 다시 그려집니다.
- 점검이 끝나면 다시 [5초 갱신]으로 되돌립니다 (브라우저 부하 감소).
4.3 다른 컴포넌트로 전환¶
상세를 보고 있는 도중에도 ① 카드 행에서 다른 컴포넌트 카드를 클릭하면 상세 패널이 즉시 교체됩니다.
5. 🚨 주의사항¶
MSA(Gateway/Discovery/Config) DOWN의 영향
인프라 컴포넌트가 DOWN이면 그 위에 올라간 서비스 API들이 줄줄이 영향을 받습니다. 서비스가 모두 DOWN이라면 먼저 MSA 컴포넌트를 확인하세요.
- "1초 갱신"은 짧게만 사용합니다. 장시간 켜두면 네트워크·CPU 부하가 누적됩니다.
- 선택된 컴포넌트가 없을 때는 안내 메시지만 표시됩니다.