다른 데이터 유형에서 메트릭 만들기

New Relic의 메트릭 API 서비스 를 사용하여 이벤트, 로그 또는 스팬과 같은 다른 유형의 데이터에서 메트릭 을 생성하기 위한 규칙을 정의하십시오. 권장 사항: 시작하기 전에 규칙 생성을 위한 요구 사항 및 팁을 검토하세요.

측정항목 규칙 만들기

이벤트, 로그 또는 범위에서 메트릭을 생성하기 위한 규칙을 생성하려면:

1. NRQL을 사용하여 메트릭 규칙을 구성 합니다.
2. NRQL 규칙이 포함 된 NerdGraph(GraphQL 형식) API 요청 을 구성합니다.
3. API 요청을 통해 측정항목을 생성합니다 .

메트릭이 생성되면 NRQL을 사용하여 쿼리하고 차트로 작성할 수 있습니다.

1단계. NRQL 쿼리 규칙 만들기

메트릭 규칙 생성 의 가장 중요한 부분은 이벤트, 로그 또는 범위의 데이터에 대한 메트릭을 정의하는 NRQL 쿼리를 구성하는 것입니다. 다음 절차에 따라 단일 NRQL 쿼리로 최대 10개의 메트릭을 생성할 수 있습니다.

1. New Relic의 NRQL 인터페이스 를 사용하여 생성하려는 메트릭에 대한 쿼리를 구성합니다. 예를 들어:

   FROM ProcessSample SELECT average(ioTotalReadBytes)
   WHERE nr.entityType = 'HOST'

   카피

   중요

   측정항목 규칙에 대한 이벤트는 NRQL 쿼리 에서 WITH ... AS 절을 지원하지 않습니다.

2. 사용 가능한 세 가지 측정항목 유형 중 하나를 사용하도록 쿼리를 편집합니다.

   • summary: 쿼리의 함수가 min , max , sum , count 또는 average 인 경우 사용합니다.

   • uniqueCount: 쿼리의 기능이 uniqueCount 인 경우 사용합니다.

   • distribution: 쿼리의 함수가 percentile 또는 histogram 인 경우 사용합니다.

     이 예제 쿼리는 average 을 사용하므로 summary 을 사용합니다.

     FROM ProcessSample SELECT summary(ioTotalReadBytes) 
     WHERE nr.entityType = 'HOST'

     카피

     이 예제 쿼리는 숫자가 아닌 필드에서 count 를 사용합니다.

     FROM ProcessSample SELECT count(hostname) 
     WHERE hostname LIKE '%prod%'

     카피

     숫자가 아닌 필드의 summary 에 대해 summary(1) 사용:

     FROM ProcessSample SELECT summary(1) 
     WHERE hostname LIKE '%prod%'

     카피

     팁

     규칙에서 이러한 측정항목 유형을 사용하는 방법에 대한 자세한 내용은 측정항목 규칙 만들기: 요구사항 및 팁 을 참조하세요.

3. 고유한 메트릭 이름/속성-값 조합의 카디널리티 제한에 따라 메트릭에 연결할 속성을 결정합니다.

   권장 사항: 별도의 쿼리를 실행하여 30초 동안 최대 카디널리티가 50,000을 넘지 않도록 합니다. 예를 들어 다음 쿼리는 awsRegion , awsAvailabilityZone 및 commandName 속성을 포함할 때 ProcessSample 이벤트에 대해 지난 3시간 동안 30초 동안 발생한 최대 카디널리티를 찾습니다.

   FROM (FROM ProcessSample
    SELECT rate(uniqueCount(awsRegion, awsAvailabilityZone, commandName), 30 seconds) AS 'cardinalityRate'
    WHERE nr.entityType = 'HOST' TIMESERIES 30 seconds) SELECT max(cardinalityRate) AS 'maxCardinalityRate' SINCE 3 hours AGO

   카피

