뉴렐릭 쿼리 언어(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를 클릭합니다.
NerdGraph API와 함께 NRQL을 사용할 수도 있습니다. 이를 통해 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 참조 (전체 구문, 절 및 함수)