NRQL 경고 조건 생성

NRQL 쿼리를 사용하여 알림 조건을 생성할 수 있습니다. 신호를 정의한 후에는 알림과 심적인 임계값 수준을 세부적으로 정의할 수 있습니다. 이에 따라 알림 인시던트가 생성되는 시기가 결정됩니다.

이 작업을 수행하는 방법에 대해 자세히 알아보려면 계속 읽으십시오.

시작할 준비가 되셨습니까? 아직 가입하지 않았다면 New Relic 계정 에 가입하십시오. 영원히 무료입니다.

NRQL 경고 조건 생성

정책에 대한 NRQL 경고 조건을 생성하려면:

1. one.newrelic.com > All capabilities > Alerts & AI > Alert conditions (policies)

   으)로 이동합니다.

2. 기존 정책을 선택하거나

   New alert policy

   클릭하여 새 정책을 만듭니다.

3. Add a condition

   을(를) 클릭합니다.

4. 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분이지만 필요에 맞게 기간을 변경할 수 있습니다. 집계 기간이 무엇이든 New Relic은 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 대 0 값이 반환됨

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

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

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

자세한 내용은 0 대 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

  로 전환 또는 그 반대로 전환)

• Add lost signal threshold

  설정.

경고 조건 유형

NRQL 경고를 생성할 때 다양한 유형의 조건 중에서 선택할 수 있습니다.

신호 손실 임계값 설정

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

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

Loss of signal settings:

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

• Signal loss expiration time

  • UI 라벨:

    Signal is lost after:

  • GraphQL 노드: 만료 .expirationDuration

  • 만료 기간은 스트리밍 경고 파이프라인에서 데이터 포인트를 수신할 때 시작되고 재설정되는 타이머입니다. '만료 시간'이 만료되기 전에 다른 데이터 포인트를 받지 못하면 해당 신호가 손실된 것으로 간주합니다. 이는 데이터가 New Relic으로 전송되지 않거나 NRQL 쿼리의 WHERE 절이 경고 파이프라인으로 스트리밍되기 전에 해당 데이터를 필터링하기 때문일 수 있습니다. 패싯 쿼리가 있는 경우 각 패싯은 신호입니다. 따라서 이러한 신호 중 하나가 지정된 기간 동안 종료되면 신호 손실로 간주됩니다.

  • 신호 만료 시간의 손실은 임계값 지속 시간과 무관하며 타이머가 만료되는 즉시 트리거됩니다.

  • 최대 만료 기간은 48시간입니다. 이는 간헐적 작업의 실행을 모니터링할 때 유용합니다. 최소 시간은 30초이지만 최소 3-5분 사용을 권장합니다.

• Loss of signal actions

  신호가 손실된 것으로 간주되면 진행 중인 인시던트를 닫거나 새 인시던트를 열거나 두 가지 모두를 수행할 수 있습니다.

  • 현재 열려 있는 모든 인시던트 닫기: 특정 신호와 관련된 모든 열려 있는 인시던트를 닫습니다. 조건에 대한 모든 인시던트를 반드시 닫지는 않습니다. 일시적인 서비스 또는 산발적인 신호에 대해 알림을 하는 경우 인시던트가 제대로 닫히도록 이 조치를 선택하는 것이 좋습니다. 이에 대한 GraphQL 노드 이름은 ‘closeViolationsOnExpiration’입니다.
  • Open new incidents: 신호가 손실된 것으로 간주되면 새 인시던트를 엽니다. 이러한 인시던트는 신호 손실로 야기된 것이라고 표시됩니다. 인시던트 기본 설정에 따라 알림이 트리거됩니다. 이에 대한 GraphQL 노드 이름은 ‘openViolationOnExpiration’입니다.
  • 두 조치를 모두 활성화하면 먼저 열려 있는 모든 인시던트를 닫은 다음 신호 손실에 대한 새 인시던트를 열어야 합니다.

UI에서 신호 손실 감지로 구성된 NRQL 경고를 생성하려면:

1. 정책의 경우 조건을 생성할 때

   Select a product

   아래에서

   NRQL

   클릭한 다음

   Next, define thresholds

   클릭합니다.

2. 경고하려는 값을 반환하는 NRQL 쿼리 를 작성하십시오.

3. Threshold type

   의 경우

   Static

   또는

   Anomaly

   선택합니다.

4. + Add lost signal threshold

   클릭한 다음

   Signal is lost after

   필드에 신호 만료 기간을 분 또는 초 단위로 설정합니다.

5. 신호가 손실되었을 때 수행할 작업을 선택하세요.

   Close all current open incidents

   및

   Open new "lost signal" incident

   중 하나 또는 둘 다를 확인할 수 있습니다. 이는 해당 조건에 대해 신호 손실을 처리하는 방법을 제어합니다.

6. 저장하기 전에 조건의 이름을 지정했는지 확인하십시오.

다음과 같은 경우 신호 손실이 닫히면 인시던트가 열립니다.

• 신호가 되돌아 온 경우. 새로 열린 신호 손실 인시던트는 새 데이터가 평가되는 즉시 닫힙니다.

• 그들이 속한 조건이 만료됩니다. 기본적으로 조건은 3일 후에 만료됩니다.

• Close all current open incidents

  옵션을 사용하여 인시던트를 수동으로 종료합니다.

고급 신호 설정

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

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

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

집계 기간

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

슬라이딩 윈도우 집계

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

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

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

스트리밍 방식

세 가지 스트리밍 집계 방법 중에서 선택하여 조건에 대한 최상의 평가 결과를 얻으십시오.

지연/타이머

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

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

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

데이터 공백 채우기

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

• None

  : (기본값) 빈 집계 창에 대해 어떤 작업도 수행하지 않으려면 이를 선택합니다. 평가 시 빈 집계 창은 레버 값, 지속 기간 타이머를 재설정합니다. 예를 들어, 모든 집계 창에는 5분 동안의 레버 값보다 높은 데이터 포인트가 있어야 한다는 조건이 있고 5개의 집계 창 중 1개가 비어 있는 경우 조건은 인시던트를 열지 않습니다.

• Custom static value

  : 평가되기 전에 빈 집계 창에 맞춤 정적 값을 삽입하려면 이 옵션을 선택하세요. 이 옵션에는 사용해야 하는 정적 값을 지정하는 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 이에 API 대해 권장되는 이지만 REST API 사용하는 경우

  "signal"

  공지 NRQL 조건 의 API 섹션 아래 REST 탐색기에서 이 설정을 찾을 수 있습니다.