6장. PodMonitor [monitoring.coreos.com/v1]

attachMetadata

object

attachMetadata 는 검색된 대상에 추가된 추가 메타데이터를 정의합니다. Prometheus >= v2.37.0이 필요합니다.

bodySizeLimit

string

정의된 경우 bodySizeLimit는 Prometheus에서 수락할 압축되지 않은 응답 본문 크기에 대한 작업 수준 제한을 지정합니다. Prometheus >= v2.28.0이 필요합니다.

jobLabel

string

작업 이름을 검색하는 데 사용할 레이블입니다. job Label 은 모든 메트릭의 작업 레이블로 사용될 관련 Kubernetes Pod 오브젝트에서 레이블을 선택합니다. 예를 들어 jobLabel 이 foo 로 설정되고 Kubernetes Pod 오브젝트에 foo: bar 로 레이블이 지정되어 있는 경우 Prometheus는 모든 ingested 메트릭에 job="bar" 라벨을 추가합니다. 이 필드의 값이 비어 있으면 메트릭의 작업 레이블은 기본적으로 PodMonitor 오브젝트의 네임스페이스 및 이름(예: <namespace>/< name> )으로 설정됩니다.

keepDroppedTargets

integer

메모리에 유지할 레이블 재지정으로 삭제된 대상 수에 대한 제한입니다. 0은 제한이 없음을 의미합니다. Prometheus >= v2.47.0이 필요합니다.

labelLimit

integer

샘플에 허용되는 라벨 수에 대한 조각별 제한입니다. Prometheus >= v2.27.0이 필요합니다.

labelNameLengthLimit

integer

샘플에 대해 허용되는 라벨 이름 길이에 대한 조각별 제한입니다. Prometheus >= v2.27.0이 필요합니다.

labelValueLengthLimit

integer

샘플에 허용되는 라벨 값의 길이 제한입니다. Prometheus >= v2.27.0이 필요합니다.

namespaceSelector

object

Kubernetes Pod 오브젝트가 검색되는 네임스페이스를 선택하는 선택기입니다.

podMetricsEndpoints

array

이 PodMonitor의 끝점 부분 목록입니다.

podMetricsEndpoints[]

object

PodMetricsEndpoint는 Prometheus에서 스크랩할 Prometheus 지표를 제공하는 끝점을 정의합니다.

podTargetLabels

배열(문자열)

podTargetLabels 는 연결된 Kubernetes Pod 오브젝트에서 ingested 메트릭으로 전송되는 레이블을 정의합니다.

sampleLimit

integer

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

scrapeClass

string

적용할 scrape 클래스입니다.

scrapeProtocols

배열(문자열)

scrapeProtocols 는 스크랩 중에 협상할 프로토콜을 정의합니다. 이는 클라이언트에 기본 설정 순서대로 Prometheus에서 지원하는 프로토콜을 알립니다(대부분에서 가장 선호됨). 설정되지 않은 경우 Prometheus는 기본값을 사용합니다. Prometheus >= v2.49.0이 필요합니다.

선택기

object

Kubernetes Pod 오브젝트를 선택하는 라벨 선택기입니다.

targetLimit

integer

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

노드

boolean

true로 설정하면 Prometheus가 Nodes 오브젝트에 대한 get 권한이 있어야 합니다.

Any

boolean

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

matchNames

배열(문자열)

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

권한 부여

object

권한 부여 는 대상을 스크랩할 때 사용할 Authorization 헤더 자격 증명을 구성합니다. basicAuth 또는 oauth2 와 동시에 설정할 수 없습니다.

basicAuth

object

basicauth 는 대상을 스크랩할 때 사용할 기본 인증 자격 증명을 구성합니다. 권한 부여 또는 oauth2 와 동시에 설정할 수 없습니다.

bearerTokenSecret

object

