管理及監控 AlloyDB Omni

單一伺服器

AlloyDB Omni 會在兩個位置記錄活動：

• AlloyDB Omni 會在 data/log/postgres 記錄資料庫活動，相對於您在 dataplane.conf 設定檔中定義的目錄。

  您可以透過 /var/alloydb/config/postgresql.conf 中定義的各種 log_* 指令，自訂這個記錄檔的名稱和格式。詳情請參閱「Error Reporting 和 Logging」一文。

• AlloyDB Omni 會在 /var/alloydb/logs/alloydb.log 記錄安裝、啟動和關閉活動。

如要查看伺服器的即時執行狀態，請參閱「查看 AlloyDB Omni 的狀態」。

Kubernetes

尋找資料庫叢集記錄檔

您可以在資料庫 Pod 的檔案系統中找到 postgresql.audit 和 postgresql.log 檔案。如要存取這些檔案，請按照下列步驟操作：

1. 定義包含資料庫 Pod 名稱的環境變數。

   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. 以 root 身分在資料庫 Pod 上執行殼層。

   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 查看指標

AlloyDB Omni 的所有監控服務預設提供 alloydbomni.internal.dbadmin.goog/task-type 標籤鍵和 metricsalloydbomni 通訊埠。您可以搭配使用這些資源與單一 ServiceMonitor 自訂資源，為資料庫叢集中的所有命名空間選取所有服務。

如要進一步瞭解如何使用 Prometheus API，請參閱 Prometheus Operator 說明文件。

以下是 ServiceMonitor 自訂資源的 spec 欄位範例，其中包含 alloydbomni.internal.dbadmin.gdc.goog/task-type 標籤鍵和 metricsalloydbomni 通訊埠。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

單一伺服器

這些操作說明僅適用於 AlloyDB Omni 15.2.0 以上版本。

事前準備

機器必須安裝 1.2 以上版本的 AlloyDB Omni CLI。

執行升級作業

如要升級 AlloyDB Omni 安裝版本，請執行下列指令：

sudo alloydb database-server upgrade

Kubernetes

在 Kubernetes 中升級 AlloyDB Omni 的步驟，取決於您執行的 AlloyDB Omni 版本，以及要升級的版本。

確認目前的版本號碼

如要查看資料庫叢集使用的 AlloyDB Omni 版本，請執行下列指令：

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

更改下列內容：

• DB_CLUSTER_NAME：資料庫叢集的名稱。這與您建立資料庫叢集時宣告的名稱相同。

• NAMESPACE：資料庫叢集的 Kubernetes 命名空間。

如果您執行的是 AlloyDB Omni Operator 1.0.0 版或更新版本，這項指令會列印資料庫叢集使用的 AlloyDB Omni 版本。

如要查看 Kubernetes 叢集上安裝的 AlloyDB Omni Operator 版本，請執行下列指令：

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

如果您執行的是 AlloyDB Omni Operator 1.0.0 版或更新版本，這項指令會列印 Kubernetes 叢集上執行的 AlloyDB Omni Operator 版本號碼。

如果您執行的 AlloyDB Omni 運算子版本早於 1.0.0，就無法就地升級資料庫叢集或 AlloyDB Omni 運算子。請改為按照「從 1.0.0 之前的 AlloyDB Omni Operator 升級」一文中的操作說明進行。

如果沒有，請繼續閱讀下一節。

決定目標版本號碼

如果您執行的是 AlloyDB Omni Operator 1.0.0 以上版本，後續步驟會因要升級至哪個 AlloyDB Omni 版本而異。因此，您必須瞭解 AlloyDB Omni 版本號碼。

AlloyDB Omni 版本號碼由三部分組成：

• PostgreSQL 相容性的主要版本號碼
• PostgreSQL 相容性的子版本號碼
• 這個 AlloyDB Omni 版本的修補程式版本號碼

舉例來說，AlloyDB Omni 15.5.2 版是 AlloyDB Omni 的修補程式版本 2，支援 PostgreSQL 15.5 版。

如要升級至支援較新 PostgreSQL 版本的 AlloyDB Omni 版本，您必須一併升級 AlloyDB Omni Operator 和資料庫叢集。每組支援特定 PostgreSQL 子版本的 AlloyDB Omni 版本，都有專屬的 AlloyDB Omni Operator 版本編號，請參閱 AlloyDB Omni 版本的版本資訊。

