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

New Relic NerdGraph GraphiQL 탐색기 를 사용하여 NRQL (New Relic Query Language) 쿼리를 만들 수 있습니다. 이러한 쿼리를 구성하고 응답을 확인하는 방법을 배우려면 api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동하십시오. 이 문서에서는 NRQL 쿼리에 사용할 수 있는 몇 가지 기능에 대해 설명합니다.

NerdGraph를 통해 만들어진 NRQL 쿼리는 NRQL 쿼리 속도 제한 이 적용됩니다.

NerdGraph를 사용한 기본 NRQL 쿼리

NerdGraph를 사용하여 NRQL 쿼리를 만들려면:

1. api.newrelic.com/graphiql에서 NerdGraph GraphiQL 탐색기로 이동합니다.
2. NRQL 쿼리를 NRQL 개체에 대한 문자열 인수로 전달하고 NerdGraph 쿼리에 results 필드를 포함합니다.

예를 들어, 지난 1시간 동안의 모든 트랜잭션 이벤트 수를 얻으려면 다음 쿼리를 사용하십시오.

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

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

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

실제 카운트 값은 거래 데이터에 따라 다릅니다. NerdGraph GraphiQL 탐색기를 사용하여 쿼리를 실험해 보십시오.

포함 가능한 차트 만들기

원시 데이터를 반환하는 것 외에도 응용 프로그램에서 사용할 데이터에 대한 포함 가능한 차트 링크를 가져올 수 있습니다. 예를 들어, 단일 트랜잭션 카운트 대신 시간 경과에 따른 버킷 카운트의 시계열을 보여주는 차트 를 생성할 수 있습니다. { 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"]
               ]
            }
         }
      }
   }
}