> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 요청 로그

> Developer Hub에서 조직의 Living Security Public API 트래픽을 추적하고, 필터링하며, 문제를 해결하는 방법을 안내합니다.

[Developer Hub](/ko/developers/developer-hub/overview)의 **Request logs** 탭에는 조직의 `/v1` API 트래픽이 표시됩니다. 검색 가능한 개별 요청 로그 위에 최근 24시간 동안의 요약 통계(요청 수, 오류율, 속도 제한이 적용된 요청 수)가 나타납니다.

## 각 항목에 기록되는 내용

로그 테이블에는 각 호출의 시간, HTTP 메서드, 경로, 응답 상태, 정책 결정, 지연 시간, 요청 ID가 표시됩니다. 항목을 열면 호출을 수행한 서비스 계정과 API 키, 소스 IP, 적용된 권한 등 전체 세부 정보를 확인할 수 있습니다.

정책 결정은 요청이 어떻게 처리되었는지를 알려 줍니다.

* **Allowed** — 요청이 인증 및 승인되었습니다.
* **Denied** — 요청이 거부되었습니다. 예를 들어 키에 필요한 권한이 없거나, 만료되었거나, 해지된 경우입니다.
* **Rate limited** — 요청이 요청 허용량을 초과하여 `429` 응답과 함께 거부되었습니다. [속도 제한](/ko/developers/v1/rate-limits)을 참조하십시오.

## 필터링 및 검색

서비스 계정, API 키, HTTP 메서드, 상태 클래스(2xx–5xx), 정책 결정, 시간 범위 또는 경로 접두사(예: `/v1/entities`)로 로그를 좁혀 볼 수 있습니다.

## 요청 ID로 오류 추적

모든 API 응답에는 `Request-Id` 헤더가 포함되며, 모든 오류 본문에는 `request_id` 필드에 동일한 값이 포함됩니다. 이 값을 요청 로그 검색에 붙여 넣으면 일치하는 항목으로 바로 이동하여 요청이 어떻게 처리되었는지 정확하게 확인할 수 있습니다.

<Tip>
  연동에서 오류가 보고되면 오류 응답의 `request_id`을(를) 요청하십시오. 고객 측에서 나타난 증상에서 실제로 어떤 일이 있었는지를 보여 주는 공식 기록까지 가장 빠르게 도달하는 방법이며, Living Security 지원팀에 문의할 때 함께 전달해야 하는 값이기도 합니다.
</Tip>

## 문제 조기 발견

* **오류율**이 상승하면 대개 키가 만료되었거나, 해지되었거나, 필요한 권한을 잃었다는 의미입니다. 결정별로 필터링하여 실패하는 자격 증명을 찾으십시오.
* **속도 제한** 건수가 증가하면 특정 워크로드에 부하가 집중되고 있다는 의미입니다. 부하를 분산하는 방법은 [속도 제한](/ko/developers/v1/rate-limits)을 참조하십시오.
* 유휴 상태여야 하는 서비스 계정에서 트래픽이 발생한다면 해당 자격 증명이 의도한 위치에 있는지 확인해야 한다는 신호입니다. 조사하는 동안 [계정을 비활성화](/ko/developers/developer-hub/service-accounts)하십시오.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.