如果只想升級至較新的 AlloyDB Omni 修補程式版本，則只需升級資料庫叢集，不必升級 AlloyDB Omni Operator。您可以跳到「升級資料庫叢集」的操作說明。

如果沒有，請繼續閱讀下一節。

升級 AlloyDB Omni Operator

如要升級 AlloyDB Omni Operator，請按照下列步驟操作：

1. 定義必要的環境變數：

   export GCS_BUCKET=alloydb-omni-operator
   export OPERATOR_VERSION=OPERATOR_VERSION
   export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

   將 OPERATOR_VERSION 替換為要升級的 AlloyDB Omni Operator 版本，例如 1.1.0。

2. 下載較新的 AlloyDB Omni Operator：

   gcloud storage cp gs://$GCS_BUCKET/$HELM_PATH ./ --recursive
   tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

3. 套用較新的 AlloyDB Omni Operator 自訂資源定義：

   kubectl apply -f alloydbomni-operator/crds

4. 升級 AlloyDB Omni Operator Helm 圖表：

   helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
   --namespace alloydb-omni-system \
   --atomic \
   --timeout 5m

如要升級 Kubernetes 資訊清單和資料庫叢集，完成 AlloyDB Omni Operator 升級作業，請在完成前述步驟後，立即按照下一節的操作說明操作。

升級資料庫叢集

如要升級資料庫叢集，請更新定義叢集的資訊清單 spec 部分中的下列欄位：

• 將 databaseVersion 設為要升級這個資料庫叢集的 AlloyDB Omni 完整版本號碼。

• 如果您也升級了 AlloyDB Omni 運算子，請將 controlPlaneAgentsVersion 設為升級後的 AlloyDB Omni 運算子完整版本號碼。

如果只升級 AlloyDB Omni 的修補程式版本 (例如從 15.5.1 更新至 15.5.2)，則只需完成這個步驟。databaseVersion

如果您要升級 PostgreSQL 相容性的子版本，例如將 databaseVersion 從 15.4.1 更新為 15.5.2，則也必須更新 controlPlaneAgentsVersion。在這種情況下，請務必按照「升級 AlloyDB Omni Operator」一文列出的額外步驟操作。

舉例來說，下列資訊清單摘錄定義了執行 AlloyDB Omni 運算子版本 15.5.2 的資料庫叢集，AlloyDB Omni 運算子版本為 1.0.0：

apiVersion: alloydbomni.dbadmin.goog/v1 
kind: DBCluster
metadata:
  name: dbcluster-sample
spec:
  databaseVersion: 15.5.2
  controlPlaneAgentsVersion: 1.0.0

在這個範例中，如要升級資料庫叢集，以便執行 AlloyDB Omni 版本 15.5.3，請將 databaseVersion: 15.5.2 變更為 databaseVersion: 15.5.3。

從 1.0.0 之前的 AlloyDB Omni Operator 版本升級

如果您執行的 AlloyDB Omni Operator 版本低於 1.0.0，則升級 Kubernetes 型 AlloyDB Omni 安裝作業時，必須先備份資料，然後解除安裝並重新安裝 AlloyDB Omni Operator。步驟如下：

1. 列出所有資料庫叢集：

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

2. 針對每個資料庫叢集，使用 pg_dumpall 指令匯出所有資料。

3. 解除安裝 AlloyDB Omni Operator。包括刪除所有資料庫叢集。

4. 重新安裝 AlloyDB Omni Operator。您可以使用與安裝舊版 AlloyDB Omni Operator 時相同的指令，不必指定新版本號碼。

5. 重新建立資料庫叢集。您可以調整先前建立資料庫叢集時使用的資訊清單檔案。您可能需要更新檔案，反映 AlloyDB Omni Operator 1.0.0 版導入的 API 變更，例如以 databaseVersion 屬性取代舊的 version 屬性。

6. 使用 pg_restore 或 psql 中的 \i 指令，將先前匯出的資料匯入重新建立的叢集。

單一伺服器

如要解除安裝 AlloyDB Omni，請執行下列指令：

sudo alloydb database-server uninstall

解除安裝 AlloyDB Omni 後，資料目錄仍會保留在檔案系統中。您可以移動、封存或刪除這個目錄，具體取決於您是否要在解除安裝 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 Operator

如要從 Kubernetes 叢集解除安裝 AlloyDB Omni Kubernetes Operator，請按照下列步驟操作：

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 Operator 刪除所有資料庫叢集。使用下列指令，檢查是否還有任何資料庫資源：

   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 Operator：

   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