Mengelola dan memantau AlloyDB Omni

Server tunggal

Secara default, untuk mengambil log AlloyDB Omni, jalankan:

  docker logs CONTAINER_NAME

  podman logs CONTAINER_NAME

Kubernetes

Menemukan file log cluster database Anda

File postgresql.audit dan postgresql.log berada di sistem file pod database. postgresql.audit hanya ada jika Anda mengaktifkan pgaudit.

Untuk mengakses file ini, ikuti langkah-langkah berikut:

1. Tentukan variabel lingkungan yang berisi nama pod database.

   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}'`

   Ganti DB_CLUSTER_NAME dengan nama cluster database Anda. Nama cluster database yang sama dengan yang Anda deklarasikan saat Anda membuatnya.

2. Jalankan shell di pod database sebagai root.

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

3. Temukan file log di direktori /obs/diagnostic/:

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

Mencantumkan layanan pemantauan

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

Melihat metrik Prometheus dari command line

Port 9187 diberi nama metricsalloydbomni untuk semua layanan pemantauan.

1. Siapkan penerusan port dari lingkungan lokal Anda ke layanan pemantauan.

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

   Ganti kode berikut:

   • MONITORING_SERVICE: Nama layanan pemantauan yang ingin Anda teruskan—misalnya, al-1060-dbc-monitoring-system.

   • NAMESPACE: Namespace tempat cluster Anda berada.

   • MONITORING_METRICS_PORT: Port TCP lokal yang tersedia.

   Respons berikut menunjukkan bahwa layanan sedang diteruskan.

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

2. Saat perintah sebelumnya berjalan, Anda dapat mengakses metrik pemantauan melalui HTTP di port yang Anda tentukan. Misalnya, Anda dapat menggunakan curl untuk melihat semua metrik sebagai teks biasa:

   curl http://localhost:MONITORING_METRICS_PORT/metrics
   

Melihat metrik menggunakan Prometheus API

Kunci label alloydbomni.internal.dbadmin.goog/task-type dan port metricsalloydbomni tersedia sebagai default untuk semua layanan pemantauan di AlloyDB Omni. Anda dapat menggunakannya bersama dengan satu resource kustom serviceMonitor untuk memilih semua layanan untuk semua namespace di cluster database Anda.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan Prometheus API, lihat dokumentasi Prometheus Operator.

Berikut adalah contoh kolom spec dari resource kustom serviceMonitor yang menyertakan kunci label alloydbomni.internal.dbadmin.gdc.goog/task-type dan port metricsalloydbomni. Resource kustom serviceMonitor memantau dan mengumpulkan semua layanan Kubernetes di semua namespace

Untuk mengetahui informasi selengkapnya tentang definisi ServiceMonitor lengkap, lihat definisi resource kustom 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

Melihat metrik menggunakan Grafana

Untuk representasi visual metrik di AlloyDB Omni di Kubernetes, gunakan dasbor pemantauan. Dasbor pemantauan mengandalkan stack kemampuan observasi dasar yang terdiri dari Prometheus dan Grafana. Untuk mengonfigurasi dasbor pemantauan guna mengumpulkan metrik dari AlloyDB Omni, ikuti langkah-langkah berikut:

1. Untuk mendownload dasbor Grafana, gunakan perintah wget:

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

2. Anda harus mendownload dan menginstal grafana-operator sebelum men-deploy Grafana di Kubernetes. Untuk petunjuk mendetail, lihat Penginstalan.

3. Tambahkan label monitoring.dashboard/product=alloydb-omni ke instance Grafana tempat Anda menginstal dasbor:

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

   Ganti kode berikut:

   • GRAFANA_INSTANCE_NAME: nama instance Grafana tempat Anda menempatkan dasbor.
   • NAMESPACE: namespace tempat Anda men-deploy operator Grafana.

4. Untuk menerapkan konfigurasi dasbor Grafana ke cluster AlloyDB Omni di Kubernetes, gunakan perintah berikut:

   kubectl apply -f alloydbomni_dashboard.yaml -n NAMESPACE
   

   Lihat dokumentasi operator Grafana untuk mengetahui informasi tentang penggunaan operator Grafana.

5. Untuk mengonfigurasi Grafana agar menggunakan Prometheus sebagai sumber data, lihat Datasources.

6. Untuk memverifikasi bahwa Grafana dikonfigurasi dengan benar, lakukan salah satu hal berikut:

   • Lihat kumpulan panel Grafana di dasbor AlloyDB Omni.

   • Ambil informasi tentang dasbor Grafana di cluster Kubernetes:

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

     Jika perintah menampilkan True, alloydb-omni-dashboard berhasil di-deploy ke instance Grafana.

Server tunggal

Untuk meng-uninstal AlloyDB Omni, hentikan dan hapus container AlloyDB Omni menggunakan perintah berikut:

 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

Anda dapat memindahkan, mengarsipkan, atau menghapus direktori data eksternal, bergantung pada apakah dan bagaimana Anda ingin menyimpan data setelah meng-uninstal AlloyDB Omni.

Kubernetes

Menghapus cluster database

Untuk menghapus cluster database, tetapkan isDeleted ke true dalam manifesnya. Anda dapat melakukannya dengan perintah berikut.

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

Ganti DB_CLUSTER_NAME dengan nama cluster database Anda. Nama cluster database yang sama dengan yang Anda deklarasikan saat Anda membuatnya.

Menghapus operator AlloyDB Omni

Untuk meng-uninstal operator AlloyDB Omni Kubernetes dari cluster Kubernetes Anda, lakukan langkah-langkah berikut:

1. Hapus semua cluster database Anda:

   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. Tunggu hingga operator Kubernetes AlloyDB Omni menghapus semua cluster database Anda. Gunakan perintah berikut untuk memeriksa apakah ada resource database yang tersisa:

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

3. Hapus resource lain yang dibuat oleh operator 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. Menghapus instalasi operator AlloyDB Omni Kubernetes:

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

5. Hapus secret, deskripsi resource kustom, dan namespace yang terkait dengan operator 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