Trace

  • 아티클

적용 대상: 모든 API Management 계층

trace 정책은 테스트 콘솔, Application Insights 원격 분석 및/또는 리소스 로그의 요청 추적 출력에 사용자 지정 추적을 추가합니다.

  • 이 정책은 추적이 트리거될 때 테스트 콘솔의 요청 추적 출력에 사용자 지정 추적을 추가합니다. 즉 Ocp-Apim-Trace 요청 헤더가 있고 true로 설정되며 Ocp-Apim-Subscription-Key 요청 헤더가 있고 추적을 허용하는 유효한 키를 포함합니다.
  • 이 정책은 Application Insights 통합이 사용되고 정책에 지정된 severity가 진단 설정에 지정된 verbosity보다 크거나 같은 경우 Application Insights에서 추적 원격 분석을 만듭니다.
  • 이 정책은 리소스 로그가 사용되고 정책에 지정된 심각도가 진단 설정에 지정된 세부 정보 표시 수준보다 높거나 같은 경우 로그 항목에 속성을 추가합니다.
  • 정책은 Application Insights 샘플링의 영향을 받지 않습니다. 정책의 모든 호출이 기록됩니다.

Warning

  • 디버깅 목적으로 의도된 구독에 대해서만 추적을 허용합니다. 권한이 없는 사용자와 추적이 허용된 구독 키를 공유하면 키, 액세스 토큰, 암호, 내부 호스트 이름, IP 주소와 같은 추적 로그에 포함된 중요한 정보가 공개될 수 있습니다.
  • 테스트 콘솔에서 API Management는 구독에서 추적을 사용하도록 설정한 후 1시간이 지나면 자동으로 사용하지 않도록 설정합니다.

참고 항목

현재 API 요청 추적은 기본 v2 및 표준 v2 계층에서 지원되지 않습니다.

참고 항목

정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.

정책 문

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

특성

특성 설명 필수 항목 기본값
source 추적 뷰어에 의미있고 메시지 원본을 지정하는 문자열 리터럴입니다. 정책 식은 허용되지 않습니다. 예 해당 없음
severity 추적의 심각도 수준을 지정합니다. 허용되는 값은 verbose, information, error(최저에서 최고까지 순서)입니다. 정책 식은 허용되지 않습니다. 아니요 verbose

Elements

이름 설명 필수
message 로그할 문자열 또는 식입니다. 정책 식이 허용됩니다. 예
metadata Application Insights 추적 원격 분석에 사용자 지정 속성을 추가합니다. 아니요

metadata 특성

attribute 설명 필수 항목 기본값
name 속성의 이름입니다. 예 해당 없음
value 속성 값입니다. 예 해당 없음

사용

예시

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

관련 콘텐츠

정책 작업에 대한 자세한 내용은 다음을 참조하세요.