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