Share via

Trace

  • 아티클

적용 대상: 모든 API Management 계층

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

  • 추적이 트리거될 때 정책을 통해 테스트 콘솔의 요청 추적 출력에 사용자 지정 추적이 추가됩니다.
  • 이 정책은 Application Insights 통합이 사용되고 정책에 지정된 severity가 진단 설정에 지정된 verbosity보다 크거나 같은 경우 Application Insights에서 추적 원격 분석을 만듭니다.
  • 이 정책은 리소스 로그가 사용되고 정책에 지정된 심각도가 진단 설정에 지정된 세부 정보 표시 수준보다 높거나 같은 경우 로그 항목에 속성을 추가합니다.
  • 정책은 Application Insights 샘플링의 영향을 받지 않습니다. 정책의 모든 호출이 기록됩니다.

Important

  • 추적을 검색하기 위해 요청에 Ocp-Apim-Trace 헤더를 설정하고 응답에 Ocp-Apim-Trace-Location 헤더 값을 사용하더라도 API Management 요청 추적을 더 이상 사용하도록 설정할 수 없습니다.
  • 보안을 강화하기 위해 이제 API Management REST API를 사용하여 시간 제한 토큰을 가져오고 요청의 토큰을 게이트웨이에 전달하여 개별 API 수준에서 추적이 사용하도록 설정됩니다. 자세한 내용은 이 자습서의 뒷부분을 참조하세요.
  • 추적을 사용하도록 설정하면 추적 데이터의 중요한 정보가 노출될 수 있으므로 주의해야 합니다. 추적 데이터를 보호하기 위해 적절한 보안 조치가 마련되어 있는지 확인합니다.

참고 항목

현재 API 요청 추적은 Basic v2 및 Standard 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>

관련 콘텐츠

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