이벤트, 로그 및 범위를 포함하여 New Relic의 다른 유형의 데이터에서 메트릭 유형 데이터 를 생성할 수 있습니다. 메트릭은 데이터의 집계이며 장기간에 걸친 추세를 분석하고 모니터링하는 데 최적입니다.
이 문서에서는 다음을 설명합니다.
다른 데이터 유형에서 메트릭을 만드는 이유는 무엇입니까? 메트릭을 사용하면 보다 효율적인 데이터 저장이 가능합니다. 이를 통해 데이터를 쿼리하고 차트를 보다 쉽게 작성할 수 있습니다. New Relic에서 측정항목과 다른 유형의 데이터 간의 차이는 시간을 기반으로 합니다. 자세한 내용은 데이터 유형 이해 를 참조하십시오.
Events, logs, spans: 이러한 유형의 데이터는 특정 시점의 단일 레코드를 나타냅니다. 예를 들어 시스템에 대한 모든 요청에 대해 이벤트가 있을 수 있습니다. 이 데이터는 심층적인 문제 해결 및 분석에 이상적입니다.Metrics: 이는 이벤트, 로그 또는 범위에 대한 집계된 보기를 제공합니다. 지표는 더 긴 시간 범위에 대한 추세를 표시하는 데 더 좋습니다. 예를 들어 서비스당 총 요청 수를 하나의 지표로 집계한 다음 이 정보를 월 단위로 조사할 수 있습니다.메트릭을 사용하는 이유
코멘트
유연성
측정항목은 차원 입니다. 어떤 메타데이터(예: 호스트 이름 또는 앱 이름)를 첨부할지 선택할 수 있습니다. 평균, 합계, 최소값 및 최대값과 같은 일반적인 메트릭 측정값은 이미 계산되어 있습니다. 데이터 집계 및 보존
데이터는 이미 더 긴 기간의 버킷으로 사전 집계되었습니다. 데이터 보존 기간은 13개월입니다. 쿼리 기능
다음은 이벤트 데이터에서 측정항목 데이터를 생성하는 방법을 보여주는 동영상입니다(7분 47초).
데이터를 측정항목으로 변환하려면 규칙을 만드세요.
사용 가능한 작업 이벤트, 로그 또는 범위에서 메트릭을 생성하기 위한 규칙을 표시, 생성 및 삭제하려면 GraphQL 형식 API인 NerdGraph를 사용하십시오. 작업을 수행하기 전에 NerdGraph 소개를 읽고 GraphiQL API 도구 로 데이터를 탐색하는 것이 좋습니다.
이러한 작업은 두 가지 기본 요청 유형 에 속합니다.
Mutations 는 기존 규칙이나 설정을 변경하는 작업입니다(예: 새 지표 규칙 생성).Queries , 기존 데이터를 가져오는 데 사용됩니다(예: 기존 지표 규칙 가져오기).모든 작업은 현재 로그인한 New Relic 사용자로 NerdGraph에서 역할 기반입니다.
돌연변이 메트릭에 대한 이벤트, 메트릭에 대한 로그 또는 메트릭에 대한 범위에 대한 변형 작업은 다음과 같습니다.
규칙 삭제 중요 이 작업은 프로덕션 설정을 수정하므로 작업을 실행하기 전에 변경 사항을 철저히 검토하는 것이 좋습니다.
규칙을 삭제하려면 규칙 ID와 New Relic 계정 ID 가 필요합니다.
Example request:
eventsToMetricsDeleteRule ( deletes : { ruleId : "12" , accountId : 123456 } ) {
이 요청에서:
요소
설명
mutation
기본 API 작업 유형 중 하나입니다.
eventsToMetricsDeleteRule
규칙을 삭제하기 위해 호출되는 메서드입니다.
deletes
여기에는 두 개의 매개변수가 필요합니다.
ruleId
: 메트릭에 대한 이벤트, 메트릭에 대한 로그 또는 메트릭에 대한 범위에 대한 규칙의 ID입니다.accountId
: New Relic 계정 ID .successes
및 submitted
블록
여기에서 성공 또는 실패로 반환되는 데이터를 정의합니다. 다음 블록에 사용 가능한 매개변수:
id
(또는 submitted
의 경우 ruleId
)name
description
nrql
enabled
accountId
Example response for the request:
"eventsToMetricsDeleteRule" : {
"nrql" : "select summary(duration) as 'server.responseTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
규칙 활성화 또는 비활성화 중요 이 작업은 프로덕션 설정을 수정하므로 작업을 실행하기 전에 변경 사항을 철저히 검토하는 것이 좋습니다.
측정항목에 대한 이벤트, 측정항목에 대한 로그 또는 측정항목에 대한 범위에 대한 기존 규칙을 활성화 또는 비활성화하려면 동일한 eventsToMetricsUpdateRule
작업을 사용합니다. 유일한 차이점은 enabled
이 true
또는 false
으로 설정되어 있는지 여부입니다.
Example request to enable an existing metrics rule:
eventsToMetricsUpdateRule (
updates : { ruleId : "12" , accountId : 123456 , enabled : true }
이 요청에서:
요소
설명
mutation
기본 API 작업 유형 중 하나입니다.
eventsToMetricsUpdateRule
기존 규칙을 업데이트하고 활성화 또는 비활성화하기 위해 호출되는 메서드입니다.
updates
여기에는 세 가지 필수 매개변수가 필요합니다.
ruleId
: 메트릭에 대한 이벤트, 메트릭에 대한 로그 또는 메트릭에 대한 범위에 대한 규칙의 ID입니다.accountId
: New Relic 계정 ID .enabled
: 비활성화된 규칙을 활성화하려면 이것을 true
으로 설정하십시오. 규칙을 비활성화하려면 이것을 false
로 설정하십시오.successes
및 submitted
블록
여기에서 성공 또는 실패로 반환되는 데이터를 정의합니다. 다음 블록에 사용 가능한 매개변수:
id
(또는 submitted
의 경우 ruleId
)name
description
nrql
enabled
accountId
쿼리 쿼리 작업에는 다음이 포함됩니다.
New Relic 계정에 대한 모든 규칙 나열 New Relic 계정의 모든 규칙을 나열하거나 특정 규칙을 반환할 수 있습니다.
Example listing all rules for account 123456
:
이 요청에서:
요소
설명
query
기본 API 작업 유형 중 하나입니다. 쿼리에 사용되지만 변경하지 않습니다.
actor
현재 New Relic 사용자를 지정합니다.
account(id: 123456)
데이터를 검색 할 New Relic 계정의 ID를 지정합니다.
eventsToMetrics
이벤트-메트릭, 로그-메트릭 또는 스팬-메트릭 규칙에 대해서만 데이터 범위를 지정합니다.
allRules
해당 계정에 대한 모든 규칙을 반환합니다.
rules
rules
블록에서 반환할 데이터를 정의할 수 있습니다. 사용 가능한 필드는 다음과 같습니다.
id
name
description
nrql
accountId
enabled
Example response:
"description" : "Metric for total time" ,
"nrql" : "select summary(totalTime) as 'server.totalTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
"description" : "Metric for duration" ,
"nrql" : "select summary(duration) as 'server.responseTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
규칙 ID별로 규칙 나열 규칙의 정확한 ID를 알고 있는 경우 특정 규칙을 쿼리할 수 있습니다. 예를 들어, 방금 규칙을 만들었고 이제 검토할 수 있도록 해당 내용을 나열하려고 할 수 있습니다.
Example listing rule 36
for New Relic account 123456
:
rulesById ( ruleIds : "36" ) {
이 쿼리의 요소에 대한 자세한 내용은 모든 규칙 나열 을 참조하십시오.
Example response:
"description" : "Metric for total time" ,
"nrql" : "select summary(totalTime) as 'server.totalTime' from Transaction where appName = 'Data Points Staging' facet name, appName, host"
GraphiQL 도구인 NerdGraph API 탐색기를 사용하여 데이터 구조를 탐색할 수 있습니다. 또한 이를 사용하여 이벤트, 로그 및 스팬을 메트릭으로 변환하는 작업을 빌드하고 실행할 수 있습니다. 이 도구를 사용하려면:
필수 매개변수를 사용하여 측정항목 작업의 요청을 생성합니다. one.newrelic.com > All capabilities > Apps > NerdGraph API explorer 으로 이동하여 쿼리를 상자에 붙여넣습니다.작업을 실행하려면 빨간색 Execute query 버튼을 클릭하세요. 또는 컬 형식을 얻으려면 Tools > Copy as CURL 선택하십시오. 응답 상자에서 응답을 확인합니다. 선택 사항: 규칙 생성 작업이 성공적으로 수행되었는지 확인하려면 해당 규칙 ID에 대한 목록 쿼리를 실행합니다 .