로그 항목 읽기

이 페이지의 내용

Logs 탭의 목록에서 요청을 클릭하면 오른쪽에 세부 정보가 열립니다. 세부 정보에는 요청이 언제 이루어졌는지, 누가 어디에서 보냈는지, 무엇이 전송되었고 무엇이 반환되었는지가 표시됩니다. 실패한 요청의 경우 오류에 대한 이해하기 쉬운 요약을 요청할 수도 있습니다.

빠른 참조

찾는 위치: 설정(왼쪽 하단의 톱니바퀴 아이콘) → 감사 로그 → Logs에서 요청을 클릭합니다

대상: 조직에서 감사 로그와 Identity & Access Management가 포함된 역할(예: Organisation Administrator)이 필요합니다. 감사 로그를 사용할 수 있는 사용자를 참조하십시오.

목적: 하나의 요청에서 정확히 무슨 일이 있었는지 확인합니다

로그 항목 열기

  1. Logs 탭에서 필요한 요청으로 목록을 필터링합니다.
  2. 요청을 클릭합니다. 오른쪽에 세부 정보가 열리고 목록에서 해당 요청이 강조 표시됩니다.
  3. 위쪽 및 아래쪽 화살표 키를 사용하면 세부 정보를 닫지 않고 목록을 차례로 이동할 수 있습니다.

세부 정보 상단에는 상태, 메서드, 소스 배지, 엔드포인트가 다시 표시됩니다.

로그 항목의 세부 정보: 타임스탬프, 응답 시간, 요청 ID, IP 주소, 사용자, 리퍼러, 사용자 에이전트, 시설과 조직, 그리고 요청 및 응답 본문로그 항목의 세부 정보: 타임스탬프, 응답 시간, 요청 ID, IP 주소, 사용자, 리퍼러, 사용자 에이전트, 시설과 조직, 그리고 요청 및 응답 본문

그림 1: 로그 항목: 발생 시점, 요청한 사람, 요청 위치, 요청 및 응답 본문

필드

Performance Hub에서 필드는 대문자로 다음 순서대로 표시됩니다.

필드표시 내용
Timestamp요청 날짜와 시간
Response TimePerformance Hub가 응답하는 데 걸린 시간(밀리초)
Request ID이 요청의 고유 ID입니다. 복사 버튼을 클릭하여 복사할 수 있습니다(예: 지원팀에 전달할 때).
IP Address요청이 발생한 IP 주소
User요청한 사람의 이메일 주소
Referer요청이 이루어진 페이지(있는 경우)
User Agent요청을 보낸 브라우저, 앱 또는 도구
시설요청 대상 시설이며, "이름 (id)" 형식으로 표시됩니다(예: Lower Manhattan과 해당 시설 ID)
조직조직이며, "이름 (id)" 형식으로 표시됩니다

요청 및 응답

필드 아래에는 요청의 본문이 있는 경우 표시됩니다.

섹션표시 내용
Request POST Body전송된 내용입니다(예: 출입문 잠금 해제 시 입력한 사유 또는 시설의 새 운영 시간). 본문을 보내는 모든 메서드에서 제목은 "Request POST Body"로 표시됩니다.
Response Body오류 메시지를 포함하여 Performance Hub가 반환한 내용
Query Parameters요청에 추가된 옵션(예: 페이지 번호 또는 시설)

섹션의 내용을 복사하려면 Copy section(섹션 오른쪽 상단의 복사 아이콘)을 클릭하십시오. 예를 들어 지원 요청에 붙여 넣을 때 사용할 수 있습니다.

요청에 표시할 내용이 없으면 세부 정보에 "No request/response payloads recorded for this entry."라고 표시됩니다. 정보를 읽기만 하는 많은 GET 요청에는 요청 본문이 없습니다.

AI 오류 요약

상태가 400 이상인 실패한 요청의 경우 세부 정보에 AI Error Summary 섹션이 포함됩니다.

  1. Generate summary를 클릭합니다.
  2. 요약을 읽습니다. 요약은 무엇이 잘못되었는지, 다음에 무엇을 해야 하는지 이해하기 쉽게 설명합니다.

변경을 시도한 사람에게 해당 역할을 할당할 권한이 없었다고 설명하는 403 요청의 AI Error Summary변경을 시도한 사람에게 해당 역할을 할당할 권한이 없었다고 설명하는 403 요청의 AI Error Summary

그림 2: 실패한 요청의 경우 Generate summary가 오류를 이해하기 쉽게 설명합니다

  • 요약은 Generate summary를 클릭할 때만 생성됩니다. 요약이 생성된 후에는 cached 태그가 표시될 수 있습니다.
  • 요약은 AI가 생성하므로 틀릴 수 있습니다. Performance Hub가 실제로 반환한 메시지가 담긴 Response Body와 대조하십시오.
  • 요약을 생성할 수 없으면 나중에 다시 시도하라는 경고가 표시됩니다. 그동안 Response Body를 읽으십시오.

7일 이후: 미리 보기

전체 요청 및 응답 본문은 7일 동안 보존됩니다. 그 이후에는 긴 본문이 짧은 미리 보기로 잘리고, 세부 정보에 "Full request and response payloads are kept for 7 days. Showing a preview for this log."라고 표시됩니다. 미리 보기에 들어가는 짧은 본문은 전체가 유지됩니다.

요청한 사람, 시간, 결과와 같은 로그 항목의 나머지 정보는 90일 동안 보존됩니다.

미리 보기 안내와 축약된 요청 및 응답 본문이 표시된 7일이 지난 로그 항목미리 보기 안내와 축약된 요청 및 응답 본문이 표시된 7일이 지난 로그 항목

그림 3: 7일이 지나면 요청과 응답의 짧은 미리 보기만 남습니다

나중에 전체 본문이 필요할 수 있다면 7일 이내에 요청을 열고 Copy section을 사용하십시오. CSV 내보내기에는 본문이 포함되지 않습니다.

상태 코드

상태는 각 행의 첫 번째 항목입니다. 첫 번째 숫자로 결과의 종류를 알 수 있습니다.

상태의미예시
2xx성공200 OK, 201 Created
3xx리디렉션: 요청이 다른 곳으로 전송됨301 Moved
4xx권한 없음이나 잘못된 입력과 같은 요청 문제400 Bad Request(값이 유효하지 않음), 401 Unauthorised(로그인하지 않음), 403 Forbidden(권한 없음), 404 Not Found, 409 Conflict(유지 관리 모드인 출입문처럼 요청이 현재 상태와 충돌함), 429 Too Many Requests(짧은 시간에 너무 많은 요청)
5xx서버 오류500 Server Error, 502 Bad Gateway, 503 Service Unavailable

소스 배지

각 요청에는 요청 출처를 나타내는 소스 배지가 있습니다.

배지요청 출처
web브라우저나 앱에서 Performance Hub를 사용하는 사람
api-key예약 시스템이나 회원 시스템처럼 API 키를 사용하는 통합입니다. Partner API 인증을 참조하십시오.
mcpMCP를 통해 연결된 AI 에이전트 또는 AI 클라이언트입니다. AI와 함께 사용을 참조하십시오.
model-routerModel Router
websocket실시간 업데이트와 같은 라이브 연결
guest-token게스트 링크

다른 배지가 표시될 수도 있습니다.