• English日本語한국어
  • 로그인지금 시작하기

NRQL 참조

좋은 NRQL 쿼리를 작성하려면 뉴렐릭의 다양한 NRQL 절과 함수가 작동하는 방식을 이해하는 것이 도움이 됩니다. 이 문서에는 NRQL 절 및 함수의 정의가 포함되어 있으며 사용 방법에 대한 예시가 제공됩니다.

기본 NRQL 구문 규칙을 찾고 계십니까? NRQL 사용 방법을 참조하십시오. 지침서가 필요하시면 입문 NRQL 튜토리얼을 참조하십시오.

쿼리 구성 요소

기본 NRQL 구문 문서에 명시된 바와 같이 모든 NRQL 쿼리에는 SELECT 절과 FROM 절이 포함되며 다른 모든 절은 선택 사항입니다. 아래의 절 정의에는 예시 NRQL 쿼리도 포함되어 있습니다.

필수 조항

옵션 조항

메트릭 데이터 쿼리

메트릭 데이터는 다른 유형의 데이터보다 복잡합니다. 이를 효과적으로 쿼리하기 위한 몇 가지 팁이 있습니다. 두 가지 유형의 메트릭 데이터가 있으며 각각 고유한 쿼리 지침이 존재합니다.

메트릭 데이터를 보고하는 방법에 대한 자세한 내용은 메트릭 데이터 유형을 참조하십시오.

기능

이 섹션에서는 NRQL 함수, 즉 집계 기능 집계 기능에 대해 설명합니다.

집합기 기능

집계 함수를 사용하여 데이터를 필터링하고 집계할 수 있습니다. 사용을 위한 몇 가지 팁은 다음과 같습니다.

  • 필터 쿼리, Apdex 쿼리백분위수 쿼리에 대한 New Relic University 자습서를 참조하십시오. 또는 NRQL 쿼리 작성에 대한 전체 온라인 과정을 방문하십시오.

  • 동일한 쿼리(예: SELECT median(one_metric), median(another_metric) )에서 집계 함수를 여러 번 사용하는 경우 결과 표시에 문제가 발생할 수 있습니다. 이 문제를 해결하려면 AS 함수를 사용합니다. 예:

    SELECT median(one_metric) as 'med-a', median(another_metric) as 'med-b'
  • 데이터 유형 "강제"는 지원되지 않습니다. 사용 가능한 유형 변환 함수에 대해 알아보십시오.

  • 시간 경과에 따른 결과를 표시하는 방법은 시간 경과에 따른 결과 그룹화를 참조하십시오.

예:

SELECT histogram(duration, 10, 20) FROM PageView SINCE 1 week ago

비 집계 함수

NRQL 쿼리에서 숫자가 아닌 데이터에 대해 비 집계 함수를 사용합니다.

유형 변환

NRQL은 "강제"를 지원하지 않습니다. 즉, 문자열로 저장된 부동 소수점은 문자열로 취급되며 부동 소수점 값을 기대하는 함수에서 작동할 수 없습니다.

다음 함수를 사용하여 숫자 값이 있는 문자열 또는 문자열 값이 있는 부울을 해당 숫자 및 부울 값으로 변환하거나 문자열이 아닌 값을 문자열 값으로 변환할 수 있습니다.

  • numeric() 함수를 사용하여 문자열 형식의 숫자를 숫자 값으로 변환합니다. 이 함수는 쿼리 결과에 수학 함수를 사용하는 쿼리 또는 average() 같은 NRQL 집계 함수에 내장될 수 있습니다.
  • boolean() 함수를 사용하여 "true" 또는 "false"의 문자열 값을 해당 부울 값으로 변환합니다.
  • string() 함수를 사용하여 숫자, 부울, 튜플 또는 배열 값을 문자열 값으로 변환합니다. 보다 자세한 내용은 string() 상단의 설명을 참조하십시오.

코멘트

NRQL 쿼리를 작성할 때 팀 구성원이 쿼리를 더 잘 이해하고 사용하는 데 도움이 될 수 있도록 주석을 추가할 수 있습니다.

구문 세부 정보는 다음과 같습니다.

  • -- 두 개의 대시는 같은 줄에서 이 표시기 오른쪽에 있는 모든 텍스트를 주석 처리합니다.
  • // 두 개의 슬래시는 같은 줄에서 이 표시기 오른쪽에 있는 모든 텍스트를 주석 처리합니다.
  • /* */ 이 문자 집합 사이에 있는 모든 텍스트는 주석 처리됩니다. 이 표시기는 여러 줄에 적용될 수 있습니다.

주석이 모든 곳에 표시되는 것은 아니라는 데 주의하십시오. '최근 쿼리' 및 '쿼리 보기' 같은 일부 뷰에는 주석이 표시되지 않습니다.

주석을 포함하는 몇 가지 쿼리의 예:

FROM Transaction SELECT uniqueCount(appId) -- This will return the number of unique App IDs
FROM TransactionError
SELECT count(*) SINCE 1 day ago // Transaction Error for the past day
FROM TransactionTrace /* This data may be incomplete;
If so, run a query of Transaction */
SELECT count(*)

NRQL 구문 및 규칙에 대한 정보를 제공하는 다른 자료들을 확인해 보십시오.

Copyright © 2024 New Relic Inc.

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