AlloyDB Omni 관리 및 모니터링

단일 서버

기본적으로 AlloyDB Omni 로그를 가져오려면 다음을 실행하세요.

  docker logs CONTAINER_NAME

  podman logs CONTAINER_NAME

Kubernetes

데이터베이스 클러스터 로그 파일 찾기

postgresql.audit 및 postgresql.log 파일은 데이터베이스 포드의 파일 시스템에 있습니다. postgresql.audit은(는) pgaudit을 사용 설정한 경우에만 표시됩니다.

이러한 파일에 액세스하려면 다음 단계를 따르세요.

1. 데이터베이스 포드 이름이 포함된 환경 변수를 정의합니다.

   export DB_POD=`kubectl get pod -l alloydbomni.internal.dbadmin.goog/dbcluster=DB_CLUSTER_NAME,alloydbomni.internal.dbadmin.goog/task-type=database -o jsonpath='{.items[0].metadata.name}'`

   DB_CLUSTER_NAME을 데이터베이스 클러스터 이름으로 바꿉니다. 데이터베이스 클러스터를 만들 때 선언한 데이터베이스 클러스터 이름과 동일합니다.

2. 데이터베이스 포드에서 루트로 셸을 실행합니다.

   kubectl exec ${DB_POD} -it -- /bin/bash

3. /obs/diagnostic/ 디렉터리에서 로그 파일을 찾습니다.

   • /obs/diagnostic/postgresql.audit
   • /obs/diagnostic/postgresql.log

모니터링 서비스 나열

kubectl get svc -n NAMESPACE | grep monitoring

al-1060-dbc-monitoring-system   ClusterIP   10.0.15.227   <none>        9187/TCP   7d20h
al-3de6-dbc-monitoring-system   ClusterIP   10.0.5.205    <none>        9187/TCP   7d19h
al-4bc0-dbc-monitoring-system   ClusterIP   10.0.15.92    <none>        9187/TCP   7d19h

kubectl get svc -n NAMESPACE | grep monitoring

al-2953-dbcluster-foo7-monitoring-db           ClusterIP   10.36.3.243    <none>        9187/TCP   44m
al-2953-dbcluster-foo7-monitoring-system       ClusterIP   10.36.7.72     <none>        9187/TCP   44m

명령줄에서 Prometheus 측정항목 보기

포트 9187은 모든 모니터링 서비스에서 metricsalloydbomni로 이름이 지정됩니다.

1. 로컬 환경에서 모니터링 서비스로 포트 전달을 설정합니다.

   kubectl port-forward service/MONITORING_SERVICE -n NAMESPACE MONITORING_METRICS_PORT:metricsalloydbomni
   

   다음을 바꿉니다.

   • MONITORING_SERVICE: 전달하려는 모니터링 서비스의 이름입니다(예: al-1060-dbc-monitoring-system).

   • NAMESPACE: 클러스터가 속한 네임스페이스입니다.

   • MONITORING_METRICS_PORT: 사용 가능한 로컬 TCP 포트입니다.

   다음 응답은 서비스가 전달되고 있음을 보여줍니다.

   Forwarding from 127.0.0.1:9187 -> 9187
   Forwarding from [::1]:9187 -> 9187
   

2. 이전 명령어가 실행되는 동안 지정한 포트의 HTTP를 통해 모니터링 측정항목에 액세스할 수 있습니다. 예를 들어 curl을 사용하여 모든 측정항목을 일반 텍스트로 볼 수 있습니다.

   curl http://localhost:MONITORING_METRICS_PORT/metrics
   

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

alloydbomni.internal.dbadmin.goog/task-type 라벨 키와 metricsalloydbomni 포트는 AlloyDB Omni의 모든 모니터링 서비스에 기본값으로 제공됩니다. 단일 serviceMonitor 커스텀 리소스와 함께 사용하여 데이터베이스 클러스터의 모든 네임스페이스에 있는 모든 서비스를 선택할 수 있습니다.

Prometheus API 사용에 대한 자세한 내용은 Prometheus Operator 문서를 참고하세요.

다음은 alloydbomni.internal.dbadmin.gdc.goog/task-type 라벨 키와 metricsalloydbomni 포트를 포함하는 serviceMonitor 커스텀 리소스의 spec 필드의 예시입니다. serviceMonitor 커스텀 리소스는 모든 네임스페이스의 모든 Kubernetes 서비스를 모니터링하고 수집합니다.

전체 ServiceMonitor 정의에 대한 자세한 내용은 ServiceMonitor 커스텀 리소스 정의 를 참고하세요.

    spec:
      selector:
        matchLabels:
          alloydbomni.internal.dbadmin.goog/task-type: monitoring
      namespaceSelector:
        any: true
      endpoints:
        - port: metricsalloydbomni

    spec:
      selector:
        matchExpressions:
        - key: alloydbomni.internal.dbadmin.gdc.goog/task-type
          operator: Exists
          values: []
      namespaceSelector:
        any: true
      endpoints:
      - port: metricsalloydbomni

Grafana를 사용하여 측정항목 보기

Kubernetes의 AlloyDB Omni에서 측정항목을 시각적으로 표현하려면 모니터링 대시보드를 사용하세요. 모니터링 대시보드는 Prometheus와 Grafana로 구성된 기본 관측 가능성 스택을 사용합니다. AlloyDB Omni에서 측정항목을 수집하도록 모니터링 대시보드를 구성하려면 다음 단계를 따르세요.

