NRQL 알람 조건 생성

NRQL 쿼리를 사용하여 알림 조건을 생성할 수 있습니다. 신호를 정의한 후에는 알림 및 위험의 임계값 수준을 추가로 정의할 수 있습니다. 이는 알림 위반이 생성되는 시기를 결정합니다.

이 작업을 수행하는 자세한 방법은 다음과 같습니다.

시작할 준비가 되셨습니까? 계정이 없으시면, 지금 뉴렐릭의 영구 무료 계정을 신청하십시오.

NRQL 알람 조건 생성

정책에 대한 NRQL 알람 조건을 생성하려면:

• one.newrelic.com의 헤더에서 Alerts & AI를 클릭한 다음 왼쪽 사이드바에서 Alert conditions (Policies)를 클릭합니다.
• 기존 정책을 선택하거나 New alert policy를 클릭하여 새 정책을 만듭니다.
• Add a condition을 클릭합니다.
• Select a product에서 NRQL을 클릭한 후, Next, define thresholds를 클릭합니다.

기존 조건을 편집하면 평가가 재설정될 수 있습니다.

차트에서 조건 만들기

차트를 사용하여 NRQL 알람 조건을 생성할 수 있습니다.

조건의 이름을 지정하고 맞춤화한 후에는 기존 정책에 추가하거나 새 정책을 생성할 수 있습니다.

NRQL 알람 구문

다음은 모든 NRQL 알람 조건을 생성하기 위한 기본 구문입니다.

SELECT function(attribute)
    FROM Event
    WHERE attribute [comparison] [AND|OR ...]

호환되지 않는 NRQL 포맷

차트에 사용된 NRQL의 일부 요소는 알림 스트리밍 컨텍스트에서 의미가 없습니다. 동일한 효과를 얻기 위해 NRQL 알림 쿼리를 다시 포맷하기 위한 제안과 가장 일반적인 호환되지 않는 요소의 목록은 다음과 같습니다.

SELECT percentile(largestContentfulPaint, 75) FROM PageViewTiming WHERE (appId = 837807) SINCE yesterday

SELECT count(foo), average(bar), max(baz) from Transaction

SELECT count(foo) from Transaction

SELECT average(bar) from Transaction

SELECT max(baz) from Transaction

NRQL 알람 임계값 예

다음은 NRQL 조건에 대한 몇 가지 일반적인 사용 사례입니다. 이러한 쿼리는 정적 및 기준 조건 유형에 대해 작동합니다.

SELECT average(duration) FROM Transaction WHERE account_id in (91290, 102021, 20230)

SELECT percentile(duration, 95) FROM Transaction WHERE name LIKE 'Controller/checkout/%'

SELECT percentile(duration, 95) FROM Transaction

SELECT percentile(databaseDuration, 75) FROM Transaction

SELECT max(duration) FROM Transaction

SELECT average(duration) FROM Transaction

SELECT percentage(count(*), WHERE duration > 2) FROM Transaction

SELECT percentage(count(*), WHERE http.statusCode = '500') FROM Transaction

SELECT apdex(duration, t:0.5) FROM Transaction WHERE appName like '%prod%'

NRQL 조건 및 쿼리 작업 순서

기본적으로 집계 기간은 1분이지만 필요에 맞게 기간을 변경할 수 있습니다. 집계 기간이 무엇이든 뉴렐릭은 NRQL 조건 쿼리의 기능을 사용하여 해당 기간에 대한 데이터를 수집합니다. 쿼리는 다음 순서로 시스템에서 구문 분석되고 실행됩니다.

1. FROM 조항 – 캡처해야 하는 이벤트 유형은 무엇인가?
2. WHERE 조항 – 무엇을 필터링할 수 있는가?
3. SELECT 조항 – 이제 필터링된 데이터 세트에서 어떤 정보를 반환해야 합니까?

예: null 값이 반환됨

이것이 알람 조건 쿼리라고 가정해 보겠습니다.

SELECT count(*) FROM SyntheticCheck WHERE monitorName = 'My Cool Monitor' AND result = 'FAILURE'

집계 창에 오류가 없는 경우:

1. 시스템은 계정에서 모든 SyntheticCheck 이벤트를 가져와서 FROM 조항을 실행합니다.
2. 그런 다음 WHERE 조항을 실행하여 지정된 모니터 이름 및 결과와 일치하는 이벤트만 찾아 해당 이벤트를 필터링합니다.
3. FROM 및 WHERE 작업을 완료한 후에도 스캔할 이벤트가 남아 있으면 SELECT 절이 실행됩니다. 남은 이벤트가 없으면 SELECT 절이 실행되지 않습니다.

