monitoring.gdc.goog/v1
모니터링 그룹의 API 스키마 정의를 포함합니다.
AlertRule
알림 규칙 구성을 정의합니다.
표시되는 위치: - MonitoringRuleSpec
| 필드 | 설명 |
|---|---|
alert 문자열 |
알림 이름입니다. 이 문자열의 값은 유효한 라벨 값이어야 합니다. |
expr 문자열 |
알림 규칙을 평가할 PromQL 또는 LogQL 표현식입니다. |
for 문자열 |
알림을 대기 상태에서 열린 상태로 이동하기 위해 지정된 조건을 충족해야 하는 기간(초)입니다. |
labels 객체 (키:문자열, 값:문자열) |
추가하거나 덮어쓸 라벨입니다. 이 필드의 필수 라벨은 severity: [error, critical, warning, info], code: <short code for the error>, resource: <component, service, or hardware related to the alert>입니다. 추가 라벨은 선택사항입니다. |
annotations 객체 (키:문자열, 값:문자열) |
추가할 주석입니다. |
ClusterStatus
ClusterStatus는 특정 클러스터에 영향을 미치는 조건 목록입니다.
표시 위치: - MonitoringTargetStatus
| 필드 | 설명 |
|---|---|
cluster 문자열 |
|
conditions Condition 배열 |
MonitoringRule
모니터링 규칙 API의 스키마를 정의합니다.
표시 위치: - MonitoringRuleList
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
monitoring.gdc.goog/v1 |
kind 문자열 |
MonitoringRule |
metadata ObjectMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
spec MonitoringRuleSpec |
|
status MonitoringRuleStatus |
MonitoringRuleList
모니터링 규칙 목록을 포함합니다.
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
monitoring.gdc.goog/v1 |
kind 문자열 |
MonitoringRuleList |
metadata ListMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
items MonitoringRule 배열 |
MonitoringRuleSpec
MonitoringRule 객체의 사양 또는 예상 상태를 정의합니다.
표시 위치: - MonitoringRule
| 필드 | 설명 |
|---|---|
interval 문자열 |
규칙 평가 간격입니다. |
limit 정수 |
알림의 제한 수입니다. 0 값은 한도가 없음을 의미합니다. |
recordRules RecordRule 배열 |
레코드 규칙 목록입니다. |
alertRules AlertRule 배열 |
알림 규칙 목록입니다. |
MonitoringRuleStatus
MonitoringRule 객체의 관찰된 상태를 정의합니다.
표시 위치: - MonitoringRule
| 필드 | 설명 |
|---|---|
conditions Condition 배열 |
MonitoringRule 객체의 관찰된 상태를 정의합니다. |
errorStatus ErrorStatus |
ErrorStatus에는 현재 오류 목록과 이 필드가 업데이트되는 타임스탬프가 포함됩니다. |
MonitoringTarget
모니터링 타겟 API의 스키마를 정의합니다.
표시되는 위치: - MonitoringTargetList
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
monitoring.gdc.goog/v1 |
kind 문자열 |
MonitoringTarget |
metadata ObjectMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
spec MonitoringTargetSpec |
|
status MonitoringTargetStatus |
MonitoringTargetList
모니터링 타겟 목록을 포함합니다.
| 필드 | 설명 |
|---|---|
apiVersion 문자열 |
monitoring.gdc.goog/v1 |
kind 문자열 |
MonitoringTargetList |
metadata ListMeta |
metadata 필드는 Kubernetes API 문서를 참고하세요. |
items MonitoringTarget 배열 |
MonitoringTargetMetricsRelabeling
라벨을 기반으로 측정항목을 유지하거나 삭제하는 필터를 정의합니다.
표시 위치: - MonitoringTargetPodMetricsEndpoints
| 필드 | 설명 |
|---|---|
sourceLabels 문자열 배열 |
기존 라벨에서 선택한 값입니다. 콘텐츠는 separator을 사용하여 연결되고 replace, keep, drop 작업의 regex 표현식과 일치합니다. |
separator 문자열 |
연결된 소스 라벨 값 사이에 배치된 구분 기호 값입니다. |
regex 문자열 |
추출된 값과 일치하는 정규 표현식입니다. |
action 문자열 |
regex 표현식이 추출된 값과 일치할 때 실행할 작업입니다. |
targetLabel 문자열 |
replace 작업에서 결과 값을 쓸 라벨입니다. 이 필드는 replace 작업에 필수입니다. 정규 표현식의 캡처 그룹을 사용할 수 있습니다. |
replacement 문자열 |
정규 표현식이 replace 작업에서 추출된 값과 일치하는 경우 사용할 대체 값입니다. 정규 표현식의 캡처 그룹을 사용할 수 있습니다. |
MonitoringTargetPodMetricsEndpoints
스크랩된 포드의 측정항목 엔드포인트를 구성합니다.
표시 위치: - MonitoringTargetSpec
| 필드 | 설명 |
|---|---|
port MonitoringTargetPodMetricsPort |
측정항목이 스크래핑되는 포트입니다. |
path MonitoringTargetPodMetricsPath |
측정항목이 스크래핑되는 경로입니다. |
scheme MonitoringTargetPodMetricsScheme |
측정항목을 스크랩할 때 사용할 스키마입니다. |
params 객체 (키:문자열, 값:문자열 배열) |
path에서 측정항목을 스크랩할 때 사용할 쿼리 매개변수입니다. |
scrapeInterval 문자열 |
Prometheus가 podMetricsEndpoints 필드에 정의된 측정항목 엔드포인트를 스크레이핑하는 빈도입니다. |
scrapeTimeout 문자열 |
Prometheus가 podMetricsEndpoints 필드에 정의된 측정항목 엔드포인트의 응답을 기다리는 시간입니다. |
metricsRelabelings MonitoringTargetMetricsRelabeling 배열 |
라벨을 기반으로 측정항목을 포함 (allowlist)하거나 제외 (denylist)하는 필터입니다. |
ipAddresses 문자열 배열 |
IPAddress는 스크랩할 고정 IP 주소를 구성하는 데 사용됩니다. |
tlsConfig TLSConfig |
맞춤 TLS 구성을 제공합니다. 이는 스크랩해야 하는 Kubernetes 외부 워크로드에 제공됩니다. |
authCredential 문자열 |
스크랩 엔드포인트에 제공할 사용자 인증 정보입니다. |
MonitoringTargetPodMetricsPath
포드에서 측정항목을 스크래핑하는 데 사용할 경로를 결정합니다.
표시 위치: - MonitoringTargetPodMetricsEndpoints
| 필드 | 설명 |
|---|---|
value 문자열 |
측정항목을 수집할 경로입니다. 주석이 제공되면 이 필드보다 우선합니다. |
annotation 문자열 |
주석을 사용하여 측정항목을 수집할 경로입니다. |
MonitoringTargetPodMetricsPort
포드에서 측정항목을 스크랩하는 데 사용할 포트를 결정합니다.
표시 위치: - MonitoringTargetPodMetricsEndpoints
| 필드 | 설명 |
|---|---|
value 정수 |
측정항목을 수집할 포트입니다. 주석이 제공되면 이 필드보다 우선합니다. |
annotation 문자열 |
주석을 사용하여 측정항목을 수집할 포트입니다. |
MonitoringTargetPodMetricsScheme
포드에서 측정항목을 스크랩하는 데 사용할 스키마를 결정합니다.
표시 위치: - MonitoringTargetPodMetricsEndpoints
| 필드 | 설명 |
|---|---|
value 문자열 |
측정항목을 수집할 때 사용할 스키마입니다. 주석이 제공되면 이 필드보다 우선합니다. |
annotation 문자열 |
주석을 사용하여 측정항목을 수집할 때 사용할 스키마입니다. |
MonitoringTargetSelectors
모니터링할 포드를 결정하는 선택기를 제공합니다.
표시 위치: - MonitoringTargetSpec
| 필드 | 설명 |
|---|---|
matchClusters 문자열 배열 |
이 작업에 고려할 클러스터입니다. 기본 구성은 프로젝트에 적용 가능한 모든 클러스터를 고려하는 것입니다. 서로 다른 클러스터 간의 관계는 OR 관계입니다. 예를 들어 값 ["admin", "system"]는 관리자 클러스터 OR를 시스템 클러스터로 간주하도록 나타냅니다. |
matchLabels 객체 (키:문자열, 값:문자열) |
이 작업에 고려할 포드 라벨입니다. 기본 구성은 라벨을 기반으로 필터를 고려하지 않는 것입니다. 서로 다른 쌍 간의 관계는 AND 관계이므로 모든 쌍이 고려됩니다. |
matchAnnotations 객체 (키:문자열, 값:문자열) |
이 작업에 대해 고려할 주석입니다. 기본 구성은 주석을 기반으로 필터를 고려하지 않는 것입니다. 서로 다른 쌍 간의 관계는 AND 관계이므로 모든 쌍이 고려됩니다. |
MonitoringTargetSpec
MonitoringTarget 객체의 사양 또는 예상 상태를 정의합니다.
표시 위치: - MonitoringTarget
| 필드 | 설명 |
|---|---|
selector MonitoringTargetSelectors |
이 작업의 포드를 식별하는 일치 패턴입니다. 서로 다른 선택기 간의 관계를 설정하려면 AND를 사용합니다. |
podMetricsEndpoints MonitoringTargetPodMetricsEndpoints |
이 작업에 노출된 엔드포인트입니다. 엔드포인트는 Prometheus 스타일을 사용합니다. |
MonitoringTargetStatus
MonitoringTarget 객체의 관찰된 상태를 정의합니다.
표시 위치: - MonitoringTarget
| 필드 | 설명 |
|---|---|
conditions Condition 배열 |
모니터링 스택에서 관찰된 조건 목록입니다. |
clusterStatuses ClusterStatus 배열 |
ClusterStatuses는 각 클러스터와 해당 클러스터의 모니터링 스택에서 관찰된 조건의 목록입니다. |
RecordRule
레코드 규칙 구성을 정의합니다.
표시되는 위치: - MonitoringRuleSpec
| 필드 | 설명 |
|---|---|
record 문자열 |
레코드 규칙을 작성할 시계열입니다. 유효한 측정항목 이름이어야 합니다. |
expr 문자열 |
레코드 규칙을 평가할 PromQL 또는 LogQL 표현식입니다. |
labels 객체 (키:문자열, 값:문자열) |
추가하거나 덮어쓸 라벨입니다. |
TLSConfig
표시 위치: - MonitoringTargetPodMetricsEndpoints
| 필드 | 설명 |
|---|---|
ca 문자열 |
타겟에 사용할 CA 인증서의 텍스트입니다. |
cert 문자열 |
타겟의 클라이언트 인증서 파일 텍스트입니다. |
server_name 문자열 |
타겟의 호스트 이름을 확인하는 데 사용됩니다. |