1. Grafana 대시보드를 다운로드하려면 wget 명령어를 사용합니다.

   wget https://raw.githubusercontent.com/GoogleCloudPlatform/alloydb-omni-samples/refs/heads/main/monitoring-dashboards/grafana/alloydbomni_dashboard.yaml
   

2. Kubernetes에 Grafana를 배포하기 전에 grafana-operator를 다운로드하여 설치해야 합니다. 자세한 내용은 설치를 참고하세요.

3. 대시보드를 설치할 Grafana 인스턴스에 monitoring.dashboard/product=alloydb-omni 라벨을 추가합니다.

   kubectl label grafana/GRAFANA_INSTANCE_NAME monitoring.dashboard/product=alloydb-omni -n NAMESPACE
   

   다음을 바꿉니다.

   • GRAFANA_INSTANCE_NAME: 대시보드를 배치할 Grafana 인스턴스의 이름입니다.
   • NAMESPACE: Grafana 운영자를 배포한 네임스페이스입니다.

4. Kubernetes의 AlloyDB Omni 클러스터에 Grafana 대시보드 구성을 적용하려면 다음 명령어를 사용하세요.

   kubectl apply -f alloydbomni_dashboard.yaml -n NAMESPACE
   

   Grafana 연산자 사용에 관한 자세한 내용은 Grafana 연산자 문서를 참고하세요.

5. Prometheus를 데이터 소스로 사용하도록 Grafana를 구성하려면 데이터 소스를 참고하세요.

6. Grafana가 올바르게 구성되었는지 확인하려면 다음 중 하나를 수행하세요.

   • AlloyDB Omni 대시보드에서 Grafana 패널 모음을 확인합니다.

   • Kubernetes 클러스터에서 Grafana 대시보드에 관한 정보를 가져옵니다.

     kubectl get grafanadashboard alloydb-omni-dashboard -n NAMESPACE -o jsonpath='{.status.conditions[?(@.type=="DashboardSynchronized")].status}'
     

     명령어가 True를 반환하면 alloydb-omni-dashboard이 Grafana 인스턴스에 성공적으로 배포된 것입니다.

단일 서버

AlloyDB Omni를 제거하려면 다음 명령어를 사용하여 AlloyDB Omni 컨테이너를 중지하고 삭제합니다.

 docker container stop CONTAINER_NAME
   docker container rm CONTAINER_NAME

 podman container stop CONTAINER_NAME
   podman container rm CONTAINER_NAME

 podman container stop CONTAINER_NAME
   podman container rm CONTAINER_NAME

AlloyDB Omni를 제거한 후 데이터를 보존할지 여부와 방법에 따라 외부 데이터 디렉터리를 이동, 보관 또는 삭제할 수 있습니다.

Kubernetes

데이터베이스 클러스터 삭제

데이터베이스 클러스터를 삭제하려면 매니페스트에서 isDeleted를 true로 설정합니다. 다음 명령어를 사용하여 이를 수행할 수 있습니다.

kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -p '{"spec":{"isDeleted":true}}' --type=merge

DB_CLUSTER_NAME을 데이터베이스 클러스터 이름으로 바꿉니다. 데이터베이스 클러스터를 만들 때 선언한 데이터베이스 클러스터 이름과 동일합니다.

AlloyDB Omni 연산자 제거

Kubernetes 클러스터에서 AlloyDB Omni Kubernetes 연산자를 제거하려면 다음 단계를 따르세요.

1. 모든 데이터베이스 클러스터를 삭제합니다.

   for ns in $(kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespaces -o=jsonpath='{range .items[*]}{.metadata.namespace}{"\n"}{end}'); do
   for cr in $(kubectl get dbclusters.alloydbomni.dbadmin.goog -n $ns -o=jsonpath='{range .items[*]}{.metadata.name}{"\n"}{end}'); do
   kubectl patch dbclusters.alloydbomni.dbadmin.goog $cr -n $ns --type=merge -p '{"spec":{"isDeleted":true}}'
   done
   done

2. AlloyDB Omni Kubernetes 연산자가 모든 데이터베이스 클러스터를 삭제할 때까지 기다립니다. 다음 명령어를 사용하여 데이터베이스 리소스가 남아 있는지 확인합니다.

   kubectl get dbclusters.alloydbomni.dbadmin.goog --all-namespaces

3. AlloyDB Omni Kubernetes 연산자가 만든 다른 리소스를 삭제합니다.

   kubectl delete failovers.alloydbomni.dbadmin.goog --all --all-namespaces
   kubectl delete restores.alloydbomni.dbadmin.goog --all --all-namespaces
   kubectl delete switchovers.alloydbomni.dbadmin.goog --all --all-namespaces

4. AlloyDB Omni Kubernetes 연산자를 제거합니다.

   helm uninstall alloydbomni-operator --namespace alloydb-omni-system

5. AlloyDB Omni Kubernetes 연산자와 관련된 보안 비밀, 커스텀 리소스 설명, 네임스페이스를 정리합니다.

   kubectl delete certificate -n alloydb-omni-system --all
   kubectl get secrets --all-namespaces -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,ANNOTATION:.metadata.annotations.cert-manager\.io/issuer-name | grep -E 'alloydbomni|dbs-al' | awk '{print $1 " " $2}' | xargs -n 2 kubectl delete secret -n
   kubectl delete crd -l alloydb-omni=true
   kubectl delete ns alloydb-omni-system