• 로그인지금 시작하세요

뉴렐릭의 쿼리 언어 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 사용을 시작하는 한 가지 방법은 차트의 쿼리를 보고 편집하여 나만의 맞춤 차트를 만드는 것입니다.

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

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

one.newrelic.com > Query your data : 플랫폼 UI에서 NRQL 쿼리를 실행할 수 있습니다. 이 NRQL 쿼리는 엔터티 이름으로 패싯된 분산 추적 스팬의 수를 보여줍니다.

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

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

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

모니터링되는 엔터티 간의 관계와 같은 일부 데이터는 NRQL을 통해 사용할 수 없지만 NerdGraph API를 사용하는 것이 가능합니다.

NRQL 사용 시작

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

특정 데이터 유형에 사용할 수 있는 속성을 보려면 다음을 입력하고

FROM DATA_TYPE SELECT

스페이스바를 누릅니다. 인터페이스는 사용 가능한 속성을 제안합니다. 예를 들어:

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

FROM Transaction SELECT keyset()

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

NRQL로 작성된 차트에는 쿼리 보기가 옵션으로 제공됩니다. 그런 다음 해당 쿼리를 편집하고 맞춤화하여 변경 사항이 시각화에 어떤 영향을 미치는지 확인할 수 있습니다.

중요

NRQL을 사용하지 않고 데이터를 탐색하려면 데이터 탐색기를 사용합니다. Jar 수집기의 데이터 쿼리에 대해 자세히 알아보십시오.

NRQL 쿼리 예

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

FROM Transaction SELECT average(duration)
FACET appName TIMESERIES auto

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

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

더 많은 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]

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

NRQL 조건

세부사항

필수 값

SELECT 문과 FROM 조항이 필요합니다. 다른 모든 조항은 선택 사항입니다. SELECT 또는 FROM으로 쿼리를 시작할 수 있습니다.

쿼리 문자열 크기

쿼리 문자열은 4KB 미만이어야 합니다.

대소문자 구분

  • 데이터 유형 이름과 속성 이름은 대소문자를 구분합니다.
  • NRQL 조항함수는 대소문자를 구분하지 않습니다.

문자열 구문

NRQL은 작은따옴표를 사용하여 문자열을 지정합니다. 예:

... where traceId = '030a573f0df02c57'

공백이 있는 속성 이름

공백이 있는 사용자 정의 속성 이름을 인용하려면 역따옴표 ``를 사용합니다. 예:

... FACET `Logged-in user`

데이터 유형 강제

데이터 유형 "강제"를 지원하지 않습니다. 자세한 내용은 데이터 유형 변환을 참조하십시오.

수학 함수의 사용

기본 및 고급 수학 함수SELECT 문에서 지원됩니다.

하위 쿼리

NRQL은 하위 쿼리를 지원합니다.

JOIN 함수

NRQL에는 SQL JOIN 함수에 해당하는 기능이 없지만 커스텀 속성을 사용하여 JOIN을 시뮬레이션할 수 있습니다.

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

Copyright © 2022 New Relic Inc.

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