즉, count() 및 uniqueCount() 같은 집계자는 0 값을 반환하지 않습니다. 개수가 0이면 SELECT 조항이 무시되고 데이터가 반환되지 않으므로 NULL 값이 반환됩니다.

예: 0 값이 반환됨

합법적인 숫자 0을 제공하는 데이터 원본이 있는 경우 쿼리는 null 값이 아닌 0 값을 반환합니다.

이것이 알림 조건 쿼리이고 MyCoolEvent가 때때로 0 값을 반환할 수 있는 속성이라고 가정해 보겠습니다.

SELECT average(MyCoolAttribute) FROM MyCoolEvent

평가 중인 집계 창에 MyCoolEvent 인스턴스가 하나 이상 있고 해당 창의 모든 MyCoolAttribute 속성 평균 값이 0이면 0 값이 반환됩니다. 해당 분 동안 MyCoolEvent 이벤트가 없으면 작업 순서로 인해 NULL이 반환됩니다.

예: null vs. 0 값이 반환됨

null 값을 처리하는 방법을 결정하려면 경고 조건 UI에서 신호 손실 및 간격 채우기 설정을 조정합니다.

쿼리 작업 순서 바로 가기를 사용하여 NULL 값을 완전히 피할 수 있습니다. 이렇게 하려면 filter 하위 절을 사용한 다음 해당 하위 절 내에 모든 필터 요소를 포함합니다. 쿼리의 본문은 실행되고 데이터를 반환하며, 이때 SELECT 절이 실행되어 필터 요소를 적용합니다. 필터 요소에서 일치하는 데이터가 없는 경우 쿼리는 0 값을 반환합니다. 다음은 예입니다.

SELECT filter(count(*), WHERE result = 'SUCCESS' AND monitorName = 'My Favorite Monitor') FROM SyntheticCheck

자세한 내용은 0 vs. null 값 문제 해결에 대한 블로그 게시물을 확인하십시오.

중첩 집계 NRQL 알람

중첩 집계 쿼리는 데이터를 쿼리하는 강력한 방법입니다. 그러나 주의해야 할 몇 가지 제한 사항이 있습니다.

SELECT max(cpu) FROM (FROM SystemSample SELECT min(cpuPercent) as 'cpu' FACET hostname) ​​​​​

SELECT max(cpu) FROM (FROM Event SELECT min(cpuTime) as cpu TIMESERIES 30 seconds)​​

NRQL 조건 생성 팁

다음은 NRQL 조건을 만들고 사용하기 위한 몇 가지 팁입니다.

조건에 대한 태그 관리

기존 NRQL 조건을 편집할 때 조건 엔터티와 연결된 태그를 추가하거나 제거하는 옵션이 있습니다. 이를 위해서는 조건 이름 아래에 있는 Manage tags 버튼을 클릭합니다. 팝업 메뉴에서 태그를 추가하거나 삭제합니다.

조건 편집은 조건 평가를 재설정할 수 있습니다.

NRQL 알람 조건을 특정 방식으로 편집하면(아래에 자세히 설명됨) 해당 평가가 재설정됩니다. 즉, 해당 지점까지의 모든 평가가 손실되고 해당 지점부터 평가가 다시 시작됩니다. 이것이 영향을 미치는 두 가지 방법은 다음과 같습니다.

• "최소 x분 동안" 임계값의 경우: 평가 기간이 재설정되었기 때문에 위반이 보고될 수 있기 전에 최소 x분의 지연이 있습니다.
• 기준 조건의 경우: 조건이 다시 시작되고 모든 기준 학습이 손실됩니다.

다음 작업은 NRQL 조건에 대한 평가 재설정을 유발합니다.

• 쿼리 변경
• 집계 창, 집계 방법 또는 집계 지연/타이머 설정 변경
• "신호 손실 시 위반 닫기" 설정 변경
• 간격 채우기 설정 변경
• 기준선 방향 변경(해당되는 경우) – 더 높음, 더 낮음, 더 높거나 낮음
• 임계값, 임계값 창 또는 임계값 연산자 변경
• 슬라이드 바이 간격 변경( 슬라이딩 창 집계 조건에서만)

