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

요청 찾기

이 페이지의 내용

Logs 탭에는 조직에서 발생한 요청이 최신 순으로 표시됩니다. 상단의 필터를 사용하여 목록을 한 사람, 하나의 IP 주소, Performance Hub의 한 부분 또는 한 가지 결과 유형으로 좁힌 다음, 요청을 클릭하여 세부 정보를 확인하십시오.

빠른 참조

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

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

목적: 누가 무엇을 변경했는지, 무언가가 왜 실패했는지와 같은 질문의 원인이 된 요청을 찾습니다

상단에 필터 막대, 왼쪽에 요청 목록, 오른쪽에 선택한 요청의 세부 정보가 표시된 Logs 탭상단에 필터 막대, 왼쪽에 요청 목록, 오른쪽에 선택한 요청의 세부 정보가 표시된 Logs 탭

그림 1: Logs 탭: 상단에 필터, 왼쪽에 일치하는 요청, 오른쪽에 선택한 요청

Logs 탭

  • 필터 막대: 상단의 필터이며, 오른쪽에 Live, 새로 고침, CSV 내보내기가 있습니다.
  • 목록: 일치하는 요청이 최신 순으로 표시됩니다. 목록 위에는 "Viewing logs for 1 organisation"(또는 볼 수 있는 조직 수)이 표시됩니다. 각 행에는 상태 코드, 메서드, 소스 배지, 날짜와 시간, 엔드포인트, 사용자의 이메일 주소, 밀리초 단위의 응답 시간이 표시됩니다.
  • 세부 정보: 선택한 요청입니다. 로그 항목 읽기를 참조하십시오.

목록은 스크롤하면 더 많은 요청을 불러옵니다. 목록 끝에는 일치한 요청 수가 표시됩니다(예: "End of results · 5 logs").

목록 필터링

  1. 필터 막대에서 필터를 클릭합니다(예: Endpoint).
  2. 옵션을 선택하거나 값을 입력합니다. 예를 들어 Endpoint에 /api/door-gate-access/*를 입력하고 Apply를 클릭합니다.
  3. 필터에 선택한 값이 표시되고 목록이 업데이트됩니다. 필터를 더 추가하여 목록을 더 좁힐 수 있습니다. 요청이 목록에 표시되려면 모든 필터와 일치해야 합니다.
  4. 필터 하나를 제거하려면 해당 필터의 ×를 클릭합니다. 모두 제거하려면 필터가 설정되면 나타나는 Clear를 클릭합니다.

필터 막대: Range, Email, IP, Endpoint, Org, 시설, Method, Status, 그리고 Live, 새로 고침, CSV 내보내기필터 막대: Range, Email, IP, Endpoint, Org, 시설, Method, Status, 그리고 Live, 새로 고침, CSV 내보내기

그림 2: 필터 막대: Range, Email, IP, Endpoint, Org, 시설, Method, Status, 그리고 Live, 새로 고침, CSV 내보내기

필터일치 대상
Range요청이 발생한 시간입니다. 기본값은 Last 24 hours입니다. Range를 참조하십시오.
Email사용자의 전체 이메일 주소입니다(예: priya.shah@example.com). 입력하는 동안 주소가 제안될 수 있습니다.
IP요청이 발생한 전체 IP 주소입니다(예: 203.0.113.140)
Endpoint요청 대상인 Performance Hub의 부분입니다. 경로의 어느 부분이든 일치하며, * 와일드카드를 사용할 수 있습니다. 엔드포인트와 와일드카드를 참조하십시오.
Org하나의 조직 또는 Any org입니다. 하나 이상의 조직에 대한 접근 권한이 있을 때 표시됩니다.
시설하나의 시설 또는 모든 시설입니다. 하나 이상의 시설에 대한 접근 권한이 있을 때 표시됩니다.
MethodGET, POST, PUT, PATCH 또는 DELETE
Status응답 상태입니다. 상태를 참조하십시오.

Email과 IP에는 전체 값이 필요합니다

Email과 IP는 정확히 일치하는 항목만 찾습니다. ruby.castellano@example.com과 같은 전체 이메일 주소 또는 전체 IP 주소를 입력하십시오. ruby나 203.0.113처럼 주소의 일부만 입력하면 아무것도 찾지 못합니다.

전체 주소를 모르는 사람을 찾으려면 대시보드의 Top Users를 사용하거나, 그 사람의 요청 중 하나를 열고 User 필드에서 주소를 복사하십시오.

범위

Range를 클릭하여 조회할 기간을 선택합니다.

  • 사전 설정: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days, Last 90 days.
  • 날짜: 두 달 달력에서 시작 날짜와 종료 날짜를 선택한 다음 Apply를 클릭합니다. 범위를 변경하지 않고 메뉴를 닫으려면 Cancel을 클릭합니다. 90일보다 이전 날짜는 선택할 수 없습니다.

메뉴 하단의 안내에는 로그 보존 기간이 표시됩니다. "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."(감사 로그는 90일 동안 보존됩니다. 전체 요청 및 응답 페이로드는 7일 동안 보존되며, 그 이후에는 짧은 미리 보기만 남습니다. 더 긴 기록이 필요하면 지원팀에 문의하십시오(추가 요금 적용).)

Last 15 minutes부터 Last 90 days까지의 사전 설정, 두 달 달력, 로그 보존 기간 안내가 표시된 Range 메뉴Last 15 minutes부터 Last 90 days까지의 사전 설정, 두 달 달력, 로그 보존 기간 안내가 표시된 Range 메뉴

그림 3: Range: 사전 설정이나 달력의 날짜를 선택합니다. 안내에 로그 보존 기간이 표시됩니다

엔드포인트와 와일드카드

엔드포인트는 요청이 전송된 경로입니다(예: /api/door-gate-access/doors/front-entrance/unlock). 요청이 Performance Hub의 어느 부분을 대상으로 했는지 알려 줍니다.

  • *가 없으면 경로의 어느 부분이든 일치합니다. 예를 들어 unlock은 경로에 "unlock"이 포함된 모든 요청을 찾습니다.
  • *가 있으면 별표 사이의 모든 부분이 경로에 나타나야 합니다. 예를 들어 /api/door-gate-access/*는 모든 Door & Gate Access 요청을 찾고, /partner/v1/*는 Partner API를 사용하는 통합의 모든 요청을 찾습니다.

/api/door-gate-access/*가 입력되어 있고 Cancel과 Apply 버튼이 표시된 Endpoint 필터/api/door-gate-access/*가 입력되어 있고 Cancel과 Apply 버튼이 표시된 Endpoint 필터

그림 4: Endpoint는 * 와일드카드를 허용합니다(예: 모든 출입문 요청)

/api/door-gate-access/*로 필터링되어 출입문 요청 5개가 표시되고 첫 번째 요청이 열려 있는 Logs 탭/api/door-gate-access/*로 필터링되어 출입문 요청 5개가 표시되고 첫 번째 요청이 열려 있는 Logs 탭

그림 5: 엔드포인트 패턴으로 필터링한 후의 목록

어떤 엔드포인트를 사용해야 할지 모르십니까? 직접 잠금 해제한 출입문처럼 알고 있는 요청을 열고, 세부 정보에서 엔드포인트의 앞부분을 복사하십시오.

상태

Status를 클릭하여 응답 상태로 필터링합니다. **Search…**에 입력하면 상태를 빠르게 찾을 수 있습니다(예: "403"). 모든 상태를 표시하려면 Any를 선택합니다.

상태는 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error, 503 Service Unavailable처럼 이름과 함께 표시됩니다. 각 상태의 의미는 상태 코드를 참조하십시오.

검색 상자, Any, 200 OK부터 401 Unauthorised까지의 상태가 표시된 Status 메뉴검색 상자, Any, 200 OK부터 401 Unauthorised까지의 상태가 표시된 Status 메뉴

그림 6: 응답 상태로 필터링

Live 및 새로 고침

Logs 탭에서 Live는 기본적으로 Off이므로 조사하는 동안 목록이 바뀌지 않습니다. 새 요청이 들어오는 것을 보려면 Live를 켜고 목록을 새로 고칠 주기를 선택하십시오. 목록을 한 번 다시 불러오려면 새로 고침 버튼(원형 화살표)을 클릭합니다.

필터링된 보기 공유 또는 북마크

필터는 페이지 주소에 저장됩니다. 페이지를 북마크하면 같은 보기로 돌아올 수 있고, 주소를 동료에게 보낼 수도 있습니다. 동료가 감사 로그와 같은 조직에 대한 접근 권한이 있으면 같은 필터링된 목록을 볼 수 있습니다.

예를 들어 /audit-logs/logs?email=priya.shah%40example.com으로 끝나는 주소는 해당 사람으로 필터링된 목록을 열고, /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F*로 끝나는 주소는 모든 출입문 요청을 엽니다.

목록 탐색

  • 요청을 클릭하면 오른쪽에 세부 정보가 열립니다.
  • 위쪽 및 아래쪽 화살표 키를 사용하여 목록의 이전 또는 다음 요청으로 이동합니다.
  • 좁은 화면에서는 세부 정보가 목록 위에 열립니다. 목록으로 돌아가려면 닫기 버튼을 클릭합니다.

결과 없음

일치하는 항목이 없으면 목록에 "No logs match these filters"와 "Try widening the time range or clearing a filter."가 표시됩니다.

Email 필터가 설정되어 No logs match these filters가 표시된 Logs 탭Email 필터가 설정되어 No logs match these filters가 표시된 Logs 탭

그림 7: 일치하는 요청 없음: 범위를 넓히거나 필터를 지우십시오

찾는 항목을 찾으려면 다음을 수행하십시오.

  • Last 7 days와 같이 더 긴 Range를 선택합니다.
  • Email과 IP에 전체 주소가 입력되어 있는지 확인합니다. 주소의 일부로는 아무것도 찾지 못합니다.
  • ×로 필터를 하나씩 제거하거나 Clear를 클릭합니다.