AlloyDB Omni Kubernetes 연산자 맞춤 리소스 모니터링

이 페이지에서는 kube-state-metrics(KSM)를 사용하여 AlloyDB Omni Kubernetes 운영자 맞춤 리소스의 상태를 모니터링하는 방법을 설명합니다.

Kubernetes 운영자로 KSM을 실행하면 다음을 수행할 수 있습니다.

  • Prometheus 호환 관측성 스택에서 AlloyDB Omni 측정항목과 함께 맞춤 리소스 상태를 실시간으로 모니터링합니다.
  • 맞춤 리소스 측정항목을 기반으로 대시보드와 알림을 빌드하여 운영 가시성을 개선하고 문제를 사전에 감지합니다.

kube-state-metrics에 관한 자세한 내용은 개요를 참고하세요. kube-state-metrics가 Kubernetes 커스텀 리소스를 모니터링하는 방법을 알아보려면 커스텀 리소스 상태 측정항목을 참고하세요.

AlloyDB Omni Kubernetes 연산자 맞춤 리소스 작동 방식

기본적으로 맞춤 리소스 측정항목은 사용 설정되어 있지 않습니다. AlloyDB Omni Kubernetes 연산자 Helm 차트를 사용하여 커스텀 리소스 측정항목을 사용 설정할 수 있습니다. 맞춤 리소스 측정항목을 사용 설정하면 맞춤 리소스 측정항목을 정의하는 configmap와 KSM 배포의 측정항목 엔드포인트를 노출하는 ClusterIP 유형의 서비스로 KSM 배포가 생성됩니다. Prometheus 수집기에서 측정항목을 수집할 수 있으며, 다른 AlloyDB Omni 측정항목으로 이러한 측정항목을 시각화할 수 있습니다. 자세한 내용은 AlloyDB Omni Kubernetes 운영자의 맞춤 리소스 측정항목을 참고하세요.

시작하기 전에

다음 조건을 충족하는지 확인하세요.

  • Kubernetes 클러스터에서 실행되는 Prometheus 호환 측정항목 스크레이퍼입니다.
  • registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0에 호스팅된 kube-state-metrics 이미지에 액세스합니다. 이미지를 비공개 레지스트리로 미리 가져올 수 있습니다.
  • helm 패키지 관리자 Linux 명령줄 터미널에서 Helm 명령어를 실행합니다.

커스텀 리소스 측정항목이 사용 설정된 Kubernetes 운영자 설치

AlloyDB Omni Kubernetes 운영자 Helm 차트에서 다음 변수를 사용하여 커스텀 리소스 측정항목의 설치 및 삭제를 제어합니다.

변수 유형 설명 기본

crdMetrics.enabled

불리언 (true/false) 맞춤 리소스 측정항목 사용 설정 및 중지 false (사용 중지)

crdMetrics.ksmImage

문자열 ksmImage의 전체 경로

registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0

아직 연산자 Helm 차트를 설치하지 않았다면 Helm 설치를 실행할 때 변수를 설정합니다.

맞춤 리소스 측정항목이 사용 설정된 Kubernetes 운영자를 설치하려면 다음 단계를 따르세요.

  1. Linux 명령줄 터미널을 엽니다.

  2. 다음 명령어를 실행하여 다음 환경 변수를 정의합니다.

    export GCS_BUCKET=alloydb-omni-operator
