5장. AlertingRule [monitoring.openshift.io/v1]

groups

array

그룹은 그룹화된 경고 규칙 목록입니다. 규칙 그룹은 Prometheus가 규칙 처리를 병렬화하는 단위입니다. 단일 그룹의 모든 규칙은 구성된 평가 간격을 공유합니다. 그룹의 모든 규칙은 이 간격에 따라 순차적으로 처리되며 모든 규칙이 처리됩니다. 관련 경고 규칙을 단일 AlertingRule 리소스로 그룹화하고 해당 리소스 내에서 밀접하게 관련된 경고 또는 동일한 간격으로 경고를 개별 그룹으로 그룹화하는 것이 일반적입니다. 또한 단일 규칙 그룹만으로 AlertingRule 리소스를 자유롭게 생성할 수 있지만 그룹이 매우 크거나 매우 복잡한 쿼리 표현식이 있는 경우 Prometheus에 성능에 영향을 미칠 수 있습니다. 병렬로 처리할 수 있도록 여러 그룹에 매우 복잡한 규칙을 분산하는 것도 일반적인 사용 사례입니다.

groups[]

object

RuleGroup은 순차적으로 평가된 경고 규칙 목록입니다.

간격

string

간격은 그룹의 규칙을 평가하는 빈도입니다. 지정하지 않으면 기본값은 Prometheus에 구성된 global.evaluation_interval이며 기본값은 30초입니다. 플랫폼 Prometheus 구성을 검사하여 클러스터의 기본값에서 이 값이 수정되었는지 확인할 수 있습니다. 해당 리소스의 관련 필드는 spec.evaluationInterval입니다.

name

string

이름은 그룹의 이름입니다.

규칙

array

규칙은 순차적으로 평가된 경고 규칙 목록입니다. Prometheus는 규칙 그룹을 병렬로 처리할 수 있지만 단일 그룹 내의 규칙은 항상 순차적으로 처리되며 모든 규칙이 처리됩니다.

rules[]

object

규칙은 경고 규칙을 설명합니다. Prometheus 문서: - https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules

경고

string

경고는 경고의 이름입니다. 유효한 레이블 값이어야 합니다. 즉, 유니코드 문자를 포함할 수 있습니다.

annotations

오브젝트(문자열)

각 경고에 추가할 주석입니다. 이러한 값은 경고 설명 또는 runbook 링크와 같이 쿼리하지 않는 추가 정보를 저장하는 데 사용할 수 있는 값입니다.

expr

integer-or-string

expr는 평가할 PromQL 표현식입니다. 모든 평가 주기는 현재 평가되며 생성되는 모든 시계열은 보류 중이거나 경고가 실행됩니다. 이는 PromQL 표현식을 나타내는 문자열입니다(예: mapi_current_pending_csr > mapi_max_pending_csr) 드문 경우 이는 간단한 정수일 수 있습니다(예: 항상 실행되는 경고를 생성하려는 경우 간단한 "1"). 경고 파이프라인이 작동하는지 확인하기 위해 항상 "Watchdog" 경고를 만드는 데 사용됩니다.

for

string

for는 첫 번째 반환 결과 후에 경고가 실행되는 것으로 간주되는 기간입니다. 오랜 시간 동안 실행되지 않은 경고는 보류 중으로 간주됩니다.

labels

오브젝트(문자열)

각 경고에 대해 추가하거나 덮어쓸 레이블입니다. 경고에 대한 PromQL 표현식의 결과는 표현식을 평가한 후 해당 세트의 라벨과 동일한 이름으로 지정되어 있는 모든 레이블에 대해 경고에 대한 기존 라벨 세트가 생성됩니다. 여기에 레이블은 이전 값을 우선하고 덮어씁니다. 일반적으로 쿼리에 유용할 수 있는 짧은 식별 값이어야 합니다. 일반적인 예는 라벨 키 아래에 severity: warning 을 설정하는 경고 심각도입니다.

observedGeneration

integer

observedGeneration은 귀하가 다루는 마지막 세대 변경 사항입니다.

prometheusRule

object

PrometheusRule는 이 AlertingRule에 대해 생성된 PrometheusRule입니다. 각 AlertingRule 인스턴스는 항상 openshift-monitoring 네임스페이스인 동일한 네임스페이스에 생성된 PrometheusRule 오브젝트가 생성됩니다.

name

string

참조된 PrometheusRule의 이름입니다.