Monitoring-Übersicht

Das Monitoring in Spanner Omni funktioniert ähnlich wie das Monitoring in Spanner, mit einigen Ausnahmen. In diesem Dokument werden diese Ausnahmen erläutert und Sie finden Verweise auf zugehörige Informationen in der Spanner-Monitoring-Dokumentation. Wenn Sie die Spanner-Dokumentation lesen, können Sie auf dieser Seite nachsehen, wie sich Spanner Omni unterscheidet.

Nicht unterstützte Spanner-Funktionen

Spanner Omni unterstützt alle Spanner-Monitoring-Funktionen mit Ausnahme des End-to-End-Tracings.

Telemetriesignale erfassen

Wenn Sie Einblicke in die Leistung, Nutzung und potenzielle Probleme erhalten möchten, können Sie Signale aus Ihrer Spanner Omni-Datenbank erfassen.

Übersicht über die Signalerfassung

Telemetriesignale helfen Ihnen, die Leistung Ihrer Datenbank zu verstehen.

Die folgenden Signale sind für Spanner Omni verfügbar:

Signaltyp Beschreibung
Messwerte Numerische Daten zum Zustand oder zur Leistung der Datenbank.
Logs Generierte Aufzeichnungen der Systemaktivität im Zeitverlauf.
Traces Anfragepfade durch Ihre Anwendung.
Statistiktabellen Integrierte Tabellen zum Abfragen von Datenbankinformationen.

In Spanner Omni werden clientseitige Messwerte nicht unterstützt. Clientseitige Messwerte umfassen Latenzen für GFE-Messwerte, die clientseitige Messwerterfassung und die benutzerdefinierte clientseitige Messwerterfassung. Weitere Informationen finden Sie in der Spanner-Dokumentation unter Übersicht über die Signalerfassung.

Trace-Sammlung

Traces stellen den Pfad einer Anfrage durch Ihre Anwendung dar. Sie können damit den Ablauf einer Anfrage verfolgen und die Ursache eines Problems ermitteln. Das Tracing kann beispielsweise Informationen zu jeder Anfrage von einem Client liefern, z. B. Spans mit Zeitstempeln, die angeben, wann der Client RPC-Anfragen gesendet und empfangen hat. So können Sie Datenbankanfragen überwachen und Fehler beheben.

Weitere Informationen finden Sie in der Spanner-Dokumentation unter Trace-Erfassung – Übersicht.

Trace-Erfassung mit OpenTelemetry einrichten

Sie können Spanner-Clientbibliotheken so konfigurieren, dass Traces mithilfe von OpenTelemetry-APIs exportiert werden. Dazu müssen Sie das OpenTelemetry SDK konfigurieren und einen Exporter verwenden, um Trace-Daten an ein Beobachtbarkeits-Backend zu senden.

Clientseitiges Tracing ist für Spanner Omni nicht verfügbar.

Weitere Informationen finden Sie in der Spanner-Dokumentation unter Trace-Erfassung mit OpenTelemetry einrichten.

Server-Traces in einen Collector exportieren

Spanner Omni-Server können ihre eigenen Traces im OTLP-Format in einen Trace-Collector wie Jaeger exportieren. Führen Sie einen der folgenden Schritte aus, um den Collector festzulegen:

  • Legen Sie auf VMs die Umgebungsvariable SPANNER_TRACE_EXPORTER_ENDPOINT fest, bevor Sie die Server starten. Weitere Informationen finden Sie unter Traces erfassen und analysieren.

  • Legen Sie in Kubernetes den Helm-Wert deployment.traceExporterEndpoint fest:

    helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \
        --version 2.0.0 \
        --namespace NAMESPACE \
        --reuse-values \
        --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORT
    

    Wenn Sie das Helm-Diagramm mit monitoring.enabled=true installieren und deployment.traceExporterEndpoint nicht festlegen, exportieren Server Traces in den Jaeger-Collector, den das Helm-Diagramm unter dns:///jaeger.monitoring.svc.cluster.local:4317 installiert.

Server exportieren Traces ohne TLS an einen Unix-Domain-Socket-Endpunkt (ein Ziel, das mit unix: oder unix-abstract: beginnt), da die Traces den Host nicht verlassen. Server behandeln jeden anderen Collector als Remote-Collector, einschließlich eines Collectors auf localhost, einer Loopback-IP-Adresse, eines anderen Pods oder Dienstes oder der IP-Adresse des Kubernetes-Knotens (z. B. $HOST_IP:4317 für einen DaemonSet-Collector).

Traces über TLS exportieren

Ab Spanner Omni-Release 2026.r4-lts.3 exportieren Server in einer Bereitstellung mit TLS-Verschlüsselung Traces nur über TLS an einen Remote-Collector. In früheren Releases werden Traces im Klartext an Remote-Collectors exportiert und der TLS-Trace-Export wird nicht unterstützt. So exportieren Sie Traces in einen Remote-Collector:

  1. Erstellen Sie die Trace-Collector-Zertifizierungsstelle (ca-otlp.crt) und ein Collector-Zertifikat für den Collector-Hostnamen im Trace-Exporter-Endpunkt:

  2. Aktivieren Sie TLS auf dem OTLP-gRPC-Empfänger des Collectors mit dem Collector-Zertifikat. In den folgenden Beispielen werden die Dateien collector.crt und collector.key im Verzeichnis otlp-certs verwendet. Führen Sie die Befehle in dem Verzeichnis aus, in dem Sie die Zertifikate erstellt haben, oder ersetzen Sie otlp-certs durch den vollständigen Pfad zu diesem Verzeichnis.

    • Für Jaeger v1 (jaeger-all-in-one) auf einer VM:

      export COLLECTOR_OTLP_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt
      export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key
      jaeger-all-in-one
      

      Jaeger v2 konfiguriert TLS stattdessen in seiner Konfigurationsdatei. Weitere Informationen finden Sie in der Jaeger-Sicherheitsdokumentation.

    • Erstellen Sie für den Jaeger-Collector, den das Helm-Diagramm mit monitoring.enabled=true installiert, ein TLS-Secret mit dem Namen jaeger-tls im Namespace monitoring:

      kubectl create secret tls jaeger-tls -n monitoring \
          --cert=otlp-certs/collector.crt --key=otlp-certs/collector.key
      

      Ab Helm-Diagrammversion 2.0.0 stellt der Jaeger-Collector in Bereitstellungen mit TLS-Verschlüsselung standardmäßig TLS bereit und verwendet dazu das Secret jaeger-tls. In diesen Deployments schlagen helm install und helm upgrade fehl, wenn das Secret nicht vorhanden ist, es sei denn, Sie legen deployment.traceExporterEndpoint auf Ihren eigenen Collector fest. Wenn Sie ein Secret mit einem anderen Namen verwenden möchten, legen Sie monitoring.jaeger.tls.secretName fest. Jaeger lädt das Zertifikat alle monitoring.jaeger.tls.reloadInterval (Standard: 1h) neu, sodass Sie das Zertifikat ohne Neustart rotieren können.

      Helm-Diagrammversion 2.0.0 erfordert Spanner Omni-Release 2026.r4-lts.3 oder höher. Verwenden Sie für frühere Releases die Helm-Diagrammversion 1.x.

  3. Verteilen Sie ca-otlp.crt zusammen mit den anderen Zertifikaten auf die Server:

  4. Starten Sie die Server oder starten Sie sie neu. Server entscheiden beim Start, ob TLS verwendet werden soll, je nachdem, ob ca-otlp.crt vorhanden ist. Das Hinzufügen oder Entfernen der Datei wird also erst nach einem Neustart wirksam. Änderungen an einer vorhandenen Datei, z. B. eine Zertifikatsrotation, werden ohne Neustart wirksam.

    In Kubernetes werden die Server nicht neu gestartet, wenn Sie dem Secret tls-certs einen Schlüssel hinzufügen. Führen Sie den folgenden Befehl aus, um sie neu zu starten:

    kubectl rollout restart statefulset -n NAMESPACE \
        -l app.kubernetes.io/instance=spanner-omni
    

Server prüfen, ob das Zertifikat des Collectors von ca-otlp.crt ausgestellt wurde und mit dem Hostnamen im Trace-Exporter-Endpunkt übereinstimmt. Server weisen kein Clientzertifikat vor. Konfigurieren Sie den Collector daher nicht so, dass Clientzertifikate erforderlich sind. Wenn ca-otlp.crt vorhanden ist, verwenden Server auch TLS für Remote-Collectors in Bereitstellungen ohne TLS-Verschlüsselung.

Verworfene Traces überwachen

Wenn ca-otlp.crt in einer Bereitstellung mit TLS-Verschlüsselung nicht vorhanden ist, exportieren Server keine Traces an einen Remote-Collector. Server protokollieren eine Warnung zur Ratenbegrenzung, in der erläutert wird, wie die Konfiguration korrigiert werden kann. Außerdem werden die verworfenen Traces im Prometheus-Messwert opentelemetry_dropped_spans gezählt, wobei das Label reason auf secure_mode gesetzt ist.

Bevor Sie die Bereitstellung erstellen, können Server nicht feststellen, ob die Bereitstellung TLS-Verschlüsselung verwendet. Bis dahin exportieren Server, wenn ca-otlp.crt nicht vorhanden ist, keine Traces an einen Remote-Collector und zählen sie mit dem Label reason, das auf deployment_state_unavailable gesetzt ist.

Wenn ca-otlp.crt kein gültiges CA-Zertifikat ist oder das Zertifikat des Collectors nicht von ca-otlp.crt ausgestellt wurde oder nicht mit dem Hostnamen im Trace-Exporter-Endpunkt übereinstimmt, schlagen Verbindungen zum Collector fehl, bis Sie die Konfiguration korrigiert haben. Der Messwert opentelemetry_dropped_spans zählt diese Fehler nicht. Prüfen Sie die Server-Logs auf TLS-Handshake- und Trace-Exportfehler, um sie zu erkennen. Server protokollieren beim Start auch eine Warnung, wenn ca-otlp.crt kein PEM-Zertifikat enthält.

Audit-Logs

In Audit-Logs werden administrative Änderungen und Datenzugriffsereignisse aus Sicherheits- und Compliance-Gründen erfasst. Sie können Audit-Logs verwenden, um die Anfragelatenzen zu überwachen, indem Sie sich die Felder für die Verarbeitungsdauer ansehen. Weitere Informationen finden Sie unter Audit-Logs.

Instanzen überwachen

Überwachen Sie Ihre Instanzen, um sicherzustellen, dass sie wie erwartet funktionieren, und um potenzielle Probleme zu beheben.

Instanzleistung mithilfe von Statistiken überwachen

Das Systemstatistik-Dashboard bietet Diagramme und Messwerte für Latenz, CPU-Auslastung, Speicher, Durchsatz und andere Leistungsstatistiken. Mit diesem Dashboard können Sie Spanner Omni-Instanzen und -Datenbanken überwachen. Weitere Informationen finden Sie unter Instanzen mit Systemstatistiken überwachen in der Spanner-Dokumentation.

Nächste Schritte