전달자TokenSecret 은 대상 스크랩을 위한 전달자 토큰이 포함된 보안의 키를 지정합니다. 보안은 PodMonitor 오브젝트와 동일한 네임스페이스에 있어야 하며 Prometheus Operator에서 읽을 수 있어야 합니다. 더 이상 사용되지 않음: 대신 권한 부여를 사용합니다.

enableHttp2

boolean

enableHttp2 를 사용하여 대상을 스크랩할 때 HTTP2를 비활성화할 수 있습니다.

filterRunning

boolean

true인 경우 실행되지 않는 Pod(예: Failed 또는 Succeeded 상태)는 대상 검색 중에 삭제됩니다. 설정되지 않은 경우 필터링이 활성화됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase

followRedirects

boolean

followRedirects 는 스크랩 요청이 HTTP 3xx 리디렉션을 따라야 하는지 여부를 정의합니다.

honorLabels

boolean

true인 경우 honorLabels 는 대상의 라벨과 충돌할 때 메트릭의 라벨을 유지합니다.

honorTimestamps

boolean

honorTimestamps 는 대상에서 노출할 때 Prometheus가 타임스탬프를 유지할지 여부를 제어합니다.

간격

string

Prometheus가 대상에서 지표를 스크랩하는 간격입니다. 비어 있는 경우 Prometheus는 글로벌 스크랩 간격을 사용합니다.

metricRelabelings

array

metricRelabelings 는 수집 전에 샘플에 적용할 레이블 재지정 규칙을 구성합니다.

metricRelabelings[]

object

RelabelConfig를 사용하면 대상, 경고, 스크랩된 샘플 및 원격 쓰기 샘플에 대한 레이블 세트를 동적 다시 작성할 수 있습니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

oauth2

object

oauth2 는 대상을 스크랩할 때 사용할 OAuth2 설정을 구성합니다. Prometheus >= 2.27.0이 필요합니다. 권한 부여 또는 basicAuth 와 동시에 설정할 수 없습니다.

params

object

매개변수는 선택적 HTTP URL 매개변수를 정의합니다.

params{}

배열(문자열)

path

string

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

port

string

이 끝점이 참조하는 Pod 포트의 이름입니다. targetPort 보다 우선합니다.

proxyUrl

string

proxyURL 은 대상을 스크랩할 때 이동하도록 HTTP 프록시 URL(예: "http://proxyserver:2195")을 구성합니다.

레이블 재지정

array

레이블 재지정 은 대상의 메타데이터 레이블을 적용하도록 레이블 재지정 규칙을 구성합니다. Operator는 몇 가지 표준 Kubernetes 필드에 대한 재레이블을 자동으로 추가합니다. 원래 스크랩 작업 이름은 \_tmp_prometheus_job_name 레이블을 통해 사용할 수 있습니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

relabelings[]

object

RelabelConfig를 사용하면 대상, 경고, 스크랩된 샘플 및 원격 쓰기 샘플에 대한 레이블 세트를 동적 다시 작성할 수 있습니다. 자세한 내용은 https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

스키마

string

스크랩에 사용할 HTTP 스키마입니다. 레이블 재지정을 통해 scheme 레이블을 다시 작성하지 않는 한 HTTP 및 https 는 예상 값입니다. 비어 있는 경우 Prometheus는 기본값 http 를 사용합니다.

scrapeTimeout

string

Prometheus에서 스크랩을 간주한 후 시간 초과가 실패합니다. 비어 있는 경우 Prometheus는 후자가 사용되는 대상의 스크랩 간격 값보다 작지 않는 한 글로벌 스크랩 시간 초과를 사용합니다.

targetPort

integer-or-string

서비스 뒤에 있는 Pod 오브젝트의 대상 포트 이름 또는 번호, 컨테이너 포트 속성을 사용하여 포트를 지정해야 합니다. deprecated: 대신 'port'를 사용합니다.

tlsConfig

object

대상을 스크랩할 때 사용할 TLS 구성입니다.

trackTimestampsStaleness

boolean

trackTimestampsStaleness 는 Prometheus가 스크랩된 데이터에 명시적 타임스탬프가 있는 메트릭을 추적하는지 여부를 정의합니다. honorTimestamps 가 false인 경우 영향을 미치지 않습니다. Prometheus >= v2.48.0이 필요합니다.

credentials

object

인증을 위한 인증 정보가 포함된 네임스페이스에서 Secret의 키를 선택합니다.

type

string

인증 유형을 정의합니다. 값은 대소문자를 구분하지 않습니다. "basic"은 지원되는 값이 아닙니다. 기본값: "Bearer"

key

string

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

name

string

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

optional

boolean

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

암호

object

password 는 인증을 위한 암호가 포함된 보안의 키를 지정합니다.

사용자 이름

object

username 은 인증을 위한 사용자 이름이 포함된 보안의 키를 지정합니다.

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

regex 일치를 기반으로 수행할 작업입니다. 대문자 및 소문자 작업에는 Prometheus >= v2.36.0이 필요합니다. DropEqual 및 KeepEqual 작업에는 Prometheus >= v2.41.0이 필요합니다. 기본값: "Replace"

modulus

integer

소스 레이블 값의 해시를 사용합니다. 작업이 HashMod 인 경우에만 적용됩니다.

regex

string

추출된 값이 일치하는 정규식입니다.

교체

string

정규식과 일치하는 경우 Replace 작업이 수행되는 대체 값입니다. regex 캡처 그룹을 사용할 수 있습니다.

구분 기호

string

구분 기호는 연결된 SourceLabels 간의 문자열입니다.

sourceLabels

배열(문자열)

소스 레이블은 기존 라벨에서 값을 선택합니다. 해당 콘텐츠는 구성된 분리기를 사용하여 연결되고 구성된 정규식과 일치합니다.

targetLabel

string

결과 문자열이 대체에 기록되는 레이블입니다. Replace,HashMod,소문자 ,Uppercase ,KeepEqual 및 DropEqual 작업 필수 항목입니다. regex 캡처 그룹을 사용할 수 있습니다.

clientId

object

ClientID는 OAuth2 클라이언트 의 ID가 포함된 Secret 또는 ConfigMap의 키를 지정합니다.

clientSecret

object

clientSecret 은 OAuth2 클라이언트의 시크릿을 포함하는 보안의 키를 지정합니다.

endpointParams

오브젝트(문자열)

endpointParams 는 토큰 URL에 추가할 HTTP 매개 변수를 구성합니다.

범위

배열(문자열)

범위는 토큰 요청에 사용되는 OAuth2 범위를 정의합니다.

tokenUrl

string

tokenURL 은 토큰을 가져오도록 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

regex 일치를 기반으로 수행할 작업입니다. 대문자 및 소문자 작업에는 Prometheus >= v2.36.0이 필요합니다. DropEqual 및 KeepEqual 작업에는 Prometheus >= v2.41.0이 필요합니다. 기본값: "Replace"

modulus

integer

소스 레이블 값의 해시를 사용합니다. 작업이 HashMod 인 경우에만 적용됩니다.

regex

string

추출된 값이 일치하는 정규식입니다.

교체

string

정규식과 일치하는 경우 Replace 작업이 수행되는 대체 값입니다. regex 캡처 그룹을 사용할 수 있습니다.

구분 기호

string

구분 기호는 연결된 SourceLabels 간의 문자열입니다.

sourceLabels

배열(문자열)

소스 레이블은 기존 라벨에서 값을 선택합니다. 해당 콘텐츠는 구성된 분리기를 사용하여 연결되고 구성된 정규식과 일치합니다.

targetLabel

string

결과 문자열이 대체에 기록되는 레이블입니다. Replace,HashMod,소문자 ,Uppercase ,KeepEqual 및 DropEqual 작업 필수 항목입니다. regex 캡처 그룹을 사용할 수 있습니다.

ca

object

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

인증서

object

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

insecureSkipVerify

boolean

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

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

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

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인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.