Developer Hub의 Request logs 탭에는 조직의 /v1 API 트래픽이 표시됩니다. 검색 가능한 개별 요청 로그 위에 최근 24시간 동안의 요약 통계(요청 수, 오류율, 속도 제한이 적용된 요청 수)가 나타납니다.
각 항목에 기록되는 내용
로그 테이블에는 각 호출의 시간, HTTP 메서드, 경로, 응답 상태, 정책 결정, 지연 시간, 요청 ID가 표시됩니다. 항목을 열면 호출을 수행한 서비스 계정과 API 키, 소스 IP, 적용된 권한 등 전체 세부 정보를 확인할 수 있습니다.
정책 결정은 요청이 어떻게 처리되었는지를 알려 줍니다.
- Allowed — 요청이 인증 및 승인되었습니다.
- Denied — 요청이 거부되었습니다. 예를 들어 키에 필요한 권한이 없거나, 만료되었거나, 해지된 경우입니다.
- Rate limited — 요청이 요청 허용량을 초과하여
429 응답과 함께 거부되었습니다. 속도 제한을 참조하십시오.
필터링 및 검색
서비스 계정, API 키, HTTP 메서드, 상태 클래스(2xx–5xx), 정책 결정, 시간 범위 또는 경로 접두사(예: /v1/entities)로 로그를 좁혀 볼 수 있습니다.
요청 ID로 오류 추적
모든 API 응답에는 Request-Id 헤더가 포함되며, 모든 오류 본문에는 request_id 필드에 동일한 값이 포함됩니다. 이 값을 요청 로그 검색에 붙여 넣으면 일치하는 항목으로 바로 이동하여 요청이 어떻게 처리되었는지 정확하게 확인할 수 있습니다.
연동에서 오류가 보고되면 오류 응답의 request_id을(를) 요청하십시오. 고객 측에서 나타난 증상에서 실제로 어떤 일이 있었는지를 보여 주는 공식 기록까지 가장 빠르게 도달하는 방법이며, Living Security 지원팀에 문의할 때 함께 전달해야 하는 값이기도 합니다.
문제 조기 발견
- 오류율이 상승하면 대개 키가 만료되었거나, 해지되었거나, 필요한 권한을 잃었다는 의미입니다. 결정별로 필터링하여 실패하는 자격 증명을 찾으십시오.
- 속도 제한 건수가 증가하면 특정 워크로드에 부하가 집중되고 있다는 의미입니다. 부하를 분산하는 방법은 속도 제한을 참조하십시오.
- 유휴 상태여야 하는 서비스 계정에서 트래픽이 발생한다면 해당 자격 증명이 의도한 위치에 있는지 확인해야 한다는 신호입니다. 조사하는 동안 계정을 비활성화하십시오.