다음 작업(위 목록에서 다루지 않은 다른 작업과 함께)은 평가를 재설정하지 않습니다.

• 신호 손실 기간 변경(만료 기간)
• 시간 기능 변경 ("for at least(최소)"에서 "at least once in(동안 최소 한 번)"으로 또는 그 반대로 전환)
• "신호 손실 시 개방 위반" 설정 토글

경고 조건 유형

NRQL 알림을 생성할 때 다양한 유형의 조건 중에서 선택할 수 있습니다.

신호 손실 임계값 설정

신호 손실은 특정 기간 동안 NRQL 조건과 일치하는 데이터가 없을 때 발생합니다. 신호 손실 임계값 지속 시간과 임계값을 초과할 때 발생하는 작업을 설정할 수 있습니다.

GraphQL API(권장) 또는 REST API를 사용하여 이러한 설정을 관리할 수도 있습니다. 특정 GraphQL API 예시를 보려면 여기로 이동하십시오.

신호 손실 설정:

신호 손실 설정에는 지속 시간과 두 가지 가능한 조치가 포함됩니다.

• 신호 손실 만료 시간

  • UI 레이블: Signal is lost after:
  • GraphQL 노드: expiration.expirationDuration
  • 만료 기간은 스트리밍 경고 파이프라인에서 데이터 포인트를 수신할 때 시작되고 재설정되는 타이머입니다. '만료 시간'이 만료되기 전에 다른 데이터 포인트를 받지 못하면 해당 신호가 손실된 것으로 간주합니다. 이는 데이터가 뉴렐릭으로 전송되지 않거나 NRQL 쿼리의 WHERE 절이 경고 파이프라인으로 스트리밍되기 전에 해당 데이터를 필터링하기 때문일 수 있습니다. 패싯 쿼리가 있는 경우 각 패싯은 신호입니다. 따라서 이러한 신호 중 하나가 지정된 기간 동안 종료되면 신호 손실로 간주됩니다.
  • 신호 손실 만료 시간은 임계값 지속 시간과는 무관하며 타이머가 만료되는 즉시 트리거됩니다.
  • 최대 만료 기간은 48시간입니다. 이는 간헐적 작업의 실행을 모니터링할 때 유용합니다. 최소 시간은 30초이지만 최소 3-5분을 사용하는 것을 권장합니다.

• 신호 손실 조치 신호가 손실된 것으로 간주되면 열린 위반을 닫거나, 새 위반을 열거나, 둘을 모두 수행할 수 있습니다.

  • 현재 열려 있는 모든 위반 닫기: 특정 신호와 관련된 모든 열려 있는 위반을 닫습니다. 조건에 대한 모든 위반을 반드시 닫는 것은 아닙니다. 임시 서비스 또는 산발적인 신호에 대해 경고하는 경우 위반이 제대로 종료되도록 이 작업을 선택하는 것이 좋습니다. 이에 대한 GraphQL 노드 이름은 "closeViolationsOnExpiration "입니다.
  • 새 위반 열기: 신호가 손실된 것으로 간주될 때 새 위반이 열립니다. 이러한 위반은 신호 손실로 인한 것임을 나타냅니다. 인시던트 기본 설정에 따라 알림을 트리거해야 합니다. 이에 대한 graphQL 노드 이름은 "openViolationOnExpiration"입니다.
  • 두 작업을 모두 활성화하면, 먼저 모든 열린 위반이 닫힌 다음 신호 손실에 대한 새 위반이 열립니다.

UI에서 신호 손실 감지로 구성된 NRQL 알람을 생성하려면:

1. 정책의 경우 조건을 생성할 때 Select a product에서 NRQL을 클릭한 후, Next, define thresholds를 클릭합니다.
2. 알람을 생성하려는 값을 반환하는 NRQL 쿼리를 작성합니다.
3. 임계값 유형으로 Static(정적) 또는 Baseline(기준)을 선택합니다.
4. + Add lost signal threshold를 클릭한 다음 Signal is lost after 필드에서 신호 만료 기간을 분 또는 초 단위로 설정합니다.
5. 신호가 손실되었을 때 어떤 일이 일어나길 원하는지 선택합니다. Close all current open violations 및 Open new "lost signal" violation 중 하나 또는 둘 다를 확인할 수 있습니다. 이는 특정 조건에서 신호 위반 손실을 처리하는 방법을 제어합니다.
6. 저장하기 전에 조건의 이름을 지정했는지 확인합니다.

