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

뉴렐릭의 지표 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는 직선 따옴표만 허용합니다.