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

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

측정항목 집계

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

함수	코멘트
`summary`	각 기간(현재 1분)에 대한 요약 지표 데이터 포인트를 생성합니다. NRQL 쿼리가 요약 지표 유형(예: `average`, `sum`, `min` 또는 `max`)에서 지원하는 변수자 함수를 사용하는 경우 이 옵션을 사용하세요. Example rule-creation query: `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`, `min`, `max`, `average`, `sum`, `count` 등의 변수자 함수를 사용하는 경우 이를 사용하세요. 관심 있는 속성만 인수로 사용하고 `percentile` 또는 `histogram` 의 나머지 인수는 삭제합니다. 생성된 지표는 `percentile` 또는 `histogram` 의 모든 인수를 지원합니다. Example of creating a `distribution` rule: `SELECT distribution(duration) AS 'service.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host`
단순 개수: `summary(1)` 및 `sum`	특정 `WHERE` 절과 일치하는 이벤트, 로그 또는 범위의 단순 개수인 측정항목을 원하는 경우 `summary(1)` 측정항목을 사용합니다. 이 지표 유형은 분당 지정된 이벤트, 로그 또는 스팬의 수를 계산합니다. 생성된 측정항목을 쿼리할 때 `sum` 메서드를 사용하여 결과를 확인합니다. Example: `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`

제한

코멘트

계정 한도

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

측정항목 규칙 제한

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

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

기간 제한

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

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

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

카디널리티 제한

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

Example metric creation rule that attaches five attributes:

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

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

Example creating multiple metrics with a single rule:

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자 미만으로 유지하는 것이 좋습니다. 더 긴 이름은 잘리거나 다른 이름과 겹칠 수 있습니다. 메트릭 명명 체계는 비즈니스 로직에 따라 다릅니다. 네임스페이스를 사용하여 메트릭 이름을 접두사로 사용하거나 이름을 보다 일반적으로 지정해야 할 수 있습니다.
이름 내의 구성 요소	메트릭 이름 내에 구성 요소를 생성하려면(예: 메트릭 소스 및 측정 대상), 광범위한 것에서 구체적인 것(왼쪽에서 오른쪽으로)으로 이동하는 것이 좋습니다. New Relic 메트릭 이름과 일치하도록 점을 사용하여 해당 구성 요소를 구분합니다. 그런 다음 밑줄을 사용하여 점 안의 단어를 구분합니다. Example: `application.page_view.duration`
속성	메트릭 이름에 속성을 넣지 마십시오. 속성은 클러스터 또는 가용 영역과 같이 데이터를 필터링하거나 패싯 처리하는 데 사용할 수 있는 메트릭의 품질입니다. Example: 지표 이름에 가용성 영역을 포함하면 해당 지표에 대해 모든 가용성 영역에 대한 결과를 볼 수 없다는 의미입니다.
측정항목 이름 변경	메트릭 이름을 변경하면 기록 데이터가 새 이름으로 업데이트 되지 않습니다 . 해당 기록 데이터를 쿼리하거나 차트로 작성하려면 이전 측정항목 이름을 지정해야 합니다.