HTTP 호출 통계

커버 이미지

외부 API 호출 성능 분석

1. 개요

HTTP 호출 통계란?

외부 HTTP API 호출 횟수, 응답시간, 에러율을 집계 분석하는 도구

언제 사용하나요?

외부 API 성능을 모니터링할 때
타임아웃이 발생하는 API를 식별할 때
외부 서비스 의존도를 분석할 때
API 호출 실패 원인을 파악할 때

해결하는 문제

외부 API 호출별로 집계된 성능 데이터를 통해 어떤 외부 서비스가 병목인지, 실패가 잦은 API는 무엇인지 신속하게 파악할 수 있습니다.

2. 주요 지표

핵심 성능 지표

지표	의미	정상 범위
총 호출횟수	기간 내 총 HTTP 호출 횟수	API별 상이
총 에러수	기간 내 총 HTTP 에러 횟수	0 또는 최소화
평균 응답시간	API별 평균 응답시간	500ms 이하
에러율	전체 호출 중 에러 비율	1% 이하

3. 화면 구성

ObjectSelector란?

모니터링할 오브젝트(서버, 서비스, 인스턴스)를 선택하는 컴포넌트

위치: 화면 좌측 사이드바

주요 기능:

오브젝트 트리 탐색
다중 오브젝트 선택
오브젝트별 필터링

사용법: 단계 1: ObjectSelector 버튼을 클릭하세요 단계 2: 트리에서 원하는 오브젝트를 체크하세요 (다중 선택 가능) 단계 3: 선택된 오브젝트 수가 버튼에 표시됩니다

오브젝트 상태 정보:

전체 실행 개수: 현재 실행 중인 오브젝트 수
라이선스 없는 개수: 라이선스 없이 실행 중인 오브젝트 수
전체 정지 개수: 정지된 오브젝트 수

3계층 레이아웃 구조:

1층 (검색 조건 영역)

날짜 범위 선택
서버 선택 드롭다운
검색 버튼
리셋 버튼

2층 (오브젝트 목록 영역)

ObjectSelector (오브젝트 목록): 모니터링 대상 오브젝트 목록
noPadding 옵션 적용 (최대 공간 활용)
오브젝트별 필터링 지원

3층 (컨텐츠 영역)

상단 요약 정보: 총 호출횟수, 총 에러수, 평균 응답시간, 에러율
하단 차트 영역: 일별 차트 + 상세 테이블 (동적 6:6 분할)
- 일별 차트: 날짜별 HTTP 호출 추이
- 상세 테이블: API별 상세 통계 (토글 가능)

특징:

ThreeLayerLayout 기반 3계층 구조
차트/테이블 동적 분할 (6:6)
fill 옵션 적용 (남은 공간 채움)

초기 상태 안내

⚠️ 중요 사항

⚠️ 중요: 오브젝트를 선택하지 않으면 화면이 비어있는 것이 정상입니다.

빈 화면인 경우:

ObjectSelector에서 모니터링할 오브젝트를 선택했는지 확인하세요

오브젝트가 등록되어 있는지 확인하세요 데이터가 표시되지 않는 경우:

선택한 오브젝트가 데이터를 수집 중인지 확인하세요

시간 범위를 조정해 보세요

4. 상호작용 기능

날짜 범위 검색

단계 1: 1층 검색 조건 영역에서 날짜 범위를 선택하세요

단계 2: 서버를 선택하세요

단계 3: "검색" 버튼을 클릭하세요

오브젝트 필터링

단계 1: 2층 오브젝트 목록 영역에서 필터링할 오브젝트를 선택하세요

단계 2: 다중 선택 가능

단계 3: 선택된 오브젝트의 통계만 3층 컨텐츠 영역에 표시됩니다

상세 테이블 토글

단계 1: 3층 컨텐츠 영역에서 상세 테이블 토글 버튼을 클릭하세요

단계 2: 차트와 테이블이 6:6 비율로 분할됩니다

단계 3: 다시 클릭하면 차트가 전체 화면을 차지합니다

