• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

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

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 , awsAvailabilityZonecommandName 속성을 포함할 때 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를 사용하여 해당 규칙을 반환 할 수 있습니다. 생성한 메트릭 쿼리에 대한 팁은 메트릭 쿼리 및 차트 작성을 참조하십시오.

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 집계 기능 은 생성한 메트릭 유형 에 따라 다릅니다. 여기 몇 가지 예가 있어요.

문제점 해결

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

Cannot parse the unexpected character "\u201C”

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

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.