• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

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

다음은 이벤트, 로그 또는 범위에서 지표를 생성할 때의 몇 가지 제한, 요구 사항 및 권장 사항입니다.

측정항목 집계

NRQL 쿼리는 다음 summary , uniqueCount 또는 distribution 함수 중 하나를 사용하여 측정항목을 집계해야 합니다.

함수

코멘트

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

카디널리티 제한

규칙 생성 제한 에는 메트릭 이름과 속성 값의 고유한 조합 수에 대한 제한이 포함됩니다. 이 제한은 많은 수의 속성 및/또는 속성 값으로 인해 보고되는 데이터 크기가 기하급수적으로 증가할 수 있기 때문에 존재합니다.

5개의 속성을 연결하는 메트릭 생성 규칙의 예:

FROM ProcessSample SELECT summary(ioTotalReadBytes)
WHERE entityType = 'ComputeSample'
FACET awsRegion, awsAvailabilityZone, commandName, entityName, processId

5개 속성 각각이 1분 시간 창 내에 10개의 고유 값을 보고한 경우 고유한 메트릭 이름/속성 조합의 수는 이론적으로 최대 10x10x10x10x10 또는 100,000이 됩니다. 여러 고유 값이 있는 여러 속성은 많은 고유 메트릭 항목으로 이어질 수 있습니다.

실제로는 속성이 종종 관련되어 있기 때문에 일반적으로 그렇지 않습니다. 예를 들어 한 속성이 hostname 이고 다른 속성이 awsRegion 인 경우 호스트 이름 A가 표시되면 항상 AWS 리전 B에 있습니다. 호스트 이름 A 및 기타 AWS 리전 값은 절대 볼 수 없습니다.

이것이 NRQL 생성 프로세스 중에 uniqueCount 함수를 사용하여 NRQL 쿼리가 생성하는 고유한 측정항목-이름/속성-값 조합의 수를 확인하는 것이 중요한 이유입니다.

하나의 규칙에서 여러 측정항목

규칙은 최대 10개의 메트릭을 생성할 수 있습니다. 한 번에 하나씩 생성된 메트릭과 단일 규칙으로 생성된 메트릭 사이에는 기능적 차이가 없습니다. 단일 규칙으로 여러 측정항목을 만드는 이유:

  • 계정당 규칙 한도 에 도달할 가능성이 적습니다.
  • 여러 메트릭에 동일한 속성을 더 쉽게 추가할 수 있습니다.

단일 규칙으로 여러 측정항목을 만드는 예:

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

측정항목 이름 지정

측정항목에는 NRQL 규칙 생성 프로세스 의 일부로 AS 절이 포함된 이름이 지정됩니다. 다음 NRQL 예에서 메트릭 이름은 io.totalread.bytes 입니다.

FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName

AS 절에 할당된 이름이 없는 경우 측정항목 이름은 쿼리된 속성의 이름입니다. 이 예에서 이름이 지정되지 않은 경우 측정항목 이름은 ioTotalReadBytes 입니다.

측정항목 이름

요구 사항 및 권장 사항

요구 사항

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

  • 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

속성

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

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

측정항목 이름 변경

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

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.