메트릭 생성 규칙: 요구 사항 및 팁

summary

각 기간(현재 1분)에 대한 요약 메트릭 데이터 포인트를 생성합니다. NRQL 쿼리가 평균, 합계, 최소 또는 최대와 같은 요약 메트릭 유형에서 지원하는 집계 함수 를 사용하는 경우 사용합니다.

규칙 생성 쿼리의 예:

SELECT summary(duration) AS 'service.responseTime' FROM Transaction 
WHERE appName = 'Data Points Staging' FACET name, appName, host

uniqueCount

각 1분 기간에 대해 uniqueCount 측정항목 데이터 요소를 만듭니다. NRQL 쿼리가 uniqueCount 집계 유형 을 사용하는 경우 이를 사용합니다.

규칙 생성 쿼리의 예:

FROM Transaction SELECT uniqueCount(request.headers.userAgent) 
AS 'server.request.header.userAgent.uniqueCount' 
WHERE appName = 'Browser Monitoring Router' FACET http.statusCode, name, appName, host

distribution

각 1분 시간 창에 대한 분포 메트릭 데이터 요소를 만듭니다. NRQL 쿼리가 백분위수, 히스토그램, 최소값, 최대값, 평균, 합계 또는 개수와 같은 집계 함수 를 사용하는 경우 사용합니다. 관심 있는 속성만 인수로 사용하고 percentile 또는 histogram 의 나머지 인수는 버리십시오. 생성된 측정항목은 percentile 또는 histogram 에 대한 모든 인수를 지원합니다.

distribution 규칙 생성의 예:

SELECT distribution(duration) AS 'service.responseTime' FROM Transaction 
WHERE appName = 'Data Points Staging' FACET name, appName, host

단순 개수: summary(1) 및 sum

특정 WHERE 절과 일치하는 이벤트, 로그 또는 범위의 단순 개수인 측정항목을 원하는 경우 summary(1) 측정항목을 사용합니다. 이 지표 유형은 분당 지정된 이벤트, 로그 또는 스팬의 수를 계산합니다. 생성된 측정항목을 쿼리할 때 sum 메서드를 사용하여 결과를 확인합니다.

예: 이름이 foo 인 트랜잭션을 계산하는 foo.count 이라는 측정항목을 생성하려는 경우 NRQL은 다음과 같습니다.

FROM Transaction SELECT summary(1) AS 'foo.count' WHERE name = 'foo'

그런 다음 다음과 같이 쿼리합니다.

FROM Metric SELECT sum(foo.count) SINCE 30 minutes ago

측정항목에 대한 자세한 내용은 측정 항목 유형 에 대한 설명서를 참조하십시오.

계정 한도

계정에는 최대 1,000개의 메트릭 생성 규칙이 있을 수 있습니다.

측정항목 규칙 제한

규칙은 다음을 수행할 수 있습니다.

• 최대 10개의 측정항목을 만듭니다.
• 한 가지 유형의 데이터(이벤트, 로그 또는 범위)만 사용합니다.
• 메트릭에 포함할 최대 20개의 속성(패싯)을 선택합니다.

기간 제한

30초 기간 동안 단일 메트릭에 대한 고유한 메트릭-이름/속성-값 조합에 대한 50K 제한. 롤업에 대한 일반 카디널리티 제한 이 적용됩니다.

30초의 50k 창 제한을 초과하면 규칙이 비활성화되고 다음을 포함하는 NrIntegrationError 이벤트 가 해당 계정에 생성됩니다.

• 규칙 세부정보
• 너무 많은 측면이 있다는 메시지
• newRelicFeature 속성 값 eventToMetric

요구 사항

메트릭 이름 지정 요구 사항:

• 255(UTF-16) 16비트 코드 단위 이하입니다. 제한 미만인지 확인하는 한 가지 방법은 각 문자열을 가장 쉽게 계산할 수 있는 127개 미만으로 유지하는 것입니다.

• 공백이 없습니다.

• 편지로 시작하십시오.

  강력한 메트릭 이름의 예:

• rubyvm.memory.heap_used

• redis.container.cpu.percent

• memcached.process_virtual_memory.bytes

길이 및 구조

다른 사람들이 이 측정항목을 쉽게 찾고, 이해하고, 사용할 수 있도록 이름과 구조를 결정하십시오.

• 이상적인 가독성을 위해 메트릭 이름을 40자 미만으로 유지하는 것이 좋습니다. 더 긴 이름은 잘리거나 다른 이름과 겹칠 수 있습니다.
• 메트릭 명명 체계는 비즈니스 로직에 따라 다릅니다. 네임스페이스를 사용하여 메트릭 이름을 접두사로 사용하거나 이름을 보다 일반적으로 지정해야 할 수 있습니다.

이름 내의 구성 요소

메트릭 이름 내에 구성 요소를 생성하려면(예: 메트릭 소스 및 측정 대상), 광범위한 것에서 구체적인 것(왼쪽에서 오른쪽으로)으로 이동하는 것이 좋습니다.

1. New Relic 메트릭 이름과 일치하도록 점을 사용하여 해당 구성 요소를 구분합니다.

2. 그런 다음 밑줄을 사용하여 점 안의 단어를 구분합니다.

   예시:

   application.page_view.duration

   카피

속성

메트릭 이름에 속성을 넣지 마십시오. 속성은 클러스터 또는 가용 영역과 같이 데이터를 필터링하거나 패싯 처리하는 데 사용할 수 있는 메트릭의 품질입니다.

예: 메트릭 이름에 가용 영역을 포함했다면 해당 메트릭에 대해 모든 가용 영역에서 결과를 볼 수 없다는 의미입니다.

측정항목 이름 변경

메트릭 이름을 변경하면 기록 데이터가 새 이름으로 업데이트 되지 않습니다 . 해당 기록 데이터를 쿼리하거나 차트로 작성하려면 이전 측정항목 이름을 지정해야 합니다.