REST API 엔드포인트 를 사용하면 정책에 대한 조건을 생성할 수 있습니다. 이 용어집에는 조건을 정의하거나 업데이트하는 데 사용할 수 있는 각 필드의 이름과 설명이 포함되어 있습니다.
REST API를 사용하기 전에
REST API 알림을 프로그래밍 방식으로 관리하는 데 더 이상 선호되는 방법이 아닙니다. 자세한 내용은 에 대한 API 소개를 읽어보세요.
필수 및 선택 필드
API에는 4가지 유형의 경고 조건이 포함됩니다.
- APM
- 외부 서비스
- NRQL
- 합성 모니터링
다음과 같은 선택적 필드를 제외하고 특정 조건 유형과 함께 사용되는 모든 필드는 필수입니다.
enabled
(기본값은false
)runbook_url
user_defined
필드 정의
이 용어집에 나열된 모든 필드가 모든 조건 유형에 필요한 것은 아닙니다. 필드를 사용해야 하는 조건 유형은 각 설명에 나열되어 있습니다.
이 필드를 사용하면 조건의 범위를 JVM 인스턴스 또는 전체 애플리케이션으로 지정할 수 있습니다. 다음 문자열 중 하나일 수 있습니다.
사례
애플리케이션
사용:
정황
엔티티 조건
인스턴스 기반 및 JVM 상태 측정항목은
violation_close_timer
도 참조하세요.
이것은 경고 조건의 상태이며 선택 사항입니다. 기본값은 false
입니다.
이 필드는 유지 관리 또는 테스트 기간 동안 조건을 활성화하거나 비활성화하는 데 사용할 수 있습니다.
사용:
- 정황
- 외부 서비스 조건
- NRQL 조건
- 합성 모니터링 조건
이것은 귀하의 조건으로 모니터링될 개체를 식별하는 엔티티 ID의 배열입니다. 애플리케이션 ID, 브라우저 ID, 주요 트랜잭션 ID, 외부 서비스 ID 등이 될 수 있습니다.
둘 이상의 정수가 있는 경우 쉼표로 구분된 일련의 정수로 입력됩니다.
사용:
- 정황
- 외부 서비스 조건
신호가 손실된 것으로 간주하기 전에 플랫폼에서 마지막 데이터 포인트를 수신한 후 대기하는 시간(초)입니다. 이는 데이터 타임스탬프가 아닌 데이터가 도착한 시간을 기반으로 합니다. 기본값은 null입니다. 신호 손실 감지를 활성화하려면 값을 추가하십시오.
사용:
- NRQL 조건
true
인 경우 expiration_duration
시간 내에 신호가 들리지 않으면 현재 열려 있는 모든 인시던트가 닫힙니다.
기본값은 false
입니다.
사용:
- NRQL 조건
true인 경우 expiration_duration
시간 내에 신호가 없을 때 신호 손실 사고가 발생합니다.
기본값은 false
입니다.
사용:
- NRQL 조건
모니터링할 외부 서비스의 URL입니다. 이 문자열은 프로토콜을 포함 하지 않아야 합니다. 예를 들어, https://example.com
이 아니라 example.com
을 사용합니다.
사용:
- 외부 서비스 조건
metric 필드는 세 가지 공지 카테고리에 사용됩니다. 사용할 수 있는 정확한 모범 사례는 유형 필드의 설정에 따라 다릅니다. 공지 유형 필드에 따라 아래에 나열되어 있습니다.
유형 필드에 지정된 값은 어떤 시도를 지정할 수 있는지 제어합니다. 유형 필드와 해당 사용 가능한 parameter 이름은 다음 표에 나열되어 있습니다. 하나만 지정할 수 있습니다.
| 매개변수 |
---|---|
apm_app_metric |
|
apm_kt_metric |
|
브라우저 메트릭 |
|
browser_metric_baseline |
|
mobile_metric |
|
유형 필드에 지정된 값은 어떤 시도를 지정할 수 있는지 제어합니다. 유형 필드와 해당 사용 가능한 parameter 이름은 다음 표에 나열되어 있습니다. 하나만 지정할 수 있습니다.
| 매개변수 |
---|---|
apm_external_service |
|
apm_app_metric_baseline |
|
mobile_external_service |
|
경고할 합성 모니터링의 GUID입니다.
사용:
- 합성 모니터링 조건
이것은 NRQL 조건의 일부로 모니터에 경고하는 NRQL 쿼리입니다.
사용:
- NRQL 조건
aggregation_delay
또는 aggregation_timer
가 있는 aggregation_method
대신 사용되지 않습니다. 지정된 NRQL 쿼리를 평가하는 시간 프레임(분)입니다. since_value
은 1
에서 20
사이여야 합니다.
사용:
- NRQL 조건
집계 창이 데이터로 채워질 때까지 기다리는 시간(초)입니다. CADENCE 또는 이벤트 aggregation_method
유형을 사용할 때 필요합니다. 기본값은 120 seconds 입니다.
이벤트 흐름 및 케이던스 집계 방법과 함께 사용됩니다.
사용:
- NRQL 조건
New Relic은 데이터를 창으로 집계하고 현재 창이 종료되고 다음 창이 시작되는 시점을 결정해야 합니다. aggregation_method
은 주어진 집계 창에 대한 모든 데이터가 있을 때 알려주는 논리입니다. 창이 닫히면 데이터가 단일 지점으로 집계되고 임계값에 대해 평가됩니다.
이 필드는 선택 사항입니다. 다음 세 가지 값 중 하나를 지정할 수 있습니다.
EVENT_FLOW
: (기본값) 각 집계 창은 자체 지연 설정을 지난 타임스탬프가 도착하기 시작할 때까지 기다립니다. 이 문제가 발생하면 데이터가 게시됩니다. 도착 데이터의 타임스탬프에 의존하므로 벽시계 시간은 더 이상 관련이 없습니다. 자주 들어오는 소스와 낮은 이벤트 확산(높은 처리량 메트릭)에 가장 잘 작동합니다.CADENCE
: 벽시계 시간을 타이머로 사용하여 각 평가 창이aggregation_delay
설정만큼 정확히 대기하는 Classic New Relic 로직입니다. 이 옵션을 사용할 때는aggregation_delay
이 필요합니다. 너무 늦게 도착하는 데이터는 삭제되어 잘못된 경고가 발생할 수 있습니다.EVENT_TIMER
: 각 집계 창에는aggregation_timer
값으로 설정된 타이머가 있습니다. 해당 집계 창에 대한 첫 번째 데이터 포인트가 표시되는 즉시 타이머가 실행되기 시작합니다(데이터 포인트의 타임스탬프 기반).aggregation_timer
은 해당 창에 도착하는 각각의 새 데이터 포인트에 대해 재설정됩니다.aggregation_timer
가 0에 도달하면 집계 창이 게시됩니다. 클라우드 통합 및 간헐적 오류 로그와 같은 희소 및 일괄 데이터에 이상적입니다.기본값은 Event flow 입니다.
사용:
NRQL 조건
전체 배치가 처리되었는지 확인하기 위해 각 데이터 포인트가 수신된 후 대기하는 시간(초)입니다. EVENT_TIMER
aggregation_method
유형을 사용할 때 필요합니다. 기본값은 60 seconds 입니다.
사용:
- NRQL 조건
스트리밍 경고는 NRQL 쿼리에서 기능을 실행하기 전에 특정 시간 동안 데이터를 수집합니다. 이러한 시간 창은 사용자 정의할 수 있습니다.
데이터 포인트는 타임스탬프를 기반으로 함께 수집되며 배치로 보고됩니다. 사용자 정의 가능한 집계 창은 불규칙하거나 빈도가 낮은 데이터 포인트에 대해 경고할 때 더 큰 유연성을 제공하고 잘못된 사고를 줄입니다.
UI의 Advanced signal settings 아래에는 Aggregation window 필드가 있습니다.
기본값은 60 seconds 입니다. 최대 6시간입니다.
사용:
- NRQL 조건
기본적으로 집계 기간은 순차적으로 그룹화됩니다. 이것은 한 창이 시작되고 다른 창이 시작될 때마다 급상승 차트로 이어질 수 있습니다.
slide_by
을 사용하여 슬라이딩 창을 만듭니다. 슬라이딩 집계 창은 겹쳐서 더 부드러운 차트를 만듭니다. slide_by
간격은 중첩 기간을 설정합니다.
UI의 Advanced signal settings 아래에서 Use sliding window aggregation 토글을 클릭하여 슬라이딩 창을 활성화합니다.
기본값은 현재 창 지속 시간을 기반으로 합니다. slide_by
간격은 집계 창 기간으로 균등하게 나누어져야 합니다. slide_by
간격도 창 기간보다 작아야 합니다.
aggregation_delay
또는 aggregation_timer
중 하나를 사용하는 aggregation_method
를 위해 더 이상 사용되지 않습니다. 오프셋은 각 집계 창을 평가하기 전에 지연된 데이터를 기다리는 시간입니다. 더 오래 기다리면 신호가 더 정확해지지만 지연 시간이 늘어납니다. 기본값은 3 aggregation windows 입니다.
사용:
- NRQL 조건
산발적인 데이터의 경우 간격(빈 창)을 합성 데이터로 채워 잘못된 경고를 피할 수 있습니다.
none
: (기본값) 빈 집계 창에서 어떤 작업도 수행하지 않으려는 경우 사용합니다. 평가 시 빈 집계 창이 임계값 기간 타이머를 재설정합니다. 예를 들어 조건에 모든 집계 기간에 5분 동안 임계값 이상의 데이터 포인트가 있어야 하고 집계 기간 5개 중 1개가 비어 있어야 한다는 조건이 있는 경우 조건은 인시던트를 열지 않습니다.static
: 빈 집계 창을 평가하기 전에 사용자 지정 정적 값을 삽입하려는 경우 사용합니다. 이 옵션에는 사용해야 하는 정적 값을 지정하는fillValue
의 추가 필수 매개변수가 있습니다. 기본값은 0입니다.last_value
: 평가가 발생하기 전에 마지막으로 본 값을 삽입하는 데 사용합니다. 마지막으로 본 값의 상태를 2시간 동안 유지합니다.UI의 Advanced signal settings 아래에는 Fill data gaps with 필드가 있습니다.
사용:
NRQL 조건
이것은 fill_option
사용자 정의 값에서 사용하는 값입니다. 기본값은 0
입니다.
사용:
- NRQL 조건
이는 이벤트를 트리거하기 위해 value_function 와 terms[threshold] 값 사이에 어떤 비교가 사용될지 결정합니다. 에서 노인값, 경계를 추가할 때 선택한 동작에 해당합니다.UI 다음 문자열 중 하나여야 합니다.
위에
above_or_equals(NRQL 조건만 해당)
아래에
under_or_equals(NRQL 조건만 해당)
동일한
not_equals(NRQL 조건만 해당)
사용:
정황
외부 서비스 조건
NRQL 조건
이는 UI에서 조건에 대한 임계값을 설정할 때 선택한 심각도 수준 에 해당합니다. 다음 문자열 중 하나여야 합니다.
위독한
경고
사용:
정황
외부 서비스 조건
NRQL 조건
이것은 트리거된 이벤트에 대해 value_function 을 terms[operator] 을 사용하는 것과 비교해야 하는 레버 값입니다. 레버값, 관측값 추가 시 UI 에서 지정한 숫자값에 해당합니다.
이것은 숫자 값이며 0(영) 이상이어야 합니다.
사용:
- 정황
- 외부 서비스 조건
- NRQL 조건
이것은 임계값을 추가 할 때 UI에서 지정한 설정에 해당합니다. 선택 사항은 다음과 같습니다.
모두(UI의
for at least
에 해당)모두(UI의
at least once in
에 해당)사용:
정황
외부 서비스 조건
NRQL 조건
공지에 사용될 지표의 종류를 정의합니다. 지표 필드에 허용되는 콘텐츠는 선택한 type 값에 따라 다릅니다.
두 가지 제품 범주 가 있습니다.
이 카테고리의 경우 type 공지조건 의 유형을 나타내는 다음 문자열 중 하나로 설정됩니다.
| 사용 |
---|---|
apm_app_metric | 전설적인 지표가 공지를 유발합니다. |
apm_app_metric_baseline | APM 애플리케이션 메트릭은 경고를 트리거합니다(이상 임계값 사용). |
apm_kt_metric | APM 키 트랜잭션 메트릭은 경고를 트리거합니다. |
브라우저 메트릭 | 브라우저 측정항목이 경고를 트리거합니다. |
browser_metric_baseline | 브라우저 메트릭은 경고를 트리거합니다(이상 임계값 사용). |
mobile_metric | 모바일 측정항목이 경고를 트리거합니다. |
사용:
- 정황
이 카테고리의 경우 type 외부 서비스 조건 유형을 나타내는 다음 문자열 중 하나로 설정됩니다.
| 사용 |
---|---|
apm_external_service | APM 외부 메트릭이 경고를 트리거합니다. |
mobile_external_service | 모바일 외부 측정항목이 경고를 트리거합니다. |
사용:
- 외부 서비스 조건
이벤트가 트리거되어야 하는지 결정하는 데 사용되는 사용자 정의 맞춤 metric 의 이름입니다.
인시던트가 트리거되어야 하는지 평가할 때 지표와 연관된 user_defined[value_function] 는 terms[threshold] 값과 비교됩니다. 비교는 terms[operator] 에 의해 정의된 연산자를 사용하여 수행됩니다.
사용:
- 정황
- 외부 서비스 조건
- 합성 모니터링 조건
이는 user_defined[metric] 으로 지정된 맞춤 지표에서 얻은 숫자 값입니다.
인시던트가 트리거되어야 하는지 평가할 때 terms[threshold] 값과 비교됩니다. 비교는 terms[operator] 에 의해 정의된 연산자를 사용하여 수행됩니다.
다음 값 함수 중 하나를 지정해야 합니다.
평균
분
최대
총
표본의 크기
사용:
정황
NRQL 조건 에 사용되는 경우 옵션은 다음과 같습니다.
- single_value(조건은 각 쿼리의 반환 값을 기반으로 평가됨)
- 합계(조건은 지정된 기간 동안 각 쿼리의 반환된 값의 합계를 기반으로 평가됨)
지정된 시간(초) 후에 인스턴스 기반 인시던트를 자동으로 닫는 데 사용합니다.
기본값은 259,200 seconds (3일)입니다. 최대 30일입니다.
사용:
- 위치 조건
- NRQL 조건
지정된 시간이 지나면 JVM 상태 메트릭 인시던트를 포함하여 인스턴스 기반 인시던트를 자동으로 닫는 데 사용합니다. 1-720시간 사이여야 합니다. 기본값은 72시간입니다.
사용:
apm_app_metric
(condition_scope
을instance
로 설정)apm_jvm_metric