REST 및 SOAP API 분석 수집 및 정리

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기2분

    • API 분석은 예약된 작업을 사용하여 분석 데이터를 수집하고 정리합니다.

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

    다음 테이블을 참조하여 기록할 요청을 확인합니다.
    표 1. 기록된 요청
    API 이름 예시 자원 응답 코드 설명 기록
    지금/테이블 /api/now/table/incident 401을 제외한 모든 항목 유효한 리소스 및 테이블 예
    지금/테이블 /api/now/table/invalidResource 400 자원은 유효하지만 테이블이 잘못됨 예
    지금/테이블 /api/now/table/incident 403 요청하는 사용자에게 권한이 부족합니다. 예
    지금/테이블 /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 또는 Scripted SOAP 서비스와 같이 설명되는 API 유형에 따라 결정됩니다.

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

    예를 들어 테이블 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 이름으로 사용됩니다.