활동 로그 정책

API 이벤트에 저장된 데이터의 세부사항 레벨을 관리하도록 활동 로그 정책을 구성하십시오.

API Manager UI에서 API를 구성할 때 activity log 특성을 사용하여 해당 API에 대한 호출을 위해 API 이벤트 레코드에 저장되는 데이터를 선택합니다. activity log 특성에는 성공적인 API 호출 및 실패한 API 호출에 대한 별도의 설정이 있습니다. 활동 로그 옵션은 다음과 같습니다.

none - API 이벤트가 기록되지 않습니다.
활동 - API 리소스 URI를 기록합니다. activity 는 성공적인 API 호출에 대한 기본 로그 설정입니다.
헤더 - API 리소스 URI 및 HTTP 헤더를 기록합니다.
페이로드 - API 리소스 URI, HTTP 헤더, 요청 및 응답 페이로드를 기록합니다. 응답 페이로드에 실패 원인에 대한 유용한 정보가 있을 수 있으므로 payload 는 실패한 API 호출에 대한 기본 로그 설정입니다.

참고:

게이트웨이가 모든 API 호출을 OAuth 공급자로 인증하도록 구성된 경우, OAuth 호출과 관련된 데이터는 OAuth 호출이 실패했을 때에만 API 이벤트 데이터에 포함됩니다. OAuth 인증 성공은 API 이벤트 데이터에 기록되지 않습니다.

중요: 최대 API 이벤트 레코드 크기는 19Mb입니다. 분석 하위 시스템은 19Mb보다 큰 API 이벤트 레코드는 모두 거부합니다.

API Manager UI에서 로그 설정 정의

API 관리자 UI 개발 보기에서 작업할 API를 선택하십시오. API Manager의 UI 개발 보기에 익숙하지 않다면, ‘API 정의 작업’을 참조하십시오.
게이트웨이 탭을 선택하고 게이트웨이 및 포털 설정을 펼친 후 활동 로그를 선택하십시오.
사용을 선택한 후 성공 컨텐츠 및 오류 컨텐츠에 대해 선호하는 로그 설정을 선택하십시오.
- none - API 이벤트가 기록되지 않습니다.
- 활동 - API 리소스 URI를 기록합니다. activity 는 성공적인 API 호출에 대한 기본 로그 설정입니다.
- 헤더 - API 리소스 URI 및 HTTP 헤더를 기록합니다.
- 페이로드 - API 리소스 URI, HTTP 헤더, 요청 및 응답 페이로드를 기록합니다. 응답 페이로드에 실패 원인에 대한 유용한 정보가 있을 수 있으므로 payload 는 실패한 API 호출에 대한 기본 로그 설정입니다.
저장을 클릭하여 변경 사항을 저장합니다.

DataPower® API Gateway 에 대한 소스에서 로그 설정 정의

activity-log 확장을 사용하여 로깅 환경 설정을 구성하십시오.

activity-log:
  success-content: <success log setting: none, activity, header, payload>
  error-content: <failure log setting: none, activity, header, payload>
  enabled: <if activity logging is enabled: true or false>

참고: 페이로드 로깅이 사용으로 설정된 경우 페이로드 버퍼링을 캡처하기 위한 게이트웨이도 사용으로 설정되어야 합니다.

activity-log:
  success-content: <success log setting: none, activity, header, payload>
  error-content: <failure log setting: none, activity, header, payload>
  enabled: <if activity logging is enabled: true or false>
buffering: true

예

성공적인 호출에 대한 로깅 없음, 실패한 호출에 대한 헤더 로깅

activity-log:
    success-content: none
    error-content: header
    enabled: true

활동 로깅 사용 안함

activity-log:
    enabled: false