1.11. 관찰 기능 API


1.11.1. 개요

이 문서는 Kubernetes용 Red Hat Advanced Cluster Management의 MultiClusterObservability 리소스를 위한 것입니다. MultiClusterObservability 리소스에는 생성, 쿼리, 삭제 및 업데이트의 네 가지 가능한 요청이 있습니다.

1.11.1.1. 버전 정보

버전 : 2.5.0

1.11.1.2. URI 스키마

BasePath : /kubernetes/apis
Schemes : HTTPS

1.11.1.3. 태그

  • observability.open-cluster-management.io : 멀티clusterobservabilities 생성 및 관리

1.11.2. 경로

1.11.2.1. Multiclusterobservability 리소스 생성

POST /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities
Copy to Clipboard Toggle word wrap
1.11.2.1.1. 설명

MultiClusterObservability 리소스를 생성합니다.

1.11.2.1.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

body

본문
필요

생성할 MultiClusterObservability 리소스를 설명하는 매개변수입니다.

MultiClusterObservability

1.11.2.1.3. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.11.2.1.4. Use
  • application/yaml
1.11.2.1.5. 태그
  • observability.apps.open-cluster-management.io
1.11.2.1.6. HTTP 요청의 예
1.11.2.1.6.1. 요청 본문
{
  "apiVersion": "observability.open-cluster-management.io/v1beta2",
  "kind": "MultiClusterObservability",
  "metadata": {
    "name": "example"
  },
  "spec": {
    "observabilityAddonSpec": {}
    "storageConfig": {
      "metricObjectStorage": {
        "name": "thanos-object-storage",
        "key": "thanos.yaml"
      "writeStorage": {
        - "key": " ",
          "name" : " "
        - "key": " ",
          "name" : " "
         }
       }
   }
}
Copy to Clipboard Toggle word wrap

1.11.2.2. 모든 멀티clusterobservabilities 쿼리

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities
Copy to Clipboard Toggle word wrap
1.11.2.2.1. 설명

자세한 내용은 MultiClusterObservability 리소스를 쿼리합니다.

1.11.2.2.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

1.11.2.2.3. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.11.2.2.4. Use
  • application/yaml
1.11.2.2.5. 태그
  • observability.apps.open-cluster-management.io

1.11.2.3. 단일 다중 클러스터 관찰 기능 쿼리

GET /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}
Copy to Clipboard Toggle word wrap
1.11.2.3.1. 설명

자세한 내용은 단일 MultiClusterObservability 리소스를 쿼리합니다.

1.11.2.3.2. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

경로

multiclusterobservability_name
required

쿼리할 다중 clusterobservability의 이름입니다.

string

1.11.2.3.3. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.11.2.3.4. 태그
  • observability.apps.open-cluster-management.io

1.11.2.4. Multiclusterobservability 리소스 삭제

DELETE /apis/observability.open-cluster-management.io/v1beta2/multiclusterobservabilities/{multiclusterobservability_name}
Copy to Clipboard Toggle word wrap
1.11.2.4.1. 매개 변수
Expand
유형이름설명스키마

header

COOKIE
필요

권한 부여: 베어러 {ACCESS_TOKEN} ; ACCESS_TOKEN은 사용자 액세스 토큰입니다.

string

경로

multiclusterobservability_name
required

삭제할 멀티clusterobservability의 이름입니다.

string

1.11.2.4.2. 응답
Expand
HTTP 코드설명스키마

200

성공

콘텐츠 없음

403

액세스 금지

콘텐츠 없음

404

리소스를 찾을 수 없음

콘텐츠 없음

500

내부 서비스 오류

콘텐츠 없음

503

서비스를 사용할 수 없음

콘텐츠 없음

1.11.2.4.3. 태그
  • observability.apps.open-cluster-management.io

1.11.3. 정의

1.11.3.1. MultiClusterObservability

Expand
이름설명스키마

apiVersion
필요

버전이 지정된 MultiClusterObservability 스키마입니다.

string

kind
필수

REST 리소스인 MultiClusterObservability를 나타내는 문자열 값입니다.

string

메타데이터
필요

정책을 정의하는 규칙을 설명합니다.

object

spec

Expand
이름설명스키마

enableDownsampling
optional

downsample을 활성화하거나 비활성화합니다. 기본값은 true 입니다. 다운샘플 데이터가 없으면 쿼리를 사용할 수 없습니다.

