진단 로그 설정 참조: API Management
적용 대상: 모든 API Management 계층
이 참조에서는 API Management 인스턴스에서 API 진단 로깅에 대한 설정을 설명합니다. API 요청 로깅을 사용하도록 설정하려면 다음 지침을 참조하세요.
참고 항목
명시된 특정 설정은 Application Insights에 대한 로깅에만 적용됩니다.
| 설정 | Type | 설명 |
|---|---|---|
| Enable | 부울 값 | 이 API의 로깅을 사용할 수 있는지 여부를 지정합니다. 로깅은 모든 API 또는 개별 API에 대해 사용하도록 설정할 수 있습니다. 개별 API에 대한 설정은 사용하도록 설정된 경우 모든 API에 대한 설정을 재정의합니다. |
| 대상 | Azure 애플리케이션 Insights 로거 | Application Insights 로깅에 사용할 로거를 지정합니다. |
| 샘플링(%) | decimal | 0-100의 값(퍼센트)입니다. 기록되는 요청의 백분율을 지정합니다. 0% 샘플링은 기록된 요청이 0개인 반면, 100% 샘플링은 모든 요청이 기록되었음을 의미합니다. Default: 100 Application Insights 로깅의 성능 영향은 성능 영향 및 로그 샘플링을 참조하세요. |
| 항상 로그 오류 | 부울 값 | 이 설정을 사용하면 샘플링 설정에 관계없이 모든 오류가 기록됩니다. |
| 로그 클라이언트 IP 주소 | 부울 값 | 이 설정을 사용하도록 설정하면 API 요청에 대한 클라이언트 IP 주소가 기록됩니다. |
| Verbosity | 로그의 세부 정보 표시와 추적 정책에 구성된 사용자 지정 추적이 기록되는지 여부를 지정합니다. * 오류 - 실패한 요청 및 심각도의 사용자 지정 추적 error* 정보 - 실패하고 성공한 요청 및 심각도 error 의 사용자 지정 추적 및 information* 자세한 정보 표시 - 실패하고 성공한 요청 및 심각도 error의 사용자 지정 추적, information및 verbose기본 정보: |
|
| 상관 관계 프로토콜 | 여러 구성 요소에서 보낸 원격 분석과 Application Insights의 상관 관계를 지정하는 데 사용되는 프로토콜을 지정합니다. 기본값: 레거시 자세한 내용은 Application Insights의 원격 분석 상관 관계를 참조 하세요. |
|
| 기록할 헤더 | list | 요청 및 응답에 대해 기록되는 헤더를 지정합니다. 기본값: 헤더가 기록되지 않습니다. |
| 기록할 페이로드(본문) 바이트 수 | 정수 | 기록된 프런트 엔드 또는 백 엔드 요청 또는 응답 본문의 초기 바이트 수를 지정합니다. 최대: 8,192. 기본값: 0 |
| 프런트 엔드 요청 | 프런트 엔드 요청(API Management 게이트웨이로 들어오는 요청)이 기록되는지 여부와 방법을 지정합니다. 이 설정을 사용하는 경우 기록할 헤더, 기록할 페이로드 바이트 수 또는 둘 다를 지정합니다. |
|
| 프런트 엔드 응답 | 프런트 엔드 응답(API Management 게이트웨이에서 나가는 응답)이 기록되는지 여부와 방법을 지정합니다. 이 설정을 사용하는 경우 기록할 헤더, 기록할 페이로드 바이트 수 또는 둘 다를 지정합니다. |
|
| 백 엔드 요청 | 백 엔드 요청(API Management 게이트웨이에서 나가는 요청)이 기록되는지 여부와 방법을 지정합니다. 이 설정을 사용하는 경우 기록할 헤더, 기록할 페이로드 바이트 수 또는 둘 다를 지정합니다. |
|
| 백 엔드 응답 | 백 엔드 응답(API Management 게이트웨이로 들어오는 응답)이 기록되는지 여부와 방법을 지정합니다. 이 설정을 사용하는 경우 기록할 헤더, 기록할 페이로드 바이트 수 또는 둘 다를 지정합니다. |
Important
사용하도록 설정된 경우 기록된 요청 또는 응답 페이로드는 최대 8,192바이트일 수 있습니다. 또한 API Management는 상태 코드, 헤더 및 타임스탬프와 같은 페이로드 및 기타 특성을 포함하는 Azure Monitor로 전송되는 진단 로그 항목에 대해 32KB 제한을 적용합니다. 특성의 결합된 크기가 32KB를 초과하는 경우 API Management는 모든 본문 및 추적 콘텐츠를 제거하여 항목을 자릅니다.