La surveillance dans Spanner Omni fonctionne de la même manière que dans Spanner, à quelques exceptions près. Ce document fournit des explications sur ces exceptions et vous renvoie vers des informations associées dans la documentation de surveillance de Spanner. Lorsque vous lisez la documentation Spanner, reportez-vous à cette page pour vérifier en quoi Spanner Omni diffère.
Fonctionnalités Spanner non compatibles
Spanner Omni est compatible avec toutes les fonctionnalités de surveillance de Spanner, à l'exception du traçage de bout en bout.
Capturer les signaux de télémétrie
Pour obtenir des insights sur les performances, l'utilisation et les problèmes potentiels, vous pouvez capturer des signaux à partir de votre base de données Spanner Omni.
Présentation de la capture de signaux
Les signaux de télémétrie vous aident à comprendre les performances de votre base de données.
Les signaux suivants sont disponibles pour Spanner Omni :
| Type de signal | Description |
|---|---|
| Métriques | Données numériques sur l'état ou les performances de la base de données. |
| Journaux | Enregistrements générés de l'activité du système au fil du temps. |
| Traces | Chemins de requête dans votre application. |
| Tableaux de statistiques | Tables intégrées pour interroger les informations de la base de données. |
Dans Spanner Omni, les métriques côté client ne sont pas acceptées. Les métriques côté client incluent les latences des métriques GFE, la collecte de métriques côté client et la collecte de métriques côté client personnalisées. Pour en savoir plus, consultez la présentation de la capture de signaux dans la documentation Spanner.
Collecte de traces
Les traces représentent le chemin d'une requête dans votre application. Elles vous permettent de suivre le flux d'une requête et vous aident à identifier la cause principale d'un problème. Par exemple, le traçage peut fournir des informations pour chaque requête d'un client, telles que des segments avec des codes temporels indiquant quand le client a envoyé et reçu des requêtes RPC. Cela vous aide à surveiller et à déboguer les requêtes de base de données.
Pour en savoir plus, consultez Présentation de la collecte de traces dans la documentation Spanner.
Configurer la collecte de traces à l'aide d'OpenTelemetry
Vous pouvez configurer les bibliothèques clientes Spanner pour exporter des traces à l'aide des API OpenTelemetry. Ce processus implique de configurer le SDK OpenTelemetry et d'utiliser un exportateur pour envoyer les données de trace à un backend d'observabilité.
Le traçage côté client n'est pas disponible pour Spanner Omni.
Pour en savoir plus, consultez Configurer la collecte de traces à l'aide d'OpenTelemetry dans la documentation Spanner.
Exporter les traces du serveur vers un collecteur
Les serveurs Spanner Omni peuvent exporter leurs propres traces au format OTLP vers un collecteur de traces, tel que Jaeger. Pour définir le collecteur, effectuez l'une des opérations suivantes :
Sur les VM, définissez la variable d'environnement
SPANNER_TRACE_EXPORTER_ENDPOINTavant de démarrer les serveurs. Pour en savoir plus, consultez Collecter et analyser des traces.Sur Kubernetes, définissez la valeur Helm
deployment.traceExporterEndpoint: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_PORTSi vous installez le chart Helm avec
monitoring.enabled=trueet que vous ne définissez pasdeployment.traceExporterEndpoint, les serveurs exportent les traces vers le collecteur Jaeger installé par le chart Helm, à l'adressedns:///jaeger.monitoring.svc.cluster.local:4317.
Les serveurs exportent les traces vers un point de terminaison de socket de domaine Unix (une cible commençant par unix: ou unix-abstract:) sans TLS, car les traces ne quittent pas l'hôte. Les serveurs traitent tous les autres collecteurs comme distants, y compris un collecteur sur localhost, une adresse IP de bouclage, un autre pod ou service, ou l'adresse IP du nœud Kubernetes (par exemple, $HOST_IP:4317 pour un collecteur DaemonSet).
Exporter des traces via TLS
À partir de la version 2026.r4-lts.3 de Spanner Omni, les serveurs d'un déploiement avec chiffrement TLS exportent les traces vers un collecteur distant uniquement via TLS. Les versions antérieures exportent les traces vers des collecteurs distants en texte brut et ne sont pas compatibles avec l'exportation de traces TLS. Pour exporter des traces vers un collecteur distant, procédez comme suit :
Créez l'autorité de certification du collecteur de traces (
ca-otlp.crt) et un certificat de collecteur pour le nom d'hôte du collecteur dans le point de terminaison de l'exportateur de traces :- Sur les VM, consultez Créer des autorités de certification et Créer le certificat du collecteur de traces.
- Sur Kubernetes, consultez Créer des autorités de certification et Créer le certificat du collecteur de traces.
Activez TLS sur le récepteur gRPC OTLP du collecteur avec le certificat du collecteur. Les exemples suivants utilisent les fichiers
collector.crtetcollector.keydu répertoireotlp-certs. Exécutez les commandes à partir du répertoire dans lequel vous avez créé les certificats, ou remplacezotlp-certspar le chemin d'accès complet à ce répertoire.Pour Jaeger v1 (
jaeger-all-in-one) sur une 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 configure TLS dans son fichier de configuration. Pour en savoir plus, consultez la documentation sur la sécurité de Jaeger.
Pour le collecteur Jaeger que le chart Helm installe avec
monitoring.enabled=true, créez un secret TLS nomméjaeger-tlsdans l'espace de nomsmonitoring:kubectl create secret tls jaeger-tls -n monitoring \ --cert=otlp-certs/collector.crt --key=otlp-certs/collector.keyÀ partir de la version 2.0.0 du chart Helm, le collecteur Jaeger diffuse TLS par défaut dans les déploiements avec chiffrement TLS, à l'aide du secret
jaeger-tls. Dans ces déploiements,helm installethelm upgradeéchouent si le secret n'existe pas, sauf si vous définissezdeployment.traceExporterEndpointsur votre propre collecteur. Pour utiliser un secret portant un nom différent, définissezmonitoring.jaeger.tls.secretName. Jaeger actualise le certificat toutes lesmonitoring.jaeger.tls.reloadInterval(par défaut :1h). Vous pouvez donc effectuer une rotation du certificat sans redémarrage.La version 2.0.0 du chart Helm nécessite la version
2026.r4-lts.3ou ultérieure de Spanner Omni. Avec les versions antérieures, utilisez la version 1.x du chart Helm.
Distribuez
ca-otlp.crtaux serveurs avec les autres certificats :- Sur les VM, copiez-le dans le répertoire de certificats de chaque serveur. Pour en savoir plus, consultez Distribuer les certificats à tous les serveurs.
Sur Kubernetes, ajoutez-le au secret
tls-certs. Pour en savoir plus, consultez Transférer les certificats, l'ensemble de clés de wrapper et le mot de passe administrateur vers le cluster Kubernetes. Pour l'ajouter à un secrettls-certsexistant sans modifier les autres clés, exécutez la commande suivante :kubectl patch secret tls-certs -n NAMESPACE --type=merge \ -p "{\"data\":{\"ca-otlp.crt\":\"$(base64 -w 0 certs/ca-otlp.crt)\"}}"
Démarrez ou redémarrez les serveurs. Les serveurs décident d'utiliser ou non TLS au démarrage, selon que
ca-otlp.crtexiste ou non. Par conséquent, l'ajout ou la suppression du fichier ne prend effet qu'après un redémarrage. Les modifications apportées à un fichier existant, telles qu'une rotation de certificat, prennent effet sans redémarrage.Sur Kubernetes, l'ajout d'une clé au secret
tls-certsne redémarre pas les serveurs. Pour les redémarrer, exécutez la commande suivante :kubectl rollout restart statefulset -n NAMESPACE \ -l app.kubernetes.io/instance=spanner-omni
Les serveurs vérifient que le certificat du collecteur est émis par ca-otlp.crt et correspond au nom d'hôte dans le point de terminaison de l'exportateur de traces. Les serveurs ne présentent pas de certificat client. Ne configurez donc pas le collecteur pour qu'il exige des certificats clients. Si ca-otlp.crt existe, les serveurs utilisent également TLS pour les collecteurs distants dans les déploiements sans chiffrement TLS.
Surveiller les traces supprimées
Dans un déploiement avec chiffrement TLS, si ca-otlp.crt n'existe pas, les serveurs n'exportent pas les traces vers un collecteur distant. Les serveurs consignent un avertissement de limitation du débit qui explique comment corriger la configuration, et comptabilisent les traces supprimées dans la métrique Prometheus opentelemetry_dropped_spans, avec l'étiquette reason définie sur secure_mode.
Avant de créer le déploiement, les serveurs ne peuvent pas déterminer si le déploiement utilise le chiffrement TLS. D'ici là, si ca-otlp.crt n'existe pas, les serveurs n'exportent pas les traces vers un collecteur distant et les comptabilisent avec l'étiquette reason définie sur deployment_state_unavailable.
Si ca-otlp.crt n'est pas un certificat CA valide, ou si le certificat du collecteur n'est pas émis par ca-otlp.crt ou ne correspond pas au nom d'hôte dans le point de terminaison de l'exportateur de traces, les connexions au collecteur échouent jusqu'à ce que vous corrigiez la configuration. La métrique opentelemetry_dropped_spans ne comptabilise pas ces échecs. Pour les détecter, vérifiez les journaux de serveur pour détecter les erreurs de handshake TLS et d'exportation de trace. Les serveurs consignent également un avertissement au démarrage si ca-otlp.crt ne contient pas de certificat PEM.
Journaux d'audit
Les journaux d'audit suivent les modifications administratives et les événements d'accès aux données à des fins de sécurité et de conformité. Vous pouvez utiliser les journaux d'audit pour surveiller les latences des requêtes en vous référant aux champs de durée de traitement. Pour en savoir plus, consultez Journaux d'audit.
Surveiller des instances
Surveillez vos instances pour vous assurer qu'elles fonctionnent comme prévu et pour vous aider à résoudre les problèmes potentiels.
Surveiller les performances d'une instance à l'aide d'insights
Le tableau de bord des insights système fournit des graphiques et des métriques pour la latence, l'utilisation du processeur, le stockage, le débit et d'autres statistiques de performances. Vous pouvez utiliser ce tableau de bord pour surveiller les instances et les bases de données Spanner Omni. Pour en savoir plus, consultez Surveiller les instances avec les insights système dans la documentation Spanner.