Performance Hub 로고Performance Hub
사이트 섹션: 문서

감사 로그

이 페이지의 내용

감사 로그는 조직에서 Performance Hub에 보낸 요청의 기록입니다. 브라우저나 앱에서 Performance Hub를 사용하는 사람의 요청과, API 키, MCP를 통해 연결된 AI 에이전트, Model Router 같은 연결된 도구의 요청이 포함됩니다. 사무실, 매장, 카페, 공연장, 병원, 캠퍼스, 체육관 등 어떤 현장을 운영하든 누가 출입문을 열었는지, 변경 사항이 저장되지 않은 이유는 무엇인지, 통합이 언제 작동을 멈췄는지와 같은 질문에 답하는 데 사용하십시오.

빠른 참조

찾는 위치: Settings(왼쪽 하단의 톱니바퀴 아이콘) → 감사 로그

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

용도: Performance Hub에서 누가 무엇을 했는지 확인하고 요청이 실패한 이유를 파악합니다.

Window 버튼, 다섯 가지 주요 수치 및 Request Timeline 차트가 있는 감사 로그 대시보드Window 버튼, 다섯 가지 주요 수치 및 Request Timeline 차트가 있는 감사 로그 대시보드

그림 1: 감사 로그 대시보드: 시간 범위, 주요 수치 및 요청 타임라인

기록되는 내용

각 로그 항목은 Performance Hub에 보낸 하나의 요청입니다. 다음 내용이 표시됩니다.

  • 요청한 사람: 사용자의 이메일 주소입니다.
  • 요청 위치: IP 주소와 요청을 보낸 브라우저 또는 도구입니다.
  • 호출된 대상: 메서드(예: 읽기용 GET 또는 생성용 POST)와 엔드포인트입니다. 엔드포인트는 /api/door-gate-access/doors/front-entrance/unlock처럼 요청 대상이 된 Performance Hub의 부분입니다.
  • 결과: 응답 상태입니다. 예를 들어 성공 시 200, 권한이 없는 경우 403입니다.
  • 소요 시간(밀리초)입니다.
  • 출처: 소스 배지입니다. 예를 들어 Performance Hub를 사용하는 사람은 web, 통합은 api-key입니다. 소스 배지를 참조하십시오.

최근 요청의 경우 로그 항목에 보낸 내용과 반환된 내용도 저장됩니다. 로그 항목 읽기를 참조하십시오.

두 개의 탭

탭용도
Dashboard시간 범위에 대한 합계, 오류율 및 차트와 함께 가장 많이 사용된 엔드포인트와 사용자를 보여 줍니다. 차트나 행을 클릭하면 해당 로그가 열립니다.
Logs요청 자체를 보여 줍니다. 목록을 필터링 및 검색하고, 로그 항목을 열어 세부 정보를 확인하고, CSV로 내보낼 수 있습니다.

감사 로그를 사용할 수 있는 사용자

조직에서 감사 로그와 Identity & Access Management가 포함된 역할(예: Organisation Administrator)이 필요합니다. 설정 메뉴에 감사 로그가 표시되지 않으면 역할에 포함되어 있지 않은 것입니다.

  • 표시되는 조직: 역할에 감사 로그와 Identity & Access Management가 모두 포함된 조직입니다. Logs 탭에 조직 수가 표시됩니다(예: "Viewing logs for 1 organisation").
  • 역할 템플릿: Organisation Administrator 템플릿에는 감사 로그가 포함됩니다. Site Manager 및 Site Owner 템플릿에는 포함되지 않습니다. 역할 템플릿을 참조하십시오.
  • 사용자 지정 역할: 사용자 지정 역할에서 감사 로그를 사용할 수 있게 하려면 모듈 액세스에 감사 로그와 Identity & Access Management를 모두 포함하십시오. 접근 범위 및 모듈 액세스를 참조하십시오.

감사 로그에는 사람들의 이메일 주소, IP 주소 및 보낸 내용이 표시되므로 필요한 사람에게만 부여하십시오.

로그 보관 기간

감사 로그 보존 기간은 감사 로그를 보관하는 기간을 정합니다. 각 로그 항목은 90일, 전체 요청 및 응답 페이로드는 7일 동안 보관됩니다.

Logs 탭의 Range 메뉴에는 다음과 같이 표시됩니다.

"감사 로그는 90일 동안 보관됩니다. 전체 요청 및 응답 페이로드는 7일 동안 보관되며, 그 이후에는 간단한 미리보기만 남습니다. 더 긴 기록이 필요하신가요? 지원팀에 문의하세요(추가 요금이 부과될 수 있음)."

따라서 90일 전까지 조회할 수 있습니다. 처음 7일 동안 로그 항목에는 전체 요청과 응답이 저장됩니다. 그 이후에는 긴 본문이 짧은 미리 보기로 잘립니다. 7일 이후: 미리 보기를 참조하십시오.

수행할 수 있는 작업

  • 대시보드 읽기: 시간 범위에 대한 요청량, 오류율, 가장 많이 사용된 엔드포인트와 사용자를 확인합니다.
  • 요청 찾기: 시간 범위, 이메일 주소, IP 주소, 엔드포인트, 조직, 시설, 메서드 및 상태로 필터링하고 필터링된 보기를 공유합니다.
  • 로그 항목 읽기: 누가 어디에서 요청했는지, 무엇을 보내고 반환받았는지 확인합니다. 실패한 요청의 경우 오류에 대한 쉬운 요약을 확인할 수 있습니다.
  • 로그 내보내기: 로드된 로그를 CSV 파일로 다운로드합니다.
  • 조사 예시 따라 하기: 누가 출입문을 열었는지, 통합의 동기화가 중단된 이유는 무엇인지 등 일반적인 질문에 대한 단계별 답변입니다.
  • 자주 묻는 질문