통계

개요

통계는 엔드포인트별 API 사용량을 시각적으로 분석할 수 있는 페이지입니다. 총 호출·성공·실패·응답 시간 같은 요약 카드, 일별 호출량 변화 그래프, 협업 키별 호출 비율 등을 한 화면에 제공합니다.

샌드박스와 프로덕션 환경은 독립적으로 통계가 집계되므로, 테스트 중 호출과 실제 운영 호출을 명확히 분리해서 확인할 수 있어요.

진입 경로

• 상단 메뉴 통계 클릭 → 엔드포인트 목록에서 조회할 엔드포인트 선택

---

엔드포인트 목록

통계 페이지에 진입하면 먼저 엔드포인트 목록이 보입니다. 각 엔드포인트의 최근 통계 지표를 요약해 보여줍니다.

상단 Sandbox | Production 탭으로 환경별 목록을 전환할 수 있어요.

컬럼	설명
엔드포인트	엔드포인트 이름
구분	내가 만든 엔드포인트는 소유, 협업자로 참여 중이면 공유됨
총 호출	해당 엔드포인트로 누적된 API 호출 수
성공률	성공 호출 비율 (%)
실패율	실패 호출 비율 (%)
평균 응답	API 평균 응답 시간 (ms)
최근 6개월	월별 호출량 트렌드를 보여주는 미니 차트

원하는 엔드포인트를 클릭하면 상세 통계 페이지로 이동합니다.

---

월간 통계

엔드포인트를 선택하면 월 단위로 집계된 통계 화면이 열립니다.

상단 정보

• 엔드포인트 이름과 설명
• Sandbox | Production 환경 탭 — 환경별 통계를 독립적으로 조회
• 월 선택 드롭다운 — 조회할 월을 선택 (기본값은 이번 달)

요약 카드 4종

카드	내용
총 호출	선택한 달의 전체 API 호출 건수 (성공 + 실패)
성공	성공 호출 건수
실패	실패 호출 건수
평균 응답 시간	API 평균 응답 시간(ms). CUD(Create/Update/Delete) 가중 평균

일간 호출 변화량 그래프

요약 카드 아래에는 선택한 달의 일별 호출량 변화를 막대 그래프로 보여줍니다. 성공(녹색)과 실패(빨간색)를 하나의 차트에 함께 표시해 품질 추이를 한눈에 파악할 수 있어요.

협업 키별 호출

선택한 달에 어떤 협업 키가 얼마나 호출했는지 비율로 보여줍니다.

컬럼	설명
협업 키	호출에 사용된 협업 키 이름 (없으면 기본)
호출 수	해당 협업 키의 총 호출 건수
비율	전체 대비 차지 비율 (%)

여러 고객사에 협업 키를 발급한 경우, 누가 가장 많이 호출하는지 또는 호출이 없는 고객사가 있는지를 빠르게 파악할 수 있어요.

일간 추세

선택한 달의 일별 호출 내역을 상세 테이블로 보여줍니다. 위쪽의 그래프와 같은 데이터를 숫자로 확인하고 싶을 때 유용합니다.

메서드 필터

테이블 상단에 메서드 필터가 있어 특정 작업만 추출해 볼 수 있어요.

• 전체 / Create / Read / Update / Delete
• 필터 선택 시 해당 메서드의 성공/실패 수만 표시됩니다

컬럼

컬럼	설명
No	순번
Date	해당 일자
총 호출	해당 날짜의 전체 호출 건수 (성공 + 실패)
성공	성공 건수 (녹색)
실패	실패 건수 (빨간색)
평균 응답 시간	해당 날짜의 API 평균 응답 시간 (ms)

---

자주 막히는 부분

• 통계가 비어 있어요: 통계는 해당 환경으로 들어온 API 호출이 있어야 집계됩니다. 샌드박스에서만 호출했다면 Sandbox 탭에서, 프로덕션 배포 후 호출했다면 Production 탭에서 확인하세요
• 방금 호출했는데 숫자가 안 올라가요: 통계는 큐 처리 후 배치로 집계되므로 즉시 반영되지 않을 수 있습니다. 잠시 후 새로고침해 주세요
• 협업 키별 비율이 100%가 안 돼요: 반올림 차이로 합계가 99% 또는 101%가 될 수 있습니다. 실제 집계는 정확합니다
• Read 응답 시간이 안 보여요: 평균 응답 시간은 CUD(Create/Update/Delete)만 가중 평균으로 계산됩니다. GET 요청은 동기 처리라서 별도 통계 대상이 아니에요