일별 차트 확인

X축: 날짜
Y축: 호출횟수
범례: API별 색상 구분
차트 위젯: 라인/바 차트 혼합 지원

특수 기능

URL 클릭 → XLOG 다이얼로그 연동:

상세 테이블에서 특정 URL 행을 클릭하면 XLOG 다이얼로그가 열립니다
자동 필터링: 선택된 URL/IP 기준으로 자동 필터링된 XLOG 표시
사용자 추적: 특정 클라이언트의 모든 트랜잭션 추적
행동 분석: 특정 사용자의 서비스 이용 패턴 분석
오류 분석 연계: 오류가 포함된 트랜잭션을 중심으로 원인 분석 가

사용 예시:

상세 테이블에서 의심스러운 IP 또는 중요 클라이언트 찾기
해당 URL 또는 IP 행 클릭 → XLOG 다이얼로그 자동 오픈
선택된 URL/IP 기준으로 모든 트랜잭션을 시간대별로 확인
비정상 행동 패턴 또는 오류 발생 원인 분석

5. 예외 상황 처리

⚠️ 중요 사항

⚠️ 자주 발생하는 문제

문제: 데이터가 표시되지 않음

원인: 날짜 범위가 너무 짧거나 오브젝트가 HTTP 호출 데이터를 수집하지 않음

해결: 날짜 범위를 넓히고 오브젝트 데이터 수집 상태를 확인하세요

문제: 특정 API만 표시됨

원인: 오브젝트 필터링이 활성화됨

해결: ObjectSelector에서 필터를 초기화하거나 모든 오브젝트를 선택하세요

문제: 타임아웃이 너무 많음

원인: 외부 API 응답이 느리거나 서버 과부하

해결: 상세 테이블에서 타임아웃이 많은 API를 찾아 타임아웃 시간을 늘리거나 외부 서비스와 협의하세요

문제: HTTP 500 에러가 많음

원인: 외부 API 서버 문제 또는 요청 파라미터 오류

해결: 상세 테이블에서 에러가 많은 API를 찾아 외부 서비스 관리자에게 문의하세요

6. 연관 메뉴

함께 사용하면 좋은 메뉴:

메뉴	함께 사용하는 이유
트랜잭션 조회	HTTP 호출 스택 트레이스 상세 분석
URL 통계	특정 서비스의 외부 API 호출 패턴 파악
에러 통계	HTTP 에러 상세 원인 분석

7. 실전 예시

시나리오: 결제 API 타임아웃 문제 해결

상황: 결제 처리 시 간헐적으로 타임아웃 발생

해결 과정:

HTTP 호출 통계 1층에서 최근 7일 날짜 범위 선택
서버 선택 후 검색 실행
3층 요약 정보에서 총 에러수와 에러율 확인
일별 차트에서 특정 시간대에 타임아웃이 집중되는 것 확인
상세 테이블에서 "payment-gateway.com" API의 타임아웃이 80% 차지하는 것 발견
API 응답시간 평균이 3.5초로 타임아웃(3초) 초과
타임아웃 시간을 3초에서 5초로 증가
HTTP 호출 통계에서 개선 효과 확인

결과: 타임아웃 발생률 15% → 0.5%로 개선

이 페이지가 도움이 되었나요?

외부 API 호출 성능 분석​

목차​

1. 개요​

HTTP 호출 통계란?​

언제 사용하나요?​

해결하는 문제​

2. 주요 지표​

핵심 성능 지표​

3. 화면 구성​

ObjectSelector란?​

1층 (검색 조건 영역)​

2층 (오브젝트 목록 영역)​

3층 (컨텐츠 영역)​

초기 상태 안내​

4. 상호작용 기능​

날짜 범위 검색​

오브젝트 필터링​

상세 테이블 토글​

일별 차트 확인​

특수 기능​

5. 예외 상황 처리​

⚠️ 자주 발생하는 문제​

6. 연관 메뉴​

7. 실전 예시​

시나리오: 결제 API 타임아웃 문제 해결​