뉴렐릭의 쿼리 언어 NRQL 소개

뉴렐릭 데이터를 쿼리하는 한 가지 방법은 NRQL(New Relic Query Language)을 사용하는 것입니다. 이 문서는 NRQL이 무엇인지, 언제 어떻게 사용할 수 있는지, 기본 구문 규칙에 대해 설명합니다. 조항 및 함수 목록과 쿼리 예제를 포함하여 쿼리에 대한 자세한 내용은 NRQL 구문, 조항 및 함수를 참조하십시오.

opensource.newrelic.com 사이트에 NRQL Lessons 애플리케이션이 포함되어 있어 자체 데이터를 사용하여 NRQL의 가치와 역량을 빠르게 확인할 수 있습니다. NRQL Lessons 앱을 설치하고 사용하는 방법을 배우려면 이 짧은 YouTube 비디오(약 2분 45초)를 시청하십시오.

시작할 준비가 되셨습니까? 계정이 없으시면, 지금 뉴렐릭의 영구 무료 계정을 신청하십시오.

NRQL이란?

NRQL은 New Relic Query Language의 약자입니다. ANSI SQL과 유사한 쿼리 언어입니다. (구문 참조)NRQL을 사용하여 자세한 뉴렐릭 데이터를 검색하고 애플리케이션, 호스트 및 비즈니스 중요 활동에 대한 인사이트를 얻을 수 있습니다.

NRQL을 사용하는 이유는 다음과 같습니다.

• 문제 해결 또는 비즈니스 분석에 대한 질문에 답하기 위해서 입니다.
• 새 차트를 생성하기 위함입니다.
• 뉴렐릭 데이터의 API 쿼리를 만들기 위해서 입니다. (예: NerdGraph API 사용)

NRQL 쿼리는 raw 테이블 형식의 데이터 행을 가져와 개별 이벤트를 검사하는 것처럼 간단하게 실행할 수 있습니다. NRQL은 엔드유저가 사이트 또는 애플리케이션을 사용하는 방식을 기반으로 퍼널을 만드는 것처럼, 데이터가 표시되기 전에 데이터에 대한 계산을 실행하는 데 사용할 수 있습니다.

NRQL은 아래와 같은 뉴렐릭의 큐레이션된 UI 경험에서 많은 차트와 대시보드를 생성하는 데 사용됩니다.

NRQL은 어디에서 사용할 수 있습니까?

다음 장소에서 NRQL을 사용할 수 있습니다.

• 뉴렐릭 쿼리 빌더
• NerdGraph: NRQL 쿼리를 만들기 위한 옵션이 포함된 뉴렐릭의 GraphQL 형식 API

NRQL은 뉴렐릭 데이터를 쿼리하는 여러 방법 중 하나입니다. 모든 쿼리 옵션에 대한 자세한 내용은 데이터 쿼리를 참조하십시오.

NRQL로 어떤 데이터를 쿼리할 수 있습니까?

NRQL을 사용하면 다음과 같은 뉴렐릭 데이터 유형을 쿼리할 수 있습니다.

• 모든 뉴렐릭 제품의 이벤트 데이터 예:

  • APM 이벤트, Transaction
  • 브라우저 모니터링 이벤트, PageView
  • 모바일 모니터링 이벤트, Mobile
  • 인프라 이벤트, ProcessSample
  • 신세틱 이벤트, 예를 들어 SyntheticCheck
  • Event API로 보고된 것과 같은 커스텀 이벤트

• 메트릭 타임슬라이스 데이터 (APM, 브라우저 및 모바일에서 보고하는 메트릭)

• Metric 데이터 유형 (메트릭 API에서 보고하는 측정항목 및 해당 API를 사용하는 데이터 소스)

• Span 데이터 유형 (분산 추적 데이터)

• Log 데이터 유형 (뉴렐릭의 로그 관리 기능에서 가져온 데이터)

NRQL 사용 시작

NRQL 사용을 시작하고 사용 가능한 데이터를 이해하는 한 가지 방법은 NRQL 인터페이스(예: 쿼리 작성기)로 이동하여 FROM 을 입력하고 스페이스바를 누르는 것입니다. 인터페이스는 사용 가능한 데이터 유형을 제안합니다.

특정 데이터 유형에 사용할 수 있는 속성을 보려면 FROM <var>DATA_TYPE</var> SELECT를 입력하고 스페이스바를 누릅니다. 인터페이스는 사용 가능한 속성을 제안합니다. 예:

모든 속성을 포함하여 데이터 유형과 연결된 전체 JSON을 보려면 keyset() 속성을 사용합니다. 예를 들어:

FROM Transaction SELECT keyset()

NRQL은 배후에서 일부 뉴렐릭 차트 및 대시보드를 구축하는 데 사용됩니다. NRQL을 배우는 한 가지 방법은 이러한 NRQL 생성 차트 중 하나를 찾고 NRQL을 사용하여 새로운 맞춤화된 쿼리 및 차트를 만드는 것입니다.

NRQL 쿼리 예

다음은 APM 에서 보고하는 Transaction 데이터의 NRQL 쿼리 예입니다.

FROM Transaction SELECT average(duration) 
  FACET appName TIMESERIES auto

그러면 다음과 같은 차트가 생성됩니다.

쿼리의 몇 가지 예는 다음과 같습니다.

SELECT uniqueCount(user) FROM PageView 
  WHERE userAgentOS = 'Mac' 
  FACET countryCode
  SINCE 1 day ago 
  LIMIT 20

SELECT count(*)
 FROM Transaction
 FACET `Logged-in user`

SELECT count(*) FROM Transaction, PageView SINCE 3 days ago

SELECT function(attribute), function(attribute) ...
  FROM ...

SELECT min(duration), max(duration), average(duration)
  FROM PageView SINCE 1 week ago

더 많은 NRQL 쿼리 예제를 참조하십시오.

NRQL 구문

NRQL 쿼리의 구문은 표준 SQL 쿼리와 유사합니다. 다음은 NRQL 쿼리의 구조를 분석한 것입니다.

SELECT function(attribute) [AS 'label'][, ...] 
  FROM data type
  [WHERE attribute [comparison] [AND|OR ...]][AS 'label'][, ...]
  [FACET attribute | function(attribute)]
  [LIMIT number]
  [SINCE time]
  [UNTIL time]
  [WITH TIMEZONE timezone]
  [COMPARE WITH time]
  [TIMESERIES time]

기본 규칙은 다음과 같습니다.

... where traceId = '030a573f0df02c57'

... FACET `Logged-in user`

NRQL 구문 및 함수에 대해 자세히 알아보십시오.