사용자 지정 메트릭 내보내기

  • 아티클

적용 대상: 모든 API Management 계층

emit-metric 정책은 지정된 형식의 사용자 지정 메트릭을 Application Insights로 보냅니다.

참고 항목

참고 항목

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

정책 문

<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace"> 
    <dimension name="dimension name" value="dimension value" /> 
</emit-metric>

특성

특성 설명 필수 기본값
name 문자열입니다. 사용자 지정 메트릭의 이름입니다. 정책 식은 허용되지 않습니다. 예 해당 없음
namespace 문자열입니다. 사용자 지정 메트릭의 네임스페이스입니다. 정책 식은 허용되지 않습니다. 아니요 API Management
value double로 표현된 사용자 지정 메트릭의 값입니다. 정책 식이 허용됩니다. 아니요 1

Elements

요소 설명 필수
차원 사용자 지정 메트릭에 포함된 각 차원에 대해 이러한 요소 중 하나 이상을 추가합니다. 예

차원 특성

attribute 설명 필수 기본값
name 문자열 또는 정책 식입니다. 차원의 이름입니다. 예 해당 없음
value 문자열 또는 정책 식입니다. 차원의 값입니다. name은 기본 차원 중 하 나와 일치하는 경우에만 생략할 수 있습니다. 이 경우 값이 차원 이름에 따라 제공됩니다. 아니요 해당 없음

값 없이 사용할 수 있는 기본 차원 이름

  • API ID
  • 작업 ID
  • Product ID
  • 사용자 ID
  • 구독 ID
  • 위치 ID
  • 게이트웨이 ID:

사용

사용법 참고 사항

  • 이 정책에 대해 최대 10개의 사용자 지정 차원을 구성할 수 있습니다.

  • emit-metric 정책 호출은 구독의 지역별 사용자 지정 메트릭에 대한 사용 제한에 포함됩니다. 자세한 정보

예시

다음 예에서는 사용자 지정 메트릭을 전송하여 사용자 ID, 클라이언트 IP 및 API ID와 함께 API 요청 수를 사용자 지정 차원으로 계산합니다.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="User ID" /> 
        <dimension name="Client IP" value="@(context.Request.IpAddress)" /> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

관련 콘텐츠

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