활동 로깅 구성

분석에 저장된 API 활동에 대해 로깅 환경 설정을 구성할 수 있으며 기본 활동 로깅 동작을 대체합니다.

이 태스크에 대한 정보

참고:
  • 이 태스크는 OpenAPI 3.0 API 정의 구성과 관련이 있습니다. OpenAPI 2.0 API 정의를 구성하는 방법에 대한 세부사항은 OpenAPI 2.0 API 정의 편집을 참조하십시오.
  • OpenAPI 3.0 API는 DataPower Gateway (v5 compatible)가 아닌 DataPower® API Gateway에서만 지원됩니다.
  • 현재 OpenAPI 3.0 지원 제한사항에 대한 세부사항은 IBM® API ConnectAI Gateway 의 OpenAPI 3.0 지원의 내용을 참조하십시오.

API Designer UI 애플리케이션을 사용하거나 브라우저 기반 API Manager UI를 사용하여 이 태스크를 완료할 수 있습니다.

게이트웨이 서버에 있는 각 API 실행 이벤트의 API 이벤트 레코드가 있습니다. 기본적으로 성공적인 API 실행을 위한 컨텐츠 유형은 활동이며 API 호출에 대한 페이로드 는 오류 코드의 결과를 호출합니다. API 정의를 작성할 때 이러한 API 이벤트 레코드에 로그인하는 컨텐츠의 유형을 변경할 수 있습니다. API 실행 중에 활동 데이터는 API 실행 완료 시 API 이벤트 레코드를 채우는 log 컨텍스트 변수에 저장됩니다. 자세한 정보는 API 활동 로깅 컨텍스트 변수를 참조하십시오.

참고:

성공 시 분석 데이터의 로깅을 위해 호출하는 활동 로깅은 OAuth 제공자에 대해 적용되지 않습니다. OAuth 제공자는 실패한 경우에 분석 데이터를 로그하지만 성공한 경우에는 로그하지 않습니다.

언제든지 소스 아이콘을 클릭하면 기본 OpenAPI 소스 아이콘OpenAPI YAML 소스 파일로 바로 전환할 수 있습니다. 양식 화면으로 돌아가려면 양식 아이콘을 클릭하세요 양식 아이콘.

프로시저

  1. OpenAPI 3.0 API 정의 편집에 설명된 대로 편집할 API를 여십시오.
  2. 게이트웨이 탭을 선택하고 게이트웨이 및 포털 설정을 펼친 후 활동 로그를 클릭하십시오.
  3. 사용을 선택한 후 다음과 같이 성공 컨텐츠오류 컨텐츠 필드에 대한 옵션을 선택하십시오.

    표 1. 참고 정보
    필드 레이블 설명
    성공 컨텐츠 오퍼레이션에 성공할 때 로그되어야 하는 컨텐츠 유형을 정의합니다.
    • 없음 : API 이벤트가 기록되지 않습니다.
    • 작업 : API 리소스 URI를 기록합니다.
    • 헤더 : API 리소스 URI와 HTTP 헤더를 기록합니다.
    • 페이로드 : API 리소스 URI, HTTP 헤더 및 페이로드를 기록합니다. 요청에서 수신되거나 응답에서 반환되는 페이로드를 포함한 모든 정보가 기록됩니다.

    기본값은 activity입니다.

    오류 컨텐츠 오류가 발생하는 경우 로그할 컨텐츠를 표시합니다.
    • 없음 : API 이벤트가 기록되지 않습니다.
    • 작업 : API 리소스 URI를 기록합니다.
    • 헤더 : API 리소스 URI와 HTTP 헤더를 기록합니다.
    • 페이로드 : API 리소스 URI, HTTP 헤더 및 페이로드를 기록합니다. 요청에서 수신되거나 응답에서 반환되는 페이로드를 포함한 모든 정보가 기록됩니다.

    기본값은 payload입니다.

  4. 저장을 클릭하여 변경사항을 저장하십시오.