로그

로그 정책을 사용하여 API에 대한 기본 활동 로깅 구성을 사용자 정의하거나 대체합니다.

게이트웨이 지원

표 1. 이 정책을 지원하는 게이트웨이와 해당 정책 버전을 보여주는 표
게이트웨이	정책 버전
DataPower® API Gateway	2.0.0 2.1.0 (DataPower API Gateway 버전 10.0.3.0 이상)

이 항목에서는 어셈블리 사용자 인터페이스에서 정책을 구성하는 방법을 설명합니다. OpenAPI 소스에서 정책을 구성하는 방법에 대한 자세한 내용은 log를 참조하십시오.

정보

기본적으로 API 호출 시 활동 로깅 및 분석 서버로의 로그 데이터 전송 여부는 ‘활동 로깅 구성 ( OpenAPI2.0 )’ 또는 ‘활동 로깅 구성 ( OpenAPI3.0 )’에 설명된 대로 API 정의의 설정에 따라 결정됩니다. 그러나 로그 정책을 API 어셈블리 플로우에 추가하여 활동 로깅을 사용자 정의할 수 있습니다.

로그 정책을 사용하면 어셈블리에서 처리할 모든 API 분석 데이터를 수집하고 분석 서버로 전송되는 활동 로그 데이터를 제어할 수 있습니다. 다음은 로그 정책을 사용하여 API 활동 로깅을 사용자 정의할 수 있는 방법의 몇 가지 예입니다.

활동 로그 데이터를 수집하고 데이터에서 민감한 필드를 수정하기 위해 수정 정책을 사용한 후 분석 서버에 전송합니다.
특정 조건(호출된 API 오퍼레이션)에 따라 분석 데이터의 여러 수준을 전송합니다.
카탈로그에서 모든 API에 적용되는 글로벌 정책에서 사용자 정의 활동 로깅을 구성합니다. 글로벌 정책에 대한 자세한 내용은 ‘글로벌 정책 사용’을 참조하십시오.

특성

다음 표에서는 정책 특성을 나열하고, 특성이 필수인지 여부를 표시하며, 올바른 입력 값과 기본 입력 값을 지정하고, 값의 데이터 유형을 지정합니다.

표 2. 로그 정책 속성
특성 레이블	필수	설명	데이터 유형
제목	아니오	해당 정책의 제목입니다. 기본값은 `log`입니다.	문자열
설명	아니오	정책의 설명입니다.	문자열
모드	예	다음 옵션 중 하나를 선택하십시오. Gather-only: 모든 분석 데이터를 수집하고 `log` 컨텍스트 변수에 씁니다. 이는 API 실행 완료시 API 이벤트 레코드를 채웁니다. 컨텍스트 `log` 변수의 필드 및 이에 따른 API 이벤트 레코드에 대한 자세한 내용은 API 이벤트 레코드 필드 참조를 참조하십시오. Send-only: 다음 조치를 수행합니다. `log` 컨텍스트 변수에서 데이터를 읽습니다. 모든 메시지 페이로드를 자르고 텍스트 표시로 변환합니다. 분석 서버에 데이터를 전송합니다. Gather-and-send: `gather-only` 오퍼레이션을 수행한 후 `send-only` 오퍼레이션을 즉시 수행합니다. 전송 전용 또는 수집 후 전송 옵션을 사용하는 경우 DataPower API Gateway의 분석 엔드포인트에 대해 구성된 시간 간격에 따라 데이터가 버퍼링되어 분석 서버에 일괄처리로 전송됩니다. 자세한 내용은 ‘ DataPower ’ 지식 센터의 ‘분석 엔드포인트 구성’을 참조하십시오. 참고: 써드파티 분석 서버로 오프로드하는 경우 이벤트 데이터의 모든 측면을 수정할 수 있습니다. 분석 도구를 API Connect 사용 중인 경우, 요청 및 응답 페이로드만 가릴 수 있습니다.	문자열
로그 수준	아니오	로그에 기록할 콘텐츠의 유형. 다음 값 중 하나를 입력하십시오. `none`: 로깅이 없음을 표시합니다. `activity`; 자원 URI인 호출만 로그합니다. `header`: 활동과 헤더를 로깅합니다. `payload`: 활동, 헤더 및 페이로드를 로그합니다. `default`; API 정의에 지정된 로그 수준 설정을 사용합니다. 자세한 내용은 활동 로깅 구성 ( OpenAPI2.0 ) 또는 활동 로깅 구성 ( OpenAPI3.0 )을 참조하십시오. 이는 기본값입니다. `$(value)`: API 컨텍스트에서 값을 검색하기 위한 `$(value)` 형식의 인라인 매개변수입니다.