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_ENDPOINTfest, bevor Sie die Server starten. Weitere Informationen finden Sie unter Traces erfassen und analysieren.Legen Sie in Kubernetes den Helm-Wert
deployment.traceExporterEndpointfest: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_PORTWenn Sie das Helm-Diagramm mit
monitoring.enabled=trueinstallieren unddeployment.traceExporterEndpointnicht festlegen, exportieren Server Traces in den Jaeger-Collector, den das Helm-Diagramm unterdns:///jaeger.monitoring.svc.cluster.local:4317installiert.
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:
Erstellen Sie die Trace-Collector-Zertifizierungsstelle (
ca-otlp.crt) und ein Collector-Zertifikat für den Collector-Hostnamen im Trace-Exporter-Endpunkt:- Informationen zu VMs finden Sie unter Zertifizierungsstellen erstellen und Trace Collector-Zertifikat erstellen.
- Informationen zu Kubernetes finden Sie unter Zertifizierungsstellen erstellen und Trace-Collector-Zertifikat erstellen.
Aktivieren Sie TLS auf dem OTLP-gRPC-Empfänger des Collectors mit dem Collector-Zertifikat. In den folgenden Beispielen werden die Dateien
collector.crtundcollector.keyim Verzeichnisotlp-certsverwendet. Führen Sie die Befehle in dem Verzeichnis aus, in dem Sie die Zertifikate erstellt haben, oder ersetzen Sieotlp-certsdurch 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-oneJaeger 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=trueinstalliert, ein TLS-Secret mit dem Namenjaeger-tlsim Namespacemonitoring:kubectl create secret tls jaeger-tls -n monitoring \ --cert=otlp-certs/collector.crt --key=otlp-certs/collector.keyAb 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 schlagenhelm installundhelm upgradefehl, wenn das Secret nicht vorhanden ist, es sei denn, Sie legendeployment.traceExporterEndpointauf Ihren eigenen Collector fest. Wenn Sie ein Secret mit einem anderen Namen verwenden möchten, legen Siemonitoring.jaeger.tls.secretNamefest. Jaeger lädt das Zertifikat allemonitoring.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.3oder höher. Verwenden Sie für frühere Releases die Helm-Diagrammversion 1.x.
Verteilen Sie
ca-otlp.crtzusammen mit den anderen Zertifikaten auf die Server:- Kopieren Sie es auf VMs in das Zertifikatsverzeichnis jedes Servers. Weitere Informationen finden Sie unter Zertifikate an alle Server verteilen.
Fügen Sie es in Kubernetes dem Secret
tls-certshinzu. Weitere Informationen finden Sie unter Zertifikate, Wrapper-Schlüsselsatz und Administratorpasswort an den Kubernetes-Cluster übertragen. Führen Sie den folgenden Befehl aus, um es einem vorhandenentls-certs-Secret hinzuzufügen, ohne die anderen Schlüssel zu ändern:kubectl patch secret tls-certs -n NAMESPACE --type=merge \ -p "{\"data\":{\"ca-otlp.crt\":\"$(base64 -w 0 certs/ca-otlp.crt)\"}}"
Starten Sie die Server oder starten Sie sie neu. Server entscheiden beim Start, ob TLS verwendet werden soll, je nachdem, ob
ca-otlp.crtvorhanden 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-certseinen 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.