boolean

imagePullPolicy
optional

MultiClusterObservability 이미지에 대한 가져오기 정책입니다. 기본값은 Always입니다.

corev1.PullPolicy

imagePullSecret
optional

MultiClusterObservability 이미지에 대한 풀 시크릿입니다. 기본값은 multiclusterhub-operator-pull-secret입니다.

string

nodeSelector
optional

노드 선택기의 사양입니다.

map[string]string

observabilityAddonSpec
required

관찰 기능 애드온이 설치된 모든 관리 클러스터에 대한 글로벌 설정입니다.

observabilityAddonSpec

storageConfig
required

관찰 기능에서 사용할 스토리지 구성을 지정합니다.

StorageConfig

허용 오차
선택 사항

모든 구성 요소에서 테인트를 허용할 수 있는 기능이 제공됩니다.

[]corev1.Toleration

advanced
optional

관찰을 위한 고급 구성 설정입니다.

advanced

리소스
선택 사항

MultiClusterObservability에 필요한 컴퓨팅 리소스입니다.

corev1.ResourceRequirements

복제본
선택 사항

MultiClusterObservability에 대한 복제본입니다.

integer

storageConfig

Expand
이름설명스키마

alertmanagerStorageSize
optional

alertmanager 상태 저장 세트에 적용되는 스토리지 양입니다. 기본값은 1Gi 입니다.

string

compactStorageSize
optional

thanos 컴팩트 상태 저장 세트에 적용되는 스토리지 양입니다. 기본값은 100Gi 입니다.

string

metricObjectStorage
required

메트릭에 대한 시크릿을 구성하는 오브젝트 저장소입니다.

metricObjectStorage

receiveStorageSize
optional

thanos에 적용되는 스토리지 양은 상태 저장 세트를 수신합니다. 기본값은 100Gi 입니다.

string

ruleStorageSize
optional

thanos 규칙 상태 저장 세트에 적용되는 스토리지 양입니다. 기본값은 1Gi 입니다.

string

storageClass
optional

storageClass 상태 저장 세트를 지정합니다. 이 스토리지는 운영 체제가 스토리지를 생성하도록 metricObjectStorage 가 구성된 경우 오브젝트 스토리지에 사용됩니다. 기본값은 gp2 입니다.

string

storeStorageSize
optional

thanos 저장소 상태 저장 세트에 적용되는 스토리지 양입니다. 기본값은 10Gi 입니다.

string

writeStorage
optional

끝점 액세스 정보 목록입니다.

[ ]WriteStorage

writeStorage

Expand
이름설명스키마

이름
필요

엔드포인트 액세스 정보가 있는 시크릿의 이름입니다.

string


필요

선택할 시크릿의 키입니다.

string

metricObjectStorage

Expand
이름설명스키마


필요

선택할 시크릿의 키입니다. 유효한 보안 키여야 합니다. Thanos 문서를 참조하십시오.

string

이름
필요

metricObjectStorage 의 이름입니다. 자세한 내용은 Kubernetes 이름을 참조하십시오.

string

observabilityAddonSpec

Expand
이름설명스키마

enableMetrics
optional

관찰 기능 애드온이 허브 클러스터로 메트릭을 전송하는지 여부를 나타냅니다. 기본값은 true 입니다.

boolean


간격선택 사항

관찰 기능 애드온이 허브 클러스터에 지표를 전송할 때의 간격입니다. 기본값은 300초(300초)입니다.

integer

리소스
선택 사항

지표 수집기 리소스 요구 사항의 리소스입니다. 기본 CPU 요청은 100m 이며 메모리 요청은 100Mi 입니다.

corev1.ResourceRequirements

advanced

Expand
이름설명스키마

retentionConfig
optional

관찰 기능에서 사용할 데이터 보존 구성을 지정합니다.

RetentionConfig

rbacQueryProxy
optional

rbac-query-proxy 배포의 복제본 및 리소스를 지정합니다.

CommonSpec

grafana
optional

grafana 배포의 복제본 및 리소스를 지정합니다.

CommonSpec

alertmanager
optional

alertmanager statefulset의 복제본 및 리소스를 지정합니다.

CommonSpec

observatoriumAPI
optional

observatorium-api 배포를 위한 복제본 및 리소스를 지정합니다.

CommonSpec

queryFrontend
optional

query-frontend 배포의 복제본 및 리소스를 지정합니다.

CommonSpec


