NerdGraph 튜토리얼: NRQL을 사용하여 데이터 쿼리

NerdGraph API를 사용하여 NRQL 쿼리를 만들 수 있습니다.

NerdGraph를 사용한 쿼리 개요

UI의 쿼리 빌더를 사용하여 NRQL 쿼리를 실행하거나 NerdGraph API를 사용할 수 있습니다. NerdGraph는 여러 계정에 대한 쿼리및 비동기 쿼리실행과 같이 UI에서 할 수 없는 몇 가지 작업을 수행할 수 있는 기능을 제공합니다.

요구 사항

• 모든 사용자 유형 은 액세스 권한이 있는 계정에 대한 데이터를 쿼리할 수 있습니다. NerdGraph를 통해 쿼리할 수 없다면 해당 계정에 대한 액세스 권한 이 없기 때문일 수 있습니다.
• 모든 쿼리에는 NRQL 쿼리 제한이적용됩니다.

NerdGraph를 사용한 기본 NRQL 쿼리

NerdGraph를 사용하여 기본 NRQL 쿼리를 만들려면 두 가지 주요 요구 사항이 있습니다.

• NRQL 쿼리를 NRQL 개체에 문자열 인수로 전달해야 합니다.
• 쿼리에 results 필드를 포함해야 합니다.

예를 들어 지난 1시간 동안의 모든 트랜잭션 이벤트 수를 얻으려면 New Relic 계정 ID를지정하여 다음 쿼리를 실행합니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
        results
      }
    }
  }
}

이 쿼리 예제는 다음과 같은 결과를 반환합니다.

{
  "data": {
    "actor": {
      "account": {
        "nrql": {
          "results": [
            {
              "count": 1000
            }
          ]
        }
      }
    }
  }
}

NRQL 쿼리를 작성하는 방법에 대한 세부 정보를 찾고 계십니까? NRQL 문서 섹션을참조하십시오.

교차 계정 쿼리

NerdGraph를 사용하면 쿼리 빌더에서 수행할 수 없는 둘 이상의 계정에서 쿼리를 실행할 수 있습니다. 쿼리하려는 계정의 계정 ID 가 필요합니다.

다음은 교차 계정 NRQL 쿼리를 실행하는 예입니다.

{
  actor {
    nrql(
      accounts: [ACCOUNT_ID_1, ACCOUNT_ID_2, ACCOUNT_ID_3]
      options: {}
      query: "YOUR_NRQL_QUERY"
      timeout: 70
    ) {
      results
    }
  }
}

여러 계정의 데이터로 대시보드를 만드는 방법 은 NerdGraph 대시보드 자습서 를 참조하십시오.

포함 가능한 차트 만들기

원시 데이터를 반환하는 것 외에도 애플리케이션에서 사용할 데이터에 대한 포함 가능한 차트 링크를 가져올 수 있습니다. 예를 들어, 소니 의 단일 개수 대신 시간 경과에 따른 버킷 개수의 시계열을 보여주는 차트를 생성할 수 있습니다. embeddedChartUrl 사용하여 쿼리에 TIMESERIES 추가합니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      nrql(query: "SELECT count(*) from Transaction TIMESERIES") {
        embeddedChartUrl
      }
    }
  }
}

이 NerdGraph 쿼리 예제는 다음 응답으로 차트의 URL을 반환합니다.

{
  "data": {
    "actor": {
      "account": {
        "nrql": {
          "embeddedChartUrl": "https://chart-embed.service.newrelic.com/charts/EMBEDDABLE-CHART-ID"
        }
      }
    }
  }
}

표준 HTTP 클라이언트를 사용하여 포함된 차트 URL을 보는 경우 제출한 쿼리에 대한 응답의 시각화를 보여주는 이미지를 반환합니다. 이러한 차트는 다른 곳에서 생성된 포함된 차트와 동일한 포함된 차트 규칙 을 따릅니다. 데이터 시각화의 스타일을 변경하려면 chartType 인수를 embeddedChartUrl 에 전달합니다.

제안된 측면

NerdGraph를 사용하여 데이터를 탐색할 때 suggestedFacets 필드를 사용하여 패싯 NRQL 쿼리 에 사용할 제안 속성을 반환할 수 있습니다.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      nrql(query: "SELECT count(*) from Transaction TIMESERIES") {
        suggestedFacets {
          attributes
        }
      }
    }
  }
}

{
  "data": {
    "actor": {
      "account": {
        "nrql": {
          "suggestedFacets": [
            {
              "attributes": ["host"]
            }
          ]
        }
      }
    }
  }
}

장기 실행 쿼리

더 오래 실행되는 NRQL 쿼리를 실행해야 하는 경우 비동기 쿼리 를 참조하세요.

기타 쿼리 옵션

NerdGraph는 다음과 같은 다른 쿼리 옵션을 제공합니다.

• 비동기 쿼리
• 과거 데이터 내보내기
• 대시보드 만들기