API 사용량 대시보드
API 사용량 대시보드를 사용하면 Braze로 들어오는 REST API 트래픽을 모니터링하여 REST API 사용 추세를 파악하고 잠재적인 문제를 해결할 수 있습니다.
API 사용량 대시보드 정보
API 사용량 대시보드를 보려면 설정 > API 및 식별자로 이동한 다음 대시보드를 선택합니다.
기본값 대시보드는 지난 하루(24시간) 동안 워크스페이스로 들어온 모든 REST API 요청을 보여줍니다. 사용 사례에 따라 대시보드 컨트롤을 조정하여 트래픽을 필터링하거나 그룹화할 수 있으며, 대시보드의 기간도 설정할 수 있습니다.

사용 가능한 측정기준
API 사용량 대시보드에는 다음 통계가 포함됩니다:
| 측정기준 | 설명 |
|---|---|
| 총 요청 수 | 대시보드에 적용된 필터와 컨트롤을 기준으로 현재 워크스페이스에서 Braze로 전송된 총 요청 수입니다. |
| 성공률 | 전체 요청 중 Braze가 2XX 성공 응답을 반환한 요청의 비율입니다. |
| 오류율 | 전체 요청 중 Braze가 4XX 또는 5XX 오류 응답을 반환한 요청의 비율입니다. |
대시보드 사용

필터
필터를 선택하여 워크스페이스의 REST API 트래픽 보기 범위를 좁히는 필터를 적용합니다. 적용할 수 있는 필터는 다음과 같습니다.
- API 키
- 엔드포인트
- 응답 코드
데이터 그룹화
데이터를 다양한 데이터 계열로 그룹화하여 사용량의 여러 패턴을 살펴볼 수 있습니다. 그룹화 기준은 다음과 같습니다.
- 응답 코드(기본값)
- API 엔드포인트
- API 키
- 성공 및 실패만
날짜
필요에 따라 날짜 필터를 조정하여 더 짧거나 긴 기간을 표시할 수 있습니다. 선택할 수 있는 옵션은 다음과 같습니다.
- 오늘(기본값)
- 커스텀
- 지난 3시간
- 지난 6시간
- 지난 12시간
- 지난 24시간
- 어제
- 지난 7일
- 지난 14일
- 지난 30일
- 지난달부터 현재까지

지난 3시간 및 지난 6시간 옵션은 트래픽을 분 단위로 표시합니다. 더 긴 기간은 트래픽을 5분, 1시간 또는 1일 단위로 표시합니다.
요청 로그 보기
차트의 특정 지점에 해당하는 개별 요청을 확인하려면 데이터 포인트를 선택한 다음 요청 로그 보기를 선택합니다. API 요청 로그가 열리며, 해당 데이터 포인트의 시간 간격과 차트에 적용된 엔드포인트, 응답 코드, API 키 필터가 함께 적용됩니다.
요청 로그는 최근 14일 동안의 REST API 트래픽에 대해서만 제공됩니다.
고려 사항
API 사용량 대시보드에는 Braze가 수신하고 2XX, 4XX 또는 5XX 응답을 반환한 모든 REST API 요청이 포함됩니다. 여기에는 데이터 변환 출력과 클라우드 데이터 수집 동기화도 포함됩니다. SDK 트래픽과 사용자 업데이트 단계는 이 대시보드에 포함되지 않습니다.
대시보드에 최근 트래픽이 표시되기까지 약간의 지연이 있을 수 있습니다. 사용량이 많은 기간에는 대시보드를 분당 최대 4회까지 새로 고칠 수 있습니다. 대시보드를 다시 새로 고치기 전에 몇 분 정도 기다려야 할 수도 있습니다.
요청 본문의 API 키
API 키를 요청 헤더가 아닌 요청 본문에 포함하여 보내면 일부 요청이 API 사용량 대시보드에 표시되지 않을 수 있습니다. 이로 인해 대시보드의 데이터가 불완전해지고 API 사용량을 정확하게 모니터링하기 어려워질 수 있습니다.
API 사용량 대시보드에서 가장 정확한 보고를 받으려면 API 키를 요청 본문이 아닌 요청 헤더에 포함하세요.