export HELM_PATH=$(gcloud storage cat gs://$GCS_BUCKET/latest)
export OPERATOR_VERSION="${HELM_PATH%%/*}"

  3. AlloyDB Omni Kubernetes 연산자를 다운로드합니다.

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

  4. registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0의 공개 KSM 이미지를 비공개 레지스트리로 미리 가져온 경우 이 단계를 건너뛰고 다음 단계로 진행합니다. 그렇지 않으면 맞춤 리소스 측정항목으로 AlloyDB Omni Kubernetes 운영자를 설치한 후 이 절차의 마지막 단계로 진행합니다.

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--set crdMetrics.enabled=true \
--atomic \
--timeout 5m

  5. 환경 변수를 내보냅니다.

    export KSM_IMAGE=<full path to your KSM image>

  6. 맞춤 리소스 측정항목과 자체 KSM 이미지 위치가 포함된 AlloyDB Omni Kubernetes 연산자를 설치하려면 다음 명령어를 실행합니다.

    helm install alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--create-namespace \
--namespace alloydb-omni-system \
--set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \
--atomic \
--timeout 5m

    설치에 성공하면 다음과 같은 출력이 반환됩니다.

    NAME: alloydbomni-operator
LAST DEPLOYED: CURRENT_TIMESTAMP
NAMESPACE: alloydb-omni-system
STATUS: deployed
REVISION: 1
TEST SUITE: None

  7. 다운로드한 AlloyDB Omni Kubernetes 연산자 설치 파일을 삭제하여 설치를 정리합니다. 파일 이름은 alloydbomni-operator-VERSION_NUMBER.tgz이며 현재 작업 디렉터리에 있습니다.

기존 Kubernetes 운영자에 커스텀 리소스 측정항목 사용 설정

AlloyDB Omni Kubernetes 연산자 버전 1.3.0 이상이 이미 설치되어 있는 경우 기존 연산자를 업그레이드하여 맞춤 리소스 측정항목을 사용 설정할 수 있습니다.

  1. Linux 명령줄 터미널을 엽니다.

  2. 다음 명령어를 실행하여 현재 AlloyDB Omni Kubernetes 운영자 버전을 찾고 환경 변수를 정의합니다.

    export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system  -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]')

OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"}

echo $OPERATOR_VERSION

export GCS_BUCKET=alloydb-omni-operator

export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    출력은 설치된 AlloyDB Omni Kubernetes 연산자 버전입니다(예: 1.3.0).

  3. 지정된 버전 운영자를 다운로드합니다.

    gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive

  4. 다음 명령어를 실행하여 AlloyDB Omni Kubernetes 연산자를 업그레이드한 후 이 절차의 마지막 단계로 이동합니다. registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.14.0의 공개 KSM 이미지를 비공개 레지스트리로 사전 가져온 경우 이 단계를 건너뛰고 다음 단계로 바로 진행합니다.

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--reuse-values \
--set crdMetrics.enabled=true \
--atomic \
--timeout 5m

  5. 환경 변수를 내보냅니다.

    export KSM_IMAGE=<full path to your KSM image>

  6. 업그레이드를 실행하려면 다음 명령어를 실행합니다.

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--reuse-values \
--set crdMetrics.enabled=true,crdMetrics.ksmImage=${KSM_IMAGE} \
--atomic \
--timeout 5m

    업그레이드에 성공하면 다음과 같은 출력이 반환됩니다.

    NAME: alloydbomni-operator
LAST DEPLOYED: CURRENT_TIMESTAMP
NAMESPACE: alloydb-omni-system
STATUS: deployed
REVISION: 2
TEST SUITE: None

기존 Kubernetes 운영자에서의 커스텀 리소스 측정항목 사용 중지

  1. Linux 명령줄 터미널을 엽니다.

  2. 다음 명령어를 실행합니다.

    export OPERATOR_VERSION=$(helm ls -n alloydb-omni-system  -o json | jq -r 'map(select(.name == "alloydbomni-operator") | .chart)| .[0]')

OPERATOR_VERSION=${OPERATOR_VERSION#"alloydbomni-operator-"}

  3. 커스텀 리소스 측정항목을 사용 중지하려면 다음 명령어를 실행합니다.

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--reuse-values \
--set crdMetrics.enabled=false \
--atomic \
--timeout 5m

Prometheus API를 사용하여 측정항목 보기

측정항목을 보려면 Prometheus API를 사용하여 측정항목 보기를 참고하세요.

다음 단계