REST 및 SOAP API 분석 수집 및 정리

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기2분
  • API 분석은 예약된 작업을 사용하여 분석 데이터를 수집하고 정리합니다.

    인스턴스는 포함 목록의 API에 대한 모든 웹 서비스 트랜잭션을 추적하고 자원 및 HTTP 작업 조합별로 집계된 일일 기록을 유지관리합니다. 요청자 정보는 요청자, 자원 및 HTTP 작업 조합별로 집계되며 속성 com.glide.api.stats.daily_ limit에 정의된 일일 제한까지 추적됩니다.

    기록되는 요청을 확인하려면 다음 표를 참조하십시오.
    표 1. 기록된 요청
    API 이름 예시 자원 응답 코드 설명 기록
    now/테이블 /api/now/table/incident 401을 제외한 모든 항목 유효한 자원 및 테이블
    now/테이블 /api/now/table/invalidResource 400 자원은 올바르지만 테이블이 잘못되었습니다.
    now/테이블 /api/now/table/incident 403 요청하는 사용자에게 권한이 부족합니다.
    now/테이블 /api/now/table/incident 401 요청 사용자가 인증되지 않았습니다. 아니요
    myApp/myScriptedApi myApp/myScriptedApi/myResource 401을 제외한 모든 항목 유효한 자원
    myApp/invalidApiName
    • myApp/invalidApiName
    • myApp/invalidApiName/myResource
    400 일치하는 포함 목록 항목이 있더라도 잘못된 API 아니요

    매월 2일에 API 월별 통계 예약된 작업은 각 자원 및 HTTP 작업 조합에 대한 월별 합계를 계산합니다. API 월별 요청자 통계 예약된 작업은 매일 2일이 지난 일일 점수를 기반으로 각 리소스, 요청자 및 HTTP 작업 조합의 월별 합계를 계산합니다.

    일일 통계는 33일 동안 유지됩니다. 월별 합계는 13개월 동안 유지됩니다. sys_api_stats, sys_api_stats_requestor 및 sys_api_stats_requestor_monthly 테이블의 테이블 클리너는 이러한 제한보다 오래된 분석 기록을 제거합니다.

    REST & SOAP API 분석 이름 지정

    API 분석을 추적할 때 사용되는 API 이름은 REST API 또는 스크립트된 SOAP 서비스와 같이 설명되는 API 유형에 따라 결정됩니다.

    API 유형 설명
    REST API 네임스페이스와 네임스페이스 다음에 오는 URI의 첫 번째 부분이 API 이름으로 사용됩니다.

    예를 들어 Table API 엔드포인트 api/now/table/incident api/now/table/problem의 경우 네임스페이스와 ID는 now/table입니다.

    직접 SOAP(테이블이 임포트 세트 행 테이블을 확장하지 않음) 직접 SOAP 요청이 테이블에 액세스하는 경우 직접 SOAP가 API 이름으로 사용됩니다.
    SOAP 임포트(테이블이 임포트 세트 행 테이블을 확장함) 임포트 세트 SOAP가 API 이름으로 사용됩니다.
    스크립트된 SOAP 서비스 SOAP 요청 엔드포인트 페이지는 my_service.do와 같은 API 이름으로 사용됩니다.