AlloyDB Omni verwalten und überwachen

Einzelserver

Führen Sie zum Abrufen von AlloyDB Omni-Logs standardmäßig Folgendes aus:

  docker logs CONTAINER_NAME

  podman logs CONTAINER_NAME

Kubernetes

Logdateien des Datenbankclusters suchen

Die Dateien postgresql.audit und postgresql.log befinden sich im Dateisystem des Datenbank-Pods. postgresql.audit ist nur vorhanden, wenn Sie pgaudit aktiviert haben.

So greifen Sie auf diese Dateien zu:

1. Definieren Sie eine Umgebungsvariable, die den Namen des Datenbank-Pods enthält.

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

   Ersetzen Sie DB_CLUSTER_NAME durch den Namen Ihres Datenbankclusters. Das ist derselbe Datenbankclustername, den Sie beim Erstellen des Clusters angegeben haben.

2. Führen Sie eine Shell im Datenbank-Pod als Root aus.

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

3. Die Logdateien finden Sie im Verzeichnis /obs/diagnostic/:

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

Monitoring-Dienste auflisten

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-Messwerte über die Befehlszeile aufrufen

Der Port 9187 wird für alle Monitoring-Dienste als metricsalloydbomni bezeichnet.

1. Richten Sie die Portweiterleitung von Ihrer lokalen Umgebung zum Monitoring-Dienst ein.

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

   Ersetzen Sie Folgendes:

   • MONITORING_SERVICE: Der Name des Monitoring-Dienstes, den Sie weiterleiten möchten, z. B. al-1060-dbc-monitoring-system.

   • NAMESPACE: Der Namespace, zu dem Ihr Cluster gehört.

   • MONITORING_METRICS_PORT: Ein lokal verfügbarer TCP-Port.

   Die folgende Antwort zeigt, dass die Dienste weitergeleitet werden.

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

2. Während der vorherige Befehl ausgeführt wird, können Sie über HTTP auf dem angegebenen Port auf Monitoring-Messwerte zugreifen. Mit curl können Sie beispielsweise alle Messwerte als Nur-Text anzeigen lassen:

   curl http://localhost:MONITORING_METRICS_PORT/metrics
   

Messwerte mit der Prometheus API ansehen

Der Label-Schlüssel alloydbomni.internal.dbadmin.goog/task-type und der Port metricsalloydbomni sind standardmäßig für alle Monitoring-Dienste in AlloyDB Omni verfügbar. Sie können sie zusammen mit einer einzelnen benutzerdefinierten serviceMonitor-Ressource verwenden, um alle Dienste für alle Namespaces in Ihrem Datenbankcluster auszuwählen.

Weitere Informationen zur Verwendung der Prometheus API finden Sie in der Prometheus Operator-Dokumentation.

Das folgende Beispiel zeigt das Feld spec der benutzerdefinierten Ressource serviceMonitor, das den Label-Schlüssel alloydbomni.internal.dbadmin.gdc.goog/task-type und den Port metricsalloydbomni enthält. Die benutzerdefinierte Ressource serviceMonitor überwacht und erfasst alle Kubernetes-Dienste in allen Namespaces.

Weitere Informationen zur vollständigen ServiceMonitor-Definition finden Sie in der benutzerdefinierten Ressourcendefinition für 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

Messwerte mit Grafana ansehen

Verwenden Sie das Monitoring-Dashboard, um Messwerte in AlloyDB Omni auf Kubernetes visuell darzustellen. Das Monitoring-Dashboard basiert auf einem grundlegenden Observability-Stack, der aus Prometheus und Grafana besteht. So konfigurieren Sie das Monitoring-Dashboard, um Messwerte aus AlloyDB Omni zu erfassen:

1. Verwenden Sie den Befehl wget, um das Grafana-Dashboard herunterzuladen:

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

2. Sie müssen den grafana-operator herunterladen und installieren, bevor Sie Grafana in Kubernetes bereitstellen. Eine ausführliche Anleitung finden Sie unter Installation.

3. Fügen Sie der Grafana-Instanz, auf der Sie das Dashboard installieren, das Label monitoring.dashboard/product=alloydb-omni hinzu:

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

   Ersetzen Sie Folgendes:

   • GRAFANA_INSTANCE_NAME: Der Name der Grafana-Instanz, in der Sie das Dashboard platzieren.
   • NAMESPACE: Der Namespace, in dem Sie den Grafana-Operator bereitgestellt haben.

4. Verwenden Sie den folgenden Befehl, um die Grafana-Dashboardkonfiguration auf Ihren AlloyDB Omni-Cluster in Kubernetes anzuwenden:

   kubectl apply -f alloydbomni_dashboard.yaml -n NAMESPACE
   

   Informationen zur Verwendung des Grafana-Operators finden Sie in der Dokumentation zum Grafana-Operator.

5. Informationen zum Konfigurieren von Grafana für die Verwendung von Prometheus als Datenquelle finden Sie unter Datenquellen.

6. So prüfen Sie, ob Grafana richtig konfiguriert ist:

   • Die Sammlung von Grafana-Panels finden Sie im AlloyDB Omni-Dashboard.

   • Informationen zum Grafana-Dashboard in einem Kubernetes-Cluster abrufen:

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

     Wenn der Befehl True zurückgibt, wurde alloydb-omni-dashboard erfolgreich in der Grafana-Instanz bereitgestellt.

Einzelserver

Wenn Sie AlloyDB Omni deinstallieren möchten, beenden und löschen Sie den AlloyDB Omni-Container mit dem folgenden Befehl:

 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

Sie können ein externes Datenverzeichnis verschieben, archivieren oder löschen, je nachdem, ob und wie Sie Ihre Daten nach der Deinstallation von AlloyDB Omni beibehalten möchten.

Kubernetes

Datenbankcluster löschen

Wenn Sie Ihren Datenbankcluster löschen möchten, legen Sie isDeleted im Manifest auf true fest. Dazu können Sie den folgenden Befehl verwenden.

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

Ersetzen Sie DB_CLUSTER_NAME durch den Namen Ihres Datenbankclusters. Das ist derselbe Datenbankclustername, den Sie beim Erstellen des Clusters angegeben haben.

AlloyDB Omni-Operator deinstallieren

So deinstallieren Sie den AlloyDB Omni Kubernetes-Operator aus Ihrem Kubernetes-Cluster:

1. Löschen Sie alle Ihre Datenbankcluster:

   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. Warten Sie, bis der AlloyDB Omni Kubernetes-Operator alle Ihre Datenbankcluster gelöscht hat. Mit dem folgenden Befehl können Sie prüfen, ob noch Datenbankressourcen vorhanden sind:

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

3. Löschen Sie andere Ressourcen, die vom AlloyDB Omni Kubernetes-Operator erstellt wurden:

   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. Deinstallieren Sie den AlloyDB Omni Kubernetes-Operator:

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

5. Bereinigen Sie Secrets, benutzerdefinierte Ressourcendefinitionen und Namespaces, die mit dem AlloyDB Omni Kubernetes-Operator zusammenhängen:

   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