4. 측정항목을 집계하고 필터링하려면 FACET 절을 사용하여 측정항목에 연결할 속성을 추가하세요. 예를 들어:

   FROM ProcessSample
   SELECT summary(ioTotalReadBytes) WHERE nr.entityType = 'HOST' 
   FACET awsRegion, awsAvailabilityZone, commandName

   카피

5. AS 함수를 사용 하여 측정항목의 이름을 설정합니다. 예를 들어:

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

   카피

NRQL 규칙이 완료되면 이를 사용하여 API 요청을 생성합니다 .

2단계. API 요청 생성

이벤트, 로그 또는 범위의 데이터를 메트릭으로 변환하는 NRQL 규칙을 빌드한 후 API 요청 빌드를 계속하십시오. NerdGraph API 도구를 사용 하여 데이터 구조를 탐색하고 구성하고 요청할 수 있습니다.

규칙이 올바르게 생성되었는지 확인하기 위해 쿼리를 실행하여 ID를 사용하여 해당 규칙을 반환 할 수 있습니다. 생성한 메트릭 쿼리에 대한 팁은 메트릭 쿼리 및 차트 작성을 참조하십시오.

mutation {
  eventsToMetricsCreateRule(rules: {
    name: "io.totalread.bytes for computeSample entities",
    description:"Created by Zach on March 27, 2019. Used by team Network.",
    nrql:"FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE nr.entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName",
    accountId: 123456
  })
  {
    successes {
      id
      name
      nrql
      enabled
    }
    failures {
      submitted {
        name
        nrql
        accountId        
      }
      errors {
        reason
        description
      }
    }
  }
}

{
  "data": {
    "eventsToMetricsCreateRule": {
      "failures": [],
      "successes": [
        {
          "enabled": true,
          "id": "46",
          "name": "io.totalread.bytes for computeSample entities",
          "nrql": "FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE nr.entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName"
        }
      ]
    }
  }
}

3단계. API 요청으로 메트릭 규칙 생성

API 요청이 준비되면 NerdGraph API 를 사용하여 메트릭을 생성하도록 요청할 수 있습니다.

측정항목 쿼리 및 차트 작성

이벤트, 로그 또는 범위에 대한 데이터를 변환하는 메트릭 규칙을 생성한 후 New Relic UI에서 새 메트릭 데이터를 볼 수 있습니다. 데이터를 보려면:

1. New Relic의 NRQL 쿼리 인터페이스 로 이동합니다.

2. 다음 쿼리를 실행하여 모든 측정항목의 이름을 확인합니다.

   SELECT uniques(metricName) FROM Metric

   카피

3. 관심 있는 메트릭을 선택한 후 다음 쿼리를 실행하여 사용 가능한 속성을 확인하십시오.

   SELECT * FROM Metric where metricName = 'yourMetric'

   카피

4. 예상 데이터가 표시되지 않으면 문제 해결 절차를 따르세요.

사용 가능한 NRQL 집계 기능 은 생성한 메트릭 유형 에 따라 다릅니다. 여기 몇 가지 예가 있어요.

SELECT count(appStartResponseTime), sum(appStartResponseTime), max(appStartResponseTime), min(appStartResponseTime),  average(appStartResponseTime) FROM Metric

SELECT uniqueCount(playbackErrorStreamUniqueCount) * 100 / uniqueCount(streamUniqueCount) AS '% of Streams Impacted' FROM Metric

SELECT percentile(service.responseTime, 95) FROM Metric

SELECT histogram(service.responseTime, 10, 20) FROM Metric

문제점 해결

NerdGraph 호출이 올바르게 구성되지 않은 경우 다음과 같은 메시지를 받을 수 있습니다.

Cannot parse the unexpected character "\u201C”

NerdGraph 호출의 따옴표가 스마트 따옴표(중괄호)가 아닌지 확인합니다. NerdGraph API는 직선 따옴표만 허용합니다.