다음을 통해 공유

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

  • 아티클

적용 대상: 모든 API Management 계층

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

참고 항목

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

사용자 지정 메트릭 한도

Azure Monitor는 API Management에서 메트릭을 내보내는 기능에 영향을 줄 수 있는 사용자 지정 메트릭에 대해 사용 제한을 적용합니다. 예를 들어, Azure Monitor는 현재 메트릭당 차원 키 제한을 10개로 설정하고 구독의 지역당 총 활성 시계열 제한을 50,000개(12시간 이내)로 설정합니다.

이러한 제한은 다음과 같은 API Management 정책에서 사용자 지정 메트릭을 구성하는 데 다음과 같은 emit-metric azure-openai-emit-token-metric영향을 줍니다.

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

  • 12시간 이내에 정책에 의해 생성된 활성 시계열 수는 해당 기간 동안 구성된 각 차원의 고유 값 수를 곱한 것입니다. 예를 들어, 정책에 3개의 사용자 지정 차원이 구성되어 있고 각 차원에 해당 기간 내에 가능한 값이 10개 있는 경우 정책은 1,000(10 x 10 x 10)개의 활성 시계열을 제공합니다.

  • 구독의 동일한 지역에 있는 여러 API Management 인스턴스에서 정책을 구성하는 경우 모든 인스턴스가 지역 활성 시계열 제한에 기여할 수 있습니다.

Azure Monitor에서 사용자 지정 메트릭에 대한 디자인 제한 사항 및 고려 사항에 대해 자세히 알아봅니다.

필수 조건

정책 문

<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:

사용

사용법 참고 사항

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

예시

다음 예제에서는 사용자 지정 메트릭을 보내 API ID와 함께 API 요청 수를 사용자 지정 차원으로 계산합니다.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

관련 콘텐츠

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