선택적으로 쿼리합니다.

쿼리 배포의 복제본과 리소스를 지정합니다.

CommonSpec


에서선택사항을 수신

수신 상태 저장 세트의 복제본과 리소스를 지정합니다.

CommonSpec

규칙
선택 사항

규칙 statefulset의 복제본 및 리소스를 지정합니다.

CommonSpec


저장소선택 사항입니다.

저장소 상태 저장 세트의 복제본과 리소스를 지정합니다.

CommonSpec

CompactSpec
optional

컴팩트한 statefulset에 대한 리소스를 지정합니다.

compact

storeMemcached
optional

store-memcached의 복제본, 리소스 등을 지정합니다.

storeMemcached

queryFrontendMemcached
optional

query-frontend-memcached의 복제본, 리소스 등을 지정합니다.

CacheConfig

retentionConfig

Expand
이름설명스키마

BlockDuration
선택 사항

TSDB(Time Series Database) 블록의 기간을 차단하는 시간입니다. 기본값은 2h 입니다.

string

cleanupInterval
optional

부분적으로 업로드된 블록이 정리되는 빈도와 --wait 가 활성화된 삭제 표시로 차단되는 빈도가 정리됩니다. 기본값은 5m 입니다.

string

deleteDelay
optional

삭제 표시된 블록이 버킷에서 삭제될 때까지의 시간입니다. 기본값은 48h 입니다.

string

retentionInLocal
optional

로컬 스토리지의 원시 샘플을 유지하는 시간입니다. 기본값은 24h 입니다.

string

retentionResolutionRaw
optional

버킷에서 원시 확인 샘플을 유지하는 시간입니다. 기본값은 30일 (30d)입니다.

string

retentionResolution5m
optional

버킷에 해상도 1(5분)의 샘플을 유지하는 데 걸리는 시간입니다. 기본값은 180일(180일)입니다.

string

retentionResolution1h
optional

버킷에서 해결 방법 2 시간 (1시간) 샘플을 유지하는 데 걸리는 시간입니다. 기본값은 0일(0d)입니다.

string

CompactSpec

Expand
이름설명스키마

리소스
선택 사항

thanos compact에 필요한 컴퓨팅 리소스

corev1.ResourceRequirements

serviceAccountAnnotations
optional

주석은 컴팩트 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.

map[string]string

storeMemcached

Expand
이름설명스키마

리소스
선택 사항

MultiCLusterObservability에 필요한 컴퓨팅 리소스

corev1.ResourceRequirements

복제본
선택 사항

MultiClusterObservability에 대한 복제본입니다.

integer

memoryLimitMb
optional

Memcached의 메모리 제한(MB)입니다.

integer

maxItemSize
optional

Memcached의 최대 항목 크기입니다. 기본값은 1m, min:1k, max:1024m 입니다.

string

connectionLimit
optional

Memcached의 최대 동시 연결 수입니다. 기본값은

integer

status

Expand
이름설명스키마

상태
선택 사항

status에는 MultiClusterObservability에 대한 다른 조건 상태가 포함됩니다.

metav1.Condition

CommonSpec

Expand
이름설명스키마

리소스
선택 사항

구성 요소에 필요한 컴퓨팅 리소스입니다.

corev1.ResourceRequirements

복제본
선택 사항

구성 요소의 복제본입니다.

integer

QuerySpec

Expand

이름

설명

스키마

CommonSpec
optional

쿼리 배포의 복제본과 리소스를 지정합니다.

CommonSpec

serviceAccountAnnotations
optional

주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.

map[string]string

ReceiveSpec

Expand

이름

설명

스키마

CommonSpec
optional

쿼리 배포의 복제본과 리소스를 지정합니다.

CommonSpec

serviceAccountAnnotations
optional

주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.

map[string]string

StoreSpec

Expand

이름

설명

스키마

CommonSpec
optional

쿼리 배포의 복제본과 리소스를 지정합니다.

CommonSpec

serviceAccountAnnotations
optional

주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.

map[string]string

RuleSpec

Expand

이름

설명

스키마

CommonSpec
optional

쿼리 배포의 복제본과 리소스를 지정합니다.

CommonSpec

evalInterval
optional

규칙에 대한 평가 간격을 지정합니다.

string

serviceAccountAnnotations
optional

주석은 쿼리 서비스 계정으로 저장된 구조화되지 않은 키 값 맵입니다.

map[string]string

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat