Présentation de la surveillance

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_ENDPOINT avant 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_PORT
    

    Si vous installez le chart Helm avec monitoring.enabled=true et que vous ne définissez pas deployment.traceExporterEndpoint, les serveurs exportent les traces vers le collecteur Jaeger installé par le chart Helm, à l'adresse dns:///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 :

  1. 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 :

  2. Activez TLS sur le récepteur gRPC OTLP du collecteur avec le certificat du collecteur. Les exemples suivants utilisent les fichiers collector.crt et collector.key du répertoire otlp-certs. Exécutez les commandes à partir du répertoire dans lequel vous avez créé les certificats, ou remplacez otlp-certs par 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-one
      

      Jaeger 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-tls dans l'espace de noms monitoring :

      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 install et helm upgrade échouent si le secret n'existe pas, sauf si vous définissez deployment.traceExporterEndpoint sur votre propre collecteur. Pour utiliser un secret portant un nom différent, définissez monitoring.jaeger.tls.secretName. Jaeger actualise le certificat toutes les monitoring.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.3 ou ultérieure de Spanner Omni. Avec les versions antérieures, utilisez la version 1.x du chart Helm.

  3. Distribuez ca-otlp.crt aux serveurs avec les autres certificats :

  4. Démarrez ou redémarrez les serveurs. Les serveurs décident d'utiliser ou non TLS au démarrage, selon que ca-otlp.crt existe 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-certs ne 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.

Étapes suivantes