뉴렐릭 쿼리 언어(NRQL)는 뉴렐릭 데이터를 쿼리하기 위한 언어로 SQL과 유사합니다. 뉴렐릭에 기본 포함된 차트와 대시보드를 구축하는 데도 사용되므로, NRQL로 원하는 뷰와 알림을 구성할 수 있습니다.
다음 비디오는 NRQL을 사용해 대시보드에서 쿼리를 찾고 쿼리 빌더에서 이를 수정하는 방법을 보여 줍니다. 절, 함수 및 예시 쿼리 목록 등 쿼리에 대한 보다 자세한 내용은 NRQL 참조를 확인하십시오.
NRQL로 할 수 있는 작업
NRQL을 사용해 다음을 수행할 수 있습니다
- 시간 경과에 따른 트랜잭션 처리량, 오류율 또는 레이턴시를 보여주는 차트 구축
- 특정 질문에 대한 답변을 찾아 문제 진단 또는 비즈니스 분석
- 관련된 특정 이벤트 및 속성을 쿼리하여 성능 문제 조사
- 메트릭이 임계값을 초과할 때 발생하는 NRQL 기반 알림 설정
- 뉴렐릭 데이터에 대한 API 쿼리 생성(NerdGraph API 사용)
NRQL은 기본 쿼리(이벤트 데이터의 원시 행 가져오기)와 사용자가 사이트 또는 애플리케이션과 상호 작용하는 방식을 기반으로 하는 퍼널과 같은 계산된 결과 모두에 작동합니다.
팁
뉴렐릭 플랫폼의 차트와 대시보드를 구축하는 데 사용되는 쿼리 언어인 NRQL를 사용해 다양한 작업을 수행할 수 있습니다.
쿼리 가능한 데이터 유형
NRQL을 사용하면 다음을 포함하여 거의 모든 유형의 텔레메트리 데이터를 쿼리할 수 있습니다.
모든 뉴렐릭 제품의 이벤트 데이터 예:
- APM 이벤트,
Transaction - 브라우저 모니터링 이벤트,
PageView - 모바일 모니터링 이벤트,
Mobile - 인프라 이벤트,
ProcessSample - 신세틱 이벤트, 예를 들어
SyntheticCheck - Event API로 보고된 것과 같은 커스텀 이벤트
- APM 이벤트,
Metric데이터 유형 (메트릭 API에서 보고하는 측정항목 및 해당 API를 사용하는 데이터 소스)Span데이터 유형 (분산 추적 데이터)Log데이터 유형 (로그 관리 기능의 데이터)
팁
모니터링되는 엔터티 간의 관계와 같은 일부 데이터는 NRQL을 통해 사용할 수 없지만 NerdGraph API를 사용하는 것이 가능합니다.
NRQL 사용 사례
플랫폼 전반에서 NRQL을 사용할 수 있습니다.
NRQL 기반 알림은 뉴렐릭의 주요 알림 유형입니다. 이 알림을 생성하려면 one.newrelic.com > All capabilities > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition으로 이동하여 NRQL을 클릭한 다음 Next, define thresholds를 클릭합니다.
You can also use NRQL with our NerdGraph API. This lets you run asynchronous queries that aren't available in the UI.
NRQL 쿼리 구조
NRQL은 구조화된 절 기반 구문을 따릅니다. 다음은 지난 1시간 동안의 모든 트랜잭션을 계산하는 NRQL 쿼리입니다.
SELECT count(*) FROM Transaction SINCE 1 hour ago사용 가능한 모든 절의 세부 정보는 다음과 같습니다.
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 rule | 세부사항 |
|---|---|
필수 값 |
|
쿼리 문자열 크기 | 쿼리 문자열은 4KB 미만이어야 합니다. |
대소문자 구분 | 데이터 유형 이름과 속성 이름은 대소문자를 구분합니다. NRQL 절 및 함수는 대소문자를 구분하지 않습니다. |
문자열 구문 | NRQL은 작은따옴표를 사용하여 문자열을 지정합니다. 다음 예는 이를 위한 구문입니다. |
비표준 커스텀 이벤트 및 속성 이름 | 기본적으로 보고되는 이벤트에는 영숫자, 콜론( |
데이터 유형 강제 | 데이터 유형 "강제"를 지원하지 않습니다. 자세한 내용은 데이터 유형 변환을 참조하십시오. |
보다 자세한 내용은 쿼리 작성에 도움이 되는 NRQL 참조를 확인하십시오.
다음 단계
- NRQL 작동 방식 (쿼리 실행, 데이터 최신성 및 제한)
- NRQL을 사용한 차트 및 대시보드 (쿼리 결과 시각화)
- NRQL 튜토리얼 (신규 사용자를 위한 실습)
- NRQL 참조 (전체 구문, 절 및 함수)