8장. ServiceMonitor [monitoring.coreos.com/v1]

attachMetadata

object

검색된 대상에 노드 메타데이터를 연결합니다. Prometheus v2.37.0 이상이 필요합니다.

끝점

array

이 ServiceMonitor의 일부로 허용되는 끝점 목록입니다.

endpoints[]

object

끝점은 Prometheus 지표를 제공하는 스크랩 가능한 끝점을 정의합니다.

jobLabel

string

JobLabel은 모든 메트릭의 작업 레이블로 사용할 연결된 Kubernetes 서비스에서 레이블을 선택합니다. 예: ServiceMonitor.spec.jobLabel: foo 및 Service.metadata.labels.foo: bar 에서는 모든 메트릭에 job="bar" 라벨이 추가됩니다. 이 필드의 값이 비어 있거나 지정된 서비스에 레이블이 없는 경우 메트릭의 작업 레이블은 기본적으로 Kubernetes 서비스의 이름으로 설정됩니다.

labelLimit

integer

샘플에 허용되는 라벨 수에 대한 조각별 제한입니다. Prometheus 버전 2.27.0 이상에서만 유효합니다.

labelNameLengthLimit

integer

샘플에 대해 허용되는 라벨 이름 길이에 대한 조각별 제한입니다. Prometheus 버전 2.27.0 이상에서만 유효합니다.

labelValueLengthLimit

integer

샘플에 허용되는 라벨 값의 길이 제한입니다. Prometheus 버전 2.27.0 이상에서만 유효합니다.

namespaceSelector

object

Kubernetes 끝점 개체가 검색되는 네임스페이스를 선택하는 선택기입니다.

podTargetLabels

배열(문자열)

PodTargetLabels는 Kubernetes Pod 의 레이블을 생성된 메트릭으로 전송합니다.

sampleLimit

integer

SampleLimit는 허용될 스크랩된 샘플 수에 대한 per-scrape 제한을 정의합니다.

선택기

object

끝점 오브젝트를 선택하는 선택기입니다.

targetLabels

배열(문자열)

TargetLabels는 Kubernetes 서비스에서 생성된 메트릭으로 레이블을 전송합니다.

targetLimit

integer

TargetLimit는 허용되는 스크랩 대상 수에 대한 제한을 정의합니다.

노드

boolean

true로 설정하면 Prometheus에 노드를 가져올 수 있는 권한이 있어야 합니다.

권한 부여

object

이 끝점에 대한 권한 부여 섹션

basicAuth

object

basicauth를 사용하면 끝점이 기본 인증 세부 정보를 통해 인증할 수 있습니다. https://prometheus.io/docs/operating/configuration/#endpoints

bearerTokenFile

string

스크랩 대상의 전달자 토큰을 읽기 위한 파일입니다.

bearerTokenSecret

object

스크랩 대상의 전달자 토큰을 읽기 위해 마운트하는 시크릿입니다. 시크릿은 서비스 모니터와 동일한 네임스페이스에 있어야 하며 Prometheus Operator가 액세스할 수 있어야 합니다.

enableHttp2

boolean

HTTP2를 활성화할지 여부입니다.

filterRunning

boolean

실행 중이 아닌 Pod를 삭제합니다. (실패, 성공). 기본적으로 활성화되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase

followRedirects

boolean

FollowRedirects는 스크랩 요청이 HTTP 3xx 리디렉션을 따르는지 여부를 구성합니다.

honorLabels

boolean

CryostatLabels는 대상 라벨이 있는 충돌 시 메트릭의 레이블을 선택합니다.

honorTimestamps

boolean

CryostatTimestamps는 Prometheus가 스크랩된 데이터에 존재하는 타임스탬프를 준수하는지 여부를 제어합니다.

간격

string

Prometheus의 글로벌 스크랩 간격을 지정하지 않으면 메트릭을 스크랩해야 하는 간격입니다.

metricRelabelings

array

수집 전에 샘플에 적용할 MetricRelabelConfigs

metricRelabelings[]

object

RelabelConfig를 사용하면 레이블 세트를 동적 재작성하고 수집 전에 샘플에 적용할 수 있습니다. Prometheus 구성의 <metric_relabel_configs> -section을 정의합니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs

oauth2

object

URL용 OAuth2입니다. Prometheus 버전 2.27.0 이상에서만 유효합니다.

params

object

선택적 HTTP URL 매개변수

params{}

배열(문자열)

path

string

메트릭에 대해 스크랩할 HTTP 경로입니다. 비어 있는 경우 Prometheus는 기본값(예: /metrics)을 사용합니다.

port

string

이 엔드포인트에서 참조하는 서비스 포트의 이름입니다. targetPort와 함께 사용할 수 없습니다.

proxyUrl

string

ProxyURL (예: http://proxyserver:2195 이 끝점을 통해 프록시 스크랩)

레이블 재지정

array

스크랩 전에 샘플에 적용할 RelabelConfigs입니다. Prometheus Operator는 몇 가지 표준 Kubernetes 필드에 대한 레이블 재레이블을 자동으로 추가합니다. 원래 스크랩 작업 이름은 \_tmp_prometheus_job_name 레이블을 통해 사용할 수 있습니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

relabelings[]

object

RelabelConfig를 사용하면 레이블 세트를 동적 재작성하고 수집 전에 샘플에 적용할 수 있습니다. Prometheus 구성의 <metric_relabel_configs> -section을 정의합니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs

스키마

string

스크랩에 사용할 HTTP 스키마입니다.

scrapeTimeout

string

스크랩이 종료된 후 시간 초과가 지정되지 않은 경우 후자가 사용되는 Interval 미만이 아니면 Prometheus 글로벌 스크랩 시간 초과가 사용됩니다.

targetPort

integer-or-string

서비스 뒤에 있는 Pod의 대상 포트 이름 또는 번호, 컨테이너 포트 속성을 사용하여 포트를 지정해야 합니다. 포트와 함께 사용할 수 없습니다.

tlsConfig

object

끝점을 스크랩할 때 사용할 TLS 구성

credentials

object

요청의 인증 정보가 포함된 시크릿의 키

type

string

인증 유형을 설정합니다. 기본값은 Bearer, Basic으로 인해 오류가 발생합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

암호

object

인증을 위한 암호가 포함된 서비스 모니터 네임스페이스의 시크릿입니다.

사용자 이름

object

인증을 위한 사용자 이름이 포함된 서비스 모니터 네임스페이스의 시크릿입니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

작업

string

정규 표현식 일치를 기반으로 수행할 작업입니다. 기본값은 'replace'. 대문자 및 소문자 작업에 Prometheus >= 2.36이 필요합니다.

modulus

integer

소스 레이블 값의 해시를 사용합니다.

regex

string

추출된 값이 일치하는 정규식입니다. 기본값은 '(.*)입니다.

교체

string

정규 표현식과 일치하는 경우 regex 교체가 수행되는 대체 값입니다. regex 캡처 그룹을 사용할 수 있습니다. 기본값은 '$1'입니다.

구분 기호

string

연결된 소스 레이블 값 사이에 배치된 구분 기호입니다. 기본값은 ';'입니다.

sourceLabels

배열(문자열)

소스 레이블은 기존 라벨에서 값을 선택합니다. 해당 콘텐츠는 구성된 구분자를 사용하여 연결되고 교체, 보관 및 삭제 작업에 대해 구성된 정규식과 일치합니다.

targetLabel

string

결과 값이 교체 작업에 기록되는 레이블입니다. 교체 작업은 필수입니다. regex 캡처 그룹을 사용할 수 있습니다.

clientId

object

OAuth2 클라이언트 ID를 포함하는 secret 또는 configmap

clientSecret

object

OAuth2 클라이언트 시크릿이 포함된 시크릿

endpointParams

오브젝트(문자열)

토큰 URL에 추가할 매개변수

범위

배열(문자열)

토큰 요청에 사용되는 OAuth2 범위

tokenUrl

string

토큰을 가져올 URL

configMap

object

대상에 사용할 데이터가 포함된 ConfigMap입니다.

Secret

object

대상에 사용할 데이터가 포함된 시크릿입니다.

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

작업

string

정규 표현식 일치를 기반으로 수행할 작업입니다. 기본값은 'replace'. 대문자 및 소문자 작업에 Prometheus >= 2.36이 필요합니다.

modulus

integer

소스 레이블 값의 해시를 사용합니다.

regex

string

추출된 값이 일치하는 정규식입니다. 기본값은 '(.*)입니다.

교체

string

정규 표현식과 일치하는 경우 regex 교체가 수행되는 대체 값입니다. regex 캡처 그룹을 사용할 수 있습니다. 기본값은 '$1'입니다.

구분 기호

string

연결된 소스 레이블 값 사이에 배치된 구분 기호입니다. 기본값은 ';'입니다.

sourceLabels

배열(문자열)

소스 레이블은 기존 라벨에서 값을 선택합니다. 해당 콘텐츠는 구성된 구분자를 사용하여 연결되고 교체, 보관 및 삭제 작업에 대해 구성된 정규식과 일치합니다.

targetLabel

string

결과 값이 교체 작업에 기록되는 레이블입니다. 교체 작업은 필수입니다. regex 캡처 그룹을 사용할 수 있습니다.

ca

object

서버 인증서를 확인할 때 사용되는 인증 기관입니다.

caFile

string

대상에 사용할 Prometheus 컨테이너의 CA 인증서 경로입니다.

인증서

object

클라이언트 인증을 수행할 때 제공할 클라이언트 인증서입니다.

certFile

string

대상의 Prometheus 컨테이너에 있는 클라이언트 인증서 파일의 경로입니다.

insecureSkipVerify

boolean

대상 인증서 검증을 비활성화합니다.

keyFile

string

대상의 Prometheus 컨테이너에 있는 클라이언트 키 파일의 경로입니다.

keySecret

object

대상에 대한 클라이언트 키 파일이 포함된 시크릿입니다.

serverName

string

대상의 호스트 이름을 확인하는 데 사용됩니다.

configMap

object

대상에 사용할 데이터가 포함된 ConfigMap입니다.

Secret

object

대상에 사용할 데이터가 포함된 시크릿입니다.

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

configMap

object

대상에 사용할 데이터가 포함된 ConfigMap입니다.

Secret

object

대상에 사용할 데이터가 포함된 시크릿입니다.

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 기타 유용한 필드를 추가합니다. apiVersion, kind, uid?

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

Any

boolean

부울은 모든 네임스페이스를 제한하는 목록과 달리 모든 네임스페이스를 선택하는지 여부를 설명합니다.

matchNames

배열(문자열)

선택할 네임스페이스 이름 목록입니다.

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다.

key

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

값

배열(문자열)

값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.