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

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

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

문제 신고

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

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

NerdGraph를 사용한 쿼리 개요

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

요구 사항

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 쿼리 에 사용할 제안 속성을 반환할 수 있습니다.

장기 실행 쿼리

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

기타 쿼리 옵션

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

Copyright © 2024 New Relic Inc.

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