다음 경우 신호 손실이 닫혀 위반이 열립니다.

• 신호가 돌아옵니다, 새로 열린 신호 손실 위반은 새 데이터가 평가되면 즉시 닫힙니다.
• 그들이 속한 조건이 만료됩니다. 기본적으로 조건은 3일 후에 만료됩니다.
• 현재 열려 있는 모든 위반 닫기 옵션을 사용하여 위반을 수동으로 닫습니다.

고급 신호 설정

NRQL 조건을 생성할 때 몇 가지 고급 신호 설정을 사용할 수 있습니다.

• 집계 기간
• 슬라이딩 창 집계
• 스트리밍 방식
• 지연/타이머
• 데이터 공백 채우기

이러한 설정이 무엇이며 서로 어떻게 관련되는지에 대한 자세한 설명은 스트리밍 알림 개념을 참조하십시오. 다음은 구성 방법에 대한 지침과 팁입니다.

집계 기간

집계 창 기간을 설정하여 데이터가 집계되기 전에 스트리밍 시간 창에서 데이터가 누적되는 기간을 선택할 수 있습니다. 30초에서 120분 사이로 설정할 수 있습니다. 기본값은 1분입니다.

슬라이딩 창 집계

슬라이딩 창을 사용하여 더 매끄러운 차트를 만들 수 있습니다. 이 작업은 겹치는 데이터 창을 만들어 수행됩니다.

이 짧은 비디오(2분 30분)에서 슬라이딩 창을 설정하는 방법을 알아보십시오.

활성화되면 "간격별 슬라이드"를 설정하여 집계된 창의 중첩 시간을 제어합니다. 간격은 집계 창보다 짧아야 하며 균등하게 분할되어야 합니다.

스트리밍 방식

세 가지 스트리밍 집계 방법 중에서 선택하여 각 조건에 대한 최상의 평가 결과를 얻을 수 있습니다.

지연/타이머

지연/타이머를 조정하여 스트리밍 알림 알고리즘을 데이터 동작과 조정할 수 있습니다. 데이터가 희박하거나 일관성이 없는 경우, 이벤트 타이머 집계 방법을 사용할 수 있습니다.

케이던스 방법의 경우 지원되는 총 레이턴시는 집계 창 지속 시간과 지연 시간의 합계입니다.

데이터 유형이 APM 언어 에이전트에서 제공되고 많은 앱 인스턴스(예: Transactions, TransactionErrors 등)에서 집계되는 경우 기본 설정으로 이벤트 흐름 메서드를 사용하는 것이 좋습니다.

데이터 공백 채우기

공백 채우기를 사용하면 신호에 데이터가 없을 때 사용할 값을 사용자 지정할 수 있습니다. 다음 설정 중 하나로 데이터 스트림의 공백을 채울 수 있습니다.

• None(없음): (기본값) 빈 집계 창에서 작업을 수행하지 않으려면 이 옵션을 선택합니다. 평가 시 빈 집계 창은 임계값 지속 시간 타이머를 재설정합니다. 예를 들어 조건에 모든 집계 기간이 5분 동안 임계값을 초과하는 데이터 포인트가 있어야 하고, 5개 집계 기간 중 1개가 비어 있으면 조건이 위반되지 않습니다.
• 커스텀 정적 값: 커스텀 정적 값이 평가되기 전에 빈 집계 창에 삽입하려면 이 옵션을 선택합니다. 이 옵션에는 사용해야 하는 정적 값을 지정하는 추가 필수 매개변수 fillValue (API에서 명명)이 있습니다. 기본값은 0입니다.
• Last known value(마지막으로 알려진 값): 이 옵션은 평가가 발생하기 전에 마지막으로 본 값을 삽입합니다. 마지막으로 본 값의 상태를 2시간 동안 유지합니다.

데이터 간격 설정 편집 옵션:

• NRQL 조건 UI에서 Condition settings > Advanced signal settings > fill data gaps with로 이동하고 옵션을 선택합니다.
• Nerdgraph API(선호)를 사용하는 경우 이 노드는 다음 위치에 있습니다. actor : account : alerts : nrqlCondition : signal : fillOption | fillValue
• NerdGraph는 이에 대한 권장 API이지만 REST API를 사용하는 경우, REST API 탐색기에서 Alert NRQL conditions API의 "signal" 섹션 아래에서 이 설정을 찾을 수 있습니다.