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

NRQL로 쿼리하는 방법: 쿼리 메커니즘

모든 툴이 그렇듯이 사용하기 전에 사용 방법을 익힐 필요가 있습니다. NRQL을 사용하여 쿼리를 작성하고 구조화하며 작성하는 프로세스가 있습니다. NRQL을 사용한 쿼리 규칙을 이해하면 데이터를 최대한 활용할 수 있습니다. 이전에 쿼리를 해본 적이 없더라도, 규칙에 대한 기본적인 이해만으로도 필요한 모든 데이터에 액세스하고 차트대시보드에서 데이터를 시각화할 수 있습니다.

NRQL 구문

SQL 쿼리에 대해 알고 계시다면, NRQL은 이와 많이 비슷합니다. 다음은 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의 기본 규칙은 다음과 같습니다.

NRQL 조건

세부사항

필수 값

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

쿼리 문자열 크기

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

대소문자 구분

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

문자열 구문

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

... where traceId = '030a573f0df02c57'

비표준 커스텀 이벤트 및 속성 이름

기본적으로 보고되는 이벤트에는 영숫자, 콜론( : ) 및 밑줄( _ )이 포함된 이름이 있습니다. 속성 이름에는 해당 문자와 마침표( . )가 포함될 수 있습니다. 기본적으로 보고되는 이름은 문자로 시작합니다. 이러한 지침을 따르지 않는 커스텀 이름은 NRQL 쿼리에서 백틱 기호(`)로 묶어야 합니다. 예를 들어:

... FACET `Logged-in user`

데이터 유형 강제

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

수학 함수의 사용

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

하위 쿼리

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

코멘트

NRQL 쿼리에 주석을 추가할 수 있습니다. 주석에 대해 자세히 알아보십시오.

이는 NRQL의 기본 규칙이며, 쿼리를 작성하는 데 도움이 되는 더욱 자세한 정보는 NRQL 참조를 확인하시기 바랍니다.

데이터 탐색

NRQL의 사용법을 배우는 가장 좋은 방법 중 하나는 뉴렐릭 쿼리 툴에 액세스하여 데이터를 많이 탐색해보는 것입니다. 다음은 쿼리 빌더와 인터페이스에서 제안된 항목을 사용하여 데이터를 탐색하는 예입니다.

데이터로 다양한 시도를 해보십시오. 쿼리 인터페이스가 잘못되는 일은 없을테니, 익숙해질 때까지 얼마든지 둘러보고 사용해보시기 바랍니다.

쿼리는 FROM 다음에 공백을 넣는 것으로 시작합니다. 인터페이스는 사용 가능한 데이터 유형을 제안하고 해당 목록에서 Transaction을 선택합니다.

다음으로 SELECT를 사용하여 attribute를 선택합니다. 쿼리는 다음과 같은 형태를 하고 있습니다.

FROM Transaction SELECT

스페이스바를 다시 누르면 인터페이스가 사용 가능한 속성을 제안합니다. 아래 예에서는 appId가 선택되었습니다.

결과는 필수 절과 문(FROMSELECT)를 사용하는 매우 기본적인 NRQL 쿼리이며, 아래와 같이 각각에 연관된 트랜잭션과 관련된 appId를 제공합니다.

데이터를 탐색하는 또 다른 좋은 방법은 기존 대시보드로 이동하여 View query를 클릭하고 쿼리 빌더에서 차트를 실행하는 것입니다.

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

NRQL 쿼리 예

다음은 APM에서 보고하는 Transaction 데이터에 대한 좀 더 심도 있는 NRQL 쿼리의 예입니다. 이 쿼리의 경우:

  • Transaction 이 데이터 유형으로 선택되었습니다.
  • Select 가 평균 기간을 결정하는 데 사용되었습니다.
  • Facet을 사용해 결과를 appName별로 그룹화했습니다. Facet
  • Timeseries 는 자동화된 기간 동안 데이터를 표시하는 데 사용됩니다.
FROM Transaction
SELECT average(duration)
FACET appName
TIMESERIES auto

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

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

중요

NRQL을 사용하지 않고 데이터를 탐색하려면 metrics and events 데이터 탐색기를 사용하십시오. 뉴렐릭에서 데이터를 쿼리하는 방법에 대해 자세히 알아보십시오.

자세히 알아볼 준비가 되셨습니까? NRQL 소개를 확인하시거나 NRQL로 차트 및 대시보드를 사용하는 방법을 알아보십시오. NRQL을 바로 사용하려면 NRQL 안내 튜토리얼로 바로 이동하십시오.

Copyright © 2024 New Relic Inc.

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