Journaux et métriques pour les services de backend

Ce document vous explique comment configurer et utiliser Cloud Logging et Cloud Monitoring avec un équilibreur de charge HTTP(S) externe global (classique), un équilibreur de charge HTTP(S) externe global et Cloud CDN.

Journalisation

Vous pouvez activer, désactiver et afficher les journaux d'un service de backend d'équilibreur de charge HTTP(S) externe. Pour les équilibreurs de charge HTTP(S) externes avec des buckets backend, la journalisation est automatiquement activée et ne peut pas être désactivée.

Vous activez ou désactivez la journalisation pour chaque service de backend. Vous pouvez configurer la journalisation pour toutes les requêtes ou seulement pour une fraction échantillonnée de manière aléatoire.

Vous devez vérifier qu'aucune exclusion de journaux ne s'applique aux équilibreurs de charge HTTP(S) externes. Pour savoir comment vérifier si les journaux Cloud HTTP Load Balancer sont autorisés, consultez la section Afficher les exclusions de types de ressources.

Activer la journalisation sur un nouveau service de backend

Console

  1. Dans la console Google Cloud, accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le nom de votre équilibreur de charge.

  3. Cliquez sur Modifier ().

  4. Cliquez sur Configuration du backend.

  5. Sélectionnez Créer un service backend.

  6. Renseignez les champs obligatoires du service de backend.

  7. Cliquez sur Activer la journalisation.

  8. Dans le champ Taux d'échantillonnage, définissez la probabilité d'échantillonnage. Vous pouvez définir un nombre compris entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est 1.0.

  9. Pour terminer la modification du service de backend, cliquez sur Mettre à jour.

  10. Pour terminer la modification de l'équilibreur de charge, cliquez sur Mettre à jour.

gcloud: mode global

Créez un service de backend et activez la journalisation à l'aide de la commande gcloud compute backend-services create.

gcloud compute backend-services create BACKEND_SERVICE \
    --global \
    --enable-logging \
    --logging-sample-rate=VALUE \
    --load-balancing-scheme=EXTERNAL_MANAGED

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec les équilibreurs de charge HTTP(S) externes globaux.
  • --enable-logging active la journalisation pour ce service de backend.
  • --logging-sample-rate permet de spécifier une valeur entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. Ce paramètre n'est pertinent que lorsqu'il est associé au paramètre --enable-logging. L'activation de la journalisation en définissant le taux d'échantillonnage sur 0.0 équivaut à désactiver la journalisation. La valeur par défaut est 1.0.

gcloud : mode classique

Créez un service de backend et activez la journalisation à l'aide de la commande gcloud compute backend-services create.

gcloud compute backend-services create BACKEND_SERVICE \
 --global \
 --enable-logging \
 --logging-sample-rate=VALUE \
 --load-balancing-scheme=EXTERNAL

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec un équilibreur de charge HTTP(S) externe global (classique).
  • --enable-logging active la journalisation pour ce service de backend.
  • --logging-sample-rate permet de spécifier une valeur entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. Ce paramètre n'est pertinent que lorsqu'il est associé au paramètre --enable-logging. L'activation de la journalisation en définissant le taux d'échantillonnage sur 0.0 équivaut à désactiver la journalisation. La valeur par défaut est 1.0.

Activer la journalisation sur un service de backend existant

Console

  1. Dans la console Google Cloud, accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le nom de votre équilibreur de charge.

  3. Cliquez sur Modifier ().

  4. Cliquez sur Configuration du backend.

  5. Cliquez sur Modifier () à côté de votre service de backend.

  6. Cliquez sur Activer la journalisation.

  7. Dans le champ Taux d'échantillonnage, définissez la probabilité d'échantillonnage. Vous pouvez définir un nombre compris entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est 1.0.

  8. Pour terminer la modification du service de backend, cliquez sur Mettre à jour.

  9. Pour terminer la modification de l'équilibreur de charge, cliquez sur Mettre à jour.

gcloud: mode global

Activez la journalisation sur un service de backend existant à l'aide de la commande gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --global \
    --enable-logging \
    --logging-sample-rate=VALUE

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec les équilibreurs de charge HTTP(S) externes globaux.
  • --enable-logging active la journalisation pour ce service de backend.
  • --logging-sample-rate permet de spécifier une valeur entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. Ce paramètre n'est pertinent que lorsqu'il est associé au paramètre --enable-logging. L'activation de la journalisation en définissant le taux d'échantillonnage sur 0.0 équivaut à désactiver la journalisation. La valeur par défaut est 1.0.

gcloud : mode classique

Activez la journalisation sur un service de backend existant à l'aide de la commande gcloud compute backend-services update.

gcloud compute backend-services update BACKEND_SERVICE \
    --global \
    --enable-logging \
    --logging-sample-rate=VALUE

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec un équilibreur de charge HTTP(S) externe global (classique).
  • --enable-logging active la journalisation pour ce service de backend.
  • --logging-sample-rate permet de spécifier une valeur entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. Ce paramètre n'est pertinent que lorsqu'il est associé au paramètre --enable-logging. L'activation de la journalisation en définissant le taux d'échantillonnage sur 0.0 équivaut à désactiver la journalisation. La valeur par défaut est 1.0.

Désactiver ou modifier la journalisation sur un service de backend existant

Console

  1. Dans la console Google Cloud, accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le nom de votre équilibreur de charge.

  3. Cliquez sur Modifier ().

  4. Cliquez sur Configuration du backend.

  5. Cliquez sur Modifier () à côté de votre service de backend.

  6. Décochez la case Activer la journalisation pour désactiver complètement la journalisation.

  7. Si vous laissez la journalisation activée, vous pouvez définir une probabilité d'échantillonnage différente dans le champ Taux d'échantillonnage. Vous pouvez définir un nombre compris entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est 1.0. Pour réduire le nombre de journaux stockés à 20 %, définissez la valeur sur 0.2.

  8. Pour terminer la modification du service de backend, cliquez sur Mettre à jour.

  9. Pour terminer la modification de l'équilibreur de charge, cliquez sur Mettre à jour.

gcloud: mode global

Désactivez la journalisation sur un service de backend à l'aide de la commande gcloud compute backend-services update.

Désactiver complètement la journalisation

gcloud compute backend-services update BACKEND_SERVICE \
    --global \
    --no-enable-logging

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec les équilibreurs de charge HTTP(S) externes globaux.
  • --region indique que le service de backend est régional. Utilisez ce champ pour les services de backend utilisés avec les équilibreurs de charge HTTP(S) externes régionaux.
  • --no-enable-logging désactive la journalisation pour ce service de backend.

Modifier le taux d'échantillonnage des journaux

gcloud compute backend-services update BACKEND_SERVICE \
 --global \
 --logging-sample-rate=VALUE

gcloud : mode classique

Désactivez la journalisation sur un service de backend à l'aide de la commande gcloud compute backend-services update.

Désactiver complètement la journalisation

gcloud compute backend-services update BACKEND_SERVICE \
    --global \
    --no-enable-logging

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec un équilibreur de charge HTTP(S) externe global (classique).
  • --no-enable-logging désactive la journalisation pour ce service de backend.

Modifier le taux d'échantillonnage des journaux

gcloud compute backend-services update BACKEND_SERVICE \
 --global \
 --logging-sample-rate=VALUE

Où :

  • --global indique que le service de backend est global. Utilisez ce champ pour les services de backend utilisés avec un équilibreur de charge HTTP(S) externe global (classique).
  • --logging-sample-rate permet de spécifier une valeur entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est enregistrée et 1.0 signifie que 100 % des requêtes sont enregistrées. Ce paramètre n'est pertinent que lorsqu'il est associé au paramètre --enable-logging. L'activation de la journalisation en définissant le taux d'échantillonnage sur 0.0 équivaut à désactiver la journalisation.

Afficher les journaux

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

Les journaux HTTP(S) sont d'abord indexés par une règle de transfert, puis par un mappage d'URL.

Pour afficher les journaux, accédez à l'Explorateur de journaux :

Accéder à l'explorateur de journaux

  • Pour afficher tous les journaux, dans le menu de filtre Ressource, sélectionnez Équilibreur de charge HTTP Cloud > Toutes les règles de transfert.

  • Pour afficher les journaux d'une seule règle de transfert, sélectionnez un nom de règle de transfert.

  • Pour afficher les journaux d'un seul mappage d'URL, sélectionnez une règle de transfert, puis un mappage d'URL.

Les champs de journal de type booléen n'apparaissent généralement que s'ils comportent la valeur true. Si un champ booléen a la valeur false, il est omis du journal.

Le codage UTF-8 est appliqué aux champs de journaux. Les caractères qui ne sont pas au format UTF-8 sont remplacés par des points d'interrogation. Pour les équilibreurs de charge HTTP(S) externes globaux (classiques) et les équilibreurs de charge HTTP(S) externes globaux, vous pouvez exporter des métriques basées sur les journaux à l'aide de journaux de ressources (resource.type="http_load_balancer"). Les métriques créées sont basées sur la ressource "Règle d'équilibrage de charge HTTP Google Cloud (métriques basées sur les journaux)" (l7_lb_rule), disponible dans les tableaux de bord Cloud Monitoring plutôt que dans la ressource https_lb_rule.

Contenu consigné

Les entrées des journaux d'équilibreur de charge HTTP(S) externe contiennent des informations utiles pour surveiller et déboguer votre trafic HTTP(S). Les enregistrements de journal contiennent des champs obligatoires, qui sont les champs par défaut de chaque enregistrement de journal.

Champ Format du champ Type de champ : obligatoire ou facultatif Description
severity
timestamp
insertID
logName		 LogEntry Requis Champs généraux décrits dans une entrée de journal.
httpRequest HttpRequest Requis Protocole courant pour la journalisation des requêtes HTTP.

HttpRequest.protocol n'est pas renseigné pour resource.type="http_load_balancer"
resource MonitoredResource Requis

MonitoredResource est le type de ressource associé à une entrée de journal.

MonitoredResourceDescriptor décrit le schéma d'un objet MonitoredResource à l'aide d'un nom de type et d'un ensemble de libellés. Pour en savoir plus, consultez la section Libellés de ressources.
jsonPayload object (format Struct) Requis Charge utile de l'entrée de journal, exprimée sous la forme d'un objet JSON. L'objet JSON contient les champs suivants :
  • statusDetails
string Requis Le champ statusDetails contient une chaîne qui explique la raison pour laquelle l'équilibreur de charge a renvoyé l'état HTTP. Pour en savoir plus sur ces chaînes de journaux, consultez les sections Messages de réussite HTTP statusDetails et Messages d'échec HTTP statusDetails.

Libellés de ressource

Le tableau suivant liste les libellés de ressources pour resource.type="http_load_balancer".

Champ Type Description
backend_service_name string Nom du service de backend.
forwarding_rule_name string Nom de l'objet de règle de transfert.
project_id string Identifiant du projet Google Cloud associé à cette ressource.
target_proxy_name string Nom de l'objet de proxy cible référencé par la règle de transfert.
url_map_name string Nom de l'objet de mappage d'URL configuré pour sélectionner un service de backend.
zone string Zone dans laquelle l'équilibreur de charge est en cours d'exécution. La zone définie est global.

Messages de réussite HTTP statusDetails

statusDetails (réussite) Signification Codes de réponse d'accompagnement courants
byte_range_caching La requête HTTP a été diffusée à l'aide de la mise en cache de la plage d'octets Cloud CDN. Tout code de réponse pouvant être mis en cache est possible.
response_from_cache La requête HTTP a été diffusée depuis un cache Cloud CDN. Tout code de réponse pouvant être mis en cache est possible.
response_from_cache_validated Le code de retour a été défini à partir d'une entrée du cache Cloud CDN validée par un backend. Tout code de réponse pouvant être mis en cache est possible.
response_sent_by_backend La requête HTTP a bien été envoyée par proxy au backend et la réponse a été renvoyée par le backend. Le code de réponse HTTP est défini par le logiciel exécuté sur le backend.

Messages d'échec HTTP statusDetails

statusDetails (échec) Signification Codes de réponse d'accompagnement courants
aborted_request_due_to_backend_early_response Une requête avec un corps a été abandonnée, car le backend a envoyé une réponse anticipée avec un code d'erreur. La réponse a été transmise au client. La requête a été arrêtée. 4XX ou 5XX
backend_connection_closed_after_partial_response_sent La connexion au backend s'est fermée de manière inattendue après l'envoi d'une réponse partielle au client. Le code de réponse HTTP est défini par le logiciel exécuté sur le backend. Le code de réponse HTTP 0 (zéro) signifie que le backend a envoyé des en-têtes HTTP incomplets.
backend_connection_closed_before_data_sent_to_client Le backend a fermé de manière inattendue sa connexion à l'équilibreur de charge avant que la réponse ne soit envoyée par proxy au client. Cela peut se produire si l'équilibreur de charge envoie le trafic vers une autre entité. L'autre entité peut être un équilibreur de charge tiers dont le délai avant expiration TCP est inférieur à celui de l'équilibreur de charge HTTP(S) externe, qui est de 10 minutes (600 secondes). L'équilibreur de charge tiers est peut-être en cours d'exécution sur une instance de VM. Vous pouvez essayer de résoudre le problème en définissant manuellement le délai avant expiration TCP (message keepalive), sur le service cible, sur une valeur supérieure à 600 secondes. 502
backend_early_response_with_non_error_status Le backend a envoyé une réponse sans erreur (1XX ou 2XX) à une requête avant de recevoir l'intégralité du corps de la requête. 502
backend_interim_response_not_supported Le backend a envoyé une réponse 1XX provisoire à la requête alors que les réponses provisoires ne sont pas acceptées. 502
backend_response_corrupted Le corps de la réponse HTTP envoyée par le backend présente un encodage de transfert fragmenté non valide ou corrompu. Tout code de réponse possible en fonction de la nature de la corruption. Il s'agit souvent du 502.
backend_response_headers_too_long Les en-têtes de réponse HTTP envoyés par le backend dépassent la limite autorisée. Pour en savoir plus, consultez la section Taille de l'en-tête pour les équilibreurs de charge HTTP(S) externes. 502
backend_timeout Le backend a expiré lors de la génération d'une réponse. 502
banned_by_security_policy La requête a été interdite par une règle d'interdiction basée sur le taux Google Cloud Armor. 429
body_not_allowed Le client a envoyé une requête HTTP avec un corps, mais la méthode HTTP utilisée n'autorise pas de corps. 400
byte_range_caching_aborted L'équilibreur de charge a reçu une réponse indiquant que la ressource pouvait être mise en cache et acceptait les plages d'octet. Cloud CDN a reçu une réponse incohérente (par exemple, une réponse dont le code était différent du code "206 Partial Content" attendu). Cela s'est produit lors de la tentative de remplissage du cache à l'aide d'une requête de plage d'octets. L'équilibreur de charge a donc annulé la réponse au client. 2XX
byte_range_caching_forwarded_backend_response L'équilibreur de charge a reçu une réponse indiquant que la ressource pouvait être mise en cache et acceptait les plages d'octet. Cloud CDN a reçu une réponse incohérente (par exemple, une réponse dont le code était différent du code "206 Partial Content" attendu). Cela s'est produit lors de la tentative de remplissage du cache à l'aide d'une requête de plage d'octets. L'équilibreur de charge a ensuite transféré la réponse incohérente au client. Renvoyé à partir du backend. Tout code de réponse est possible.
byte_range_caching_retrieval_abandoned Le client a annulé une requête de plage d'octets ou une requête de validation lancée par Cloud CDN. Renvoyé à partir du backend. Tout code de réponse est possible.
byte_range_caching_retrieval_from_backend_failed_after_partial_response Une requête de plage d'octets ou une requête de validation lancée par Cloud CDN a rencontré une erreur. Reportez-vous à l'entrée de journal Cloud Logging correspondant à la requête lancée par Cloud CDN pour obtenir l'état détaillé du backend. 2XX
cache_lookup_failed_after_partial_response L'équilibreur de charge n'a pas pu diffuser une réponse complète à partir du cache Cloud CDN en raison d'une erreur interne. 2XX
cache_lookup_timeout_after_partial_response Le flux de recherche dans le cache Cloud CDN a expiré, car le client n'a pas récupéré le contenu au moment opportun. 2XX
client_disconnected_after_partial_response La connexion au client a été interrompue après que l'équilibreur de charge a envoyé une réponse partielle. Renvoyé à partir du backend. Tout code de réponse est possible.
client_disconnected_before_any_response La connexion au client a été interrompue avant que l'équilibreur de charge n'envoie une réponse. 0
client_timed_out Google Front End (GFE) a rendu inactive la connexion au client en raison d'un manque de progression lors de l'envoi par proxy de la requête ou de la réponse. 0 ou 408
client_cert_invalid_rsa_key_size La taille de la clé RSA d'un certificat intermédiaire ou feuille client n'est pas valide. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_unsupported_elliptic_curve_key Un client ou un certificat intermédiaire utilise une courbe elliptique non compatible. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_unsupported_key_algorithm Un client ou un certificat intermédiaire utilise un algorithme non RSA ou ECEC. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_pki_too_large L'infrastructure PKI à utiliser pour la validation dispose de plus de trois certificats intermédiaires partageant les mêmes informations "Objet" et "Clé publique d'objet". Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_chain_max_name_constraints_exceeded Un certificat intermédiaire fourni pour la validation comportait plus de 10 contraintes de nom. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_chain_invalid_eku Le certificat client ou son émetteur ne disposent pas de Extended Key Usage (EKU) qui inclut clientAuth. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_validation_timed_out Le délai a été dépassé lors de la validation de la chaîne de certificats. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_validation_search_limit_exceeded La limite de profondeur ou d'itération est atteinte lors de la tentative de validation de la chaîne de certificats. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_validation_not_performed Vous avez configuré mTLS sans configurer de clé TrustConfig. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_not_provided Le client n'a pas fourni le certificat demandé lors du handshake. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
client_cert_validation_failed La validation du certificat client échoue avec l'identifiant TrustConfig. Pour en savoir plus, consultez la section Erreurs consignées pour les connexions fermées. 0
config_not_found Aucun backend n'est configuré pour l'équilibreur de charge. 404 ou 503
direct_response L'équilibreur de charge a remplacé cette requête et renvoyé une réponse fixe. Tout code de réponse HTTP peut s'afficher en fonction de la nature du problème. Par exemple, le code de réponse HTTP 410 signifie que le backend est indisponible en raison d'un défaut de paiement.
denied_by_security_policy L'équilibreur de charge a refusé cette requête en raison d'une règle de sécurité Google Cloud Armor. Configuré dans la stratégie de sécurité.
error_uncompressing_gzipped_body Une erreur s'est produite lors de la décompression d'une réponse HTTP compressée avec gzip. 503
failed_to_connect_to_backend L'équilibreur de charge n'a pas pu se connecter au backend. Cela inclut les délais avant expiration pendant la phase de connexion. 502
failed_to_pick_backend L'équilibreur de charge n'a pas pu sélectionner un backend opérationnel pour traiter la requête. 502
failed_to_negotiate_alpn L'équilibreur de charge et le backend n'ont pas négocié un protocole de couche d'application (tel que HTTP/2) à utiliser pour communiquer entre eux via TLS. 502
headers_too_long Les en-têtes de requête dépassaient la taille maximale autorisée. 413
http_version_not_supported La version HTTP n'est pas acceptée. Actuellement, seuls les protocoles HTTP 0.9, 1.0, 1.1 et 2.0 sont compatibles. 400
internal_error Une erreur interne s'est produite au niveau de l'équilibreur de charge. Représente normalement une erreur temporaire dans l'infrastructure de l'équilibreur de charge. Relancez la requête. 4XX
invalid_external_origin_endpoint La configuration du backend externe n'est pas valide. Examinez la configuration du NEG Internet et assurez-vous qu'elle spécifie un port et une adresse FQDN/IP valides. 4XX
invalid_request_headers Les en-têtes de requêtes HTTP provenant d'un client ne sont pas valides. 400
invalid_http2_client_header_format Les en-têtes HTTP/2 d'un client ne sont pas valides. 400
multiple_iap_policies Il n'est pas possible de combiner plusieurs règles Identity-Aware Proxy (IAP). Si une règle IAP est associée à un service de backend et qu'une autre est associée à un objet sans serveur, vous devez en supprimer une, puis réessayer. Les objets sans serveur incluent App Engine, Cloud Run et Cloud Functions. 500
malformed_chunked_body Le corps de la requête n'a pas été correctement encodé en blocs. 411
request_loop_detected L'équilibreur de charge a détecté une boucle de requête. Cette boucle peut être imputable à une erreur de configuration du backend, lequel a renvoyé la requête à l'équilibreur de charge. 502
required_body_but_no_content_length La requête HTTP nécessite un corps, mais les en-têtes de requête ne comprennent pas de longueur de contenu ni d'en-tête fragmenté par encodage de transfert. 400 ou 403
secure_url_rejected Une requête avec une URL https:// a été reçue via une connexion HTTP/1.1 en texte brut. 400
ssl_san_verification_failed L'équilibreur de charge n'a pas trouvé de réseau SAN (Subject Alternative Name) dans le certificat SSL présenté par le backend correspondant au nom d'hôte configuré. 502
ssl_certificate_chain_verification_failed La vérification du certificat SSL du backend présenté par le backend a échoué. 502
throttled_by_security_policy La requête a été bloquée par une règle de limitation de Google Cloud Armor. 429
unsupported_method Le client a fourni une méthode de requête HTTP non compatible. 400
unsupported_100_continue La requête client contenait l'en-tête "Expect: 100-continue" sur un protocole qui n'est pas compatible. 400
upgrade_header_rejected La requête HTTP du client contenait l'en-tête Upgrade et a été refusée. 400
websocket_closed La connexion WebSocket a été interrompue. 101
websocket_handshake_failed Échec du handshake WebSocket. Tout code de réponse possible en fonction de la nature de l'échec du handshake.
request_body_too_large Le corps de la requête HTTP dépasse la limite maximale acceptée par le backend. Non applicable aux backends de VM. 413
handled_by_identity_aware_proxy Cette réponse a été générée par Identity-Aware Proxy lors de la validation de l'identité du client avant d'autoriser l'accès. 200, 302, 400, 401, 403, 500, 502
serverless_neg_routing_failed Impossible d'envoyer la requête NEG sans serveur. Cette erreur peut se produire lorsque la région spécifiée dans le NEG est inaccessible ou lorsque le nom de la ressource (par exemple, le nom Cloud Functions) est introuvable. 404 502
fault_filter_abort Cette erreur peut se produire si le client a configuré un filtre d'erreur et que celui-ci a été déclenché pour la requête donnée. La valeur doit être comprise entre 200 et 599.

Afficher les journaux pour la validation du certificat client mTLS

Pour afficher les erreurs consignées pour les connexions fermées lors de la validation du certificat client mutuel TLS, procédez comme suit :

Requête de la console

  1. Dans Google Cloud Console, accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Cliquez sur le bouton Afficher la requête.

  3. Collez le texte suivant dans le champ de la requête. Remplacez FORWARDING_RULE_NAME par le nom de votre règle de transfert.

    jsonPayload.statusDetails=~"client_cert"
jsonPayload.@type="type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
resource.labels.forwarding_rule_name=FORWARDING_RULE_NAME

  4. Cliquez sur Exécuter la requête.

Journalisation pour les buckets de backend

La journalisation est automatiquement activée pour les équilibreurs de charge comportant des buckets de backend. Vous ne pouvez pas modifier ni désactiver la journalisation pour les buckets de backend.

Journalisation pour Google Cloud Armor

La table des messages d'échec HTTP statusDetail contient des messages qui s'appliquent à Google Cloud Armor. Pour en savoir plus sur les journaux Google Cloud Armor, consultez la page Utiliser la journalisation des requêtes.

Interagir avec les journaux

Vous pouvez interagir avec les journaux de l'équilibreur de charge HTTP(S) externe à l'aide de l'API Cloud Logging. L'API Logging permet de filtrer de manière interactive les journaux pour lesquels des champs spécifiques sont définis. Il exporte les journaux correspondants vers Cloud Logging, Cloud Storage, BigQuery ou Pub/Sub. Pour en savoir plus sur l'API Logging, consultez la page Présentation de l'API Cloud Logging.

Surveillance

L'équilibreur de charge exporte les données de surveillance vers Cloud Monitoring.

Vous pouvez utiliser des métriques de surveillance pour effectuer les opérations suivantes :

  • Évaluer la configuration, l'utilisation et les performances d'un équilibreur de charge
  • Identifier et résoudre les problèmes
  • Améliorer l'utilisation des ressources et l'expérience utilisateur

En plus des tableaux de bord prédéfinis dans Cloud Monitoring, vous pouvez créer des tableaux de bord personnalisés, configurer des alertes et interroger les métriques via l'API Cloud Monitoring.

Afficher les tableaux de bord Cloud Monitoring prédéfinis

Cloud Monitoring fournit des tableaux de bord prédéfinis permettant de surveiller les équilibreurs de charge. Ces tableaux de bord sont automatiquement renseignés par Cloud Monitoring.

Pour accéder aux tableaux de bord prédéfinis, procédez comme suit :

  1. Accédez à Monitoring dans Google Cloud Console.

    Accéder à Monitoring

  2. Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.

  3. Sous Catégories, cliquez sur GCP.

    • Pour afficher la liste des tableaux de bord de tous vos équilibreurs de charge Google Cloud, sélectionnez le tableau de bord nommé Équilibreurs de charge Google Cloud. Pour afficher le tableau de bord d'un équilibreur de charge spécifique, localisez celui-ci dans la liste, puis cliquez sur son nom.

    • Pour n'afficher que les tableaux de bord prédéfinis de vos équilibreurs de charge HTTP(S) externes, sélectionnez le tableau de bord nommé Équilibreurs de charge HTTP(S) externes. Cette page affiche un tableau de bord indiquant les taux de réponse 5XX et la latence du backend pour tous les équilibreurs de charge HTTP(S) externes de votre projet. Elle fournit également la liste des tableaux de bord de tous les équilibreurs de charge HTTP(S) externes de votre projet.

      Vous pouvez accéder au tableau de bord de chaque équilibreur de charge. Chaque tableau de bord inclut les éléments suivants :

      • Graphiques pré-remplis qui affichent la répartition des réponses par classe de code de réponse (5XX, 4XX, 3XX, 2XX)
      • Latence totale
      • Latence du backend
      • DAR d'interface
      • Nombre de requêtes
      • Lien vers les journaux de l'équilibreur de charge

  4. Pour afficher les tableaux de bord des services tiers, revenez à la page Tableaux de bord. Sous Catégories, cliquez sur Autre.

    • Pour afficher le tableau de bord d'un service tiers spécifique, localisez-le dans la liste et cliquez sur son nom.

Définir des règles d'alerte

Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée

Vous pouvez créer des règles d'alerte pour surveiller les valeurs des métriques et être informé lorsqu'elles ne respectent pas une condition.

  1. Dans la console Google Cloud, accédez à la page Monitoring.

    Accéder à Monitoring

  2. Dans le volet de navigation Monitoring, sélectionnez  Alertes :
  3. Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
  4. Sur la page Alertes, cliquez sur Créer une règle.
  5. Pour sélectionner la métrique, développez le menu Select a metric (Sélectionner une métrique), puis procédez comme suit :
    1. Pour limiter le menu aux entrées pertinentes, saisissez Google Cloud HTTP/S Load Balancing Rule dans la barre de filtre. Si aucun résultat ne s'affiche après avoir filtré le menu, désactivez l'option Afficher seulement les ressources et les métriques actives.
    2. Pour le champ Type de ressource, sélectionnez Règle d'équilibrage de charge HTTP/S Google Cloud.
    3. Sélectionnez une Catégorie de métrique et une Métrique, puis cliquez sur Appliquer.
  6. Cliquez sur Next (Suivant).
  7. Les paramètres de la page Configurer le déclencheur d'alerte déterminent le moment où l'alerte se déclenche. Sélectionnez un type de condition et, si nécessaire, spécifiez un seuil. Pour plus d'informations, consultez la page Créer des règles d'alerte basées sur un seuil de métrique.
  8. Cliquez sur Next (Suivant).
  9. Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.
  10. (Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
  11. Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
  12. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
  13. Cliquez sur Créer une stratégie.
Pour en savoir plus, consultez Règles d'alerte.

Définir des tableaux de bord personnalisés Cloud Monitoring

Vous pouvez créer des tableaux de bord Cloud Monitoring personnalisés pour les métriques de l'équilibreur de charge :

  1. Dans la console Google Cloud, accédez à la page Monitoring.

    Accéder à Monitoring

  2. Sélectionnez Tableaux de bord > Créer un tableau de bord.

  3. Cliquez sur Ajouter un graphique, puis attribuez-lui un titre.

  4. Pour identifier la série temporelle à afficher, choisissez un type de ressource et un type de métrique :

    1. Dans la section Ressource et métrique, cliquez sur le graphique, puis sélectionnez l'une des options disponibles dans la section Sélectionner une métrique :
      • Pour un équilibreur de charge HTTP(S) externe global, sélectionnez le type de ressource Règle d'équilibrage de charge HTTP/S Google Cloud.
    2. Cliquez sur Appliquer.

  5. Pour spécifier des filtres de surveillance, cliquez sur Filtres > Ajouter un filtre.

  6. Cliquez sur Enregistrer.

Fréquence et conservation des rapports sur les métriques

Les métriques des équilibreurs de charge HTTP(S) externes sont exportées vers Cloud Monitoring par lots de précision d'une minute. Les données de surveillance sont conservées pendant six semaines. Les métriques sont basées sur l'échantillonnage du trafic (le taux d'échantillonnage est dynamique et ne peut pas être ajusté). Le tableau de bord fournit une analyse des données à des intervalles par défaut d'une heure, de six heures, d'un jour, d'une semaine et de six semaines. Vous pouvez demander manuellement une analyse à un intervalle compris entre une minute et six semaines.

Métriques de surveillance

Vous pouvez surveiller les métriques suivantes pour les équilibreurs de charge HTTP(S) externes.

Les métriques suivantes pour les équilibreurs de charge HTTP(S) externes globaux sont consignées dans Cloud Monitoring. Ces métriques sont précédées du préfixe loadbalancing.googleapis.com/.

Métrique Nom Description
Nombre de requêtes https/request_count Nombre de requêtes diffusées par l'équilibreur de charge HTTP(S) externe
Nombre d'octets de requête https/request_bytes_count Nombre d'octets envoyés en tant que requêtes par les clients à l'équilibreur de charge HTTP(S) externe
Nombre d'octets de réponse https/response_bytes_count Nombre d'octets envoyés en tant que réponses par l'équilibreur de charge HTTP(S) externe aux clients
Total des latences https/total_latencies

Distribution de la latence. La latence correspond au délai entre le premier octet de la requête reçu et le dernier octet de la réponse envoyée par le GFE.

Le total des latences est mesuré par requête/réponse. Les pauses entre les requêtes sur la même connexion qui utilisent Connection: keep-alive n'ont pas d'incidence sur la mesure. Cette mesure est généralement abaissée au 95e centile dans les vues Cloud Monitoring.

Exemple : un équilibreur de charge reçoit une requête par seconde en provenance du Royaume-Uni, avec une latence de 100 ms, et neuf requêtes par seconde en provenance des États-Unis, avec une latence de 50 ms. En une minute, il y a eu 60 requêtes en provenance du Royaume-Uni et 540 requêtes en provenance des États-Unis. Les métriques de surveillance conservent la distribution sur toutes les dimensions. Vous pouvez demander les informations suivantes :

  • Latence globale médiane (300/600) : 50 ms
  • Latence médiane au Royaume-Uni (30/60) - 100 ms
  • Latence globale au 95e centile (570/600) : 100 ms
DAR de l'interface* https/frontend_tcp_rtt Distribution du délai aller-retour (DAR) lissé mesurée pour chaque connexion entre le client et le GFE (mesurée par la pile TCP du GFE). Le DAR lissé est un algorithme qui traite les variations et les anomalies pouvant se produire dans les mesures de latence DAR.
Latences de backend* https/backend_latencies

Distribution de la latence mesurée entre le moment où le premier octet de la requête est envoyé par le proxy au backend et le moment où le proxy reçoit le dernier octet de la réponse du backend.

Pour les connexions WebSocket, les latences de backend s'appliquent à toute la durée de la session WebSocket.
Fraction par classe de code de réponse Fraction du total des réponses de l'équilibreur de charge HTTP(S) externe figurant dans chaque classe de code de réponse (2XX, 4XX, etc.). Dans Cloud Monitoring, cette valeur n'est disponible que dans les tableaux de bord par défaut. Elle n'est pas disponible dans les tableaux de bord personnalisés. Vous pouvez utiliser l'API pour définir des alertes pour cette métrique.
Nombre de requêtes des backends https/backend_request_count Nombre de requêtes envoyées par l'équilibreur de charge HTTP(S) externe aux backends
Nombre d'octets de requête des backends https/backend_request_bytes_count Nombre d'octets envoyés en tant que requêtes de l'équilibreur de charge HTTP(S) externe aux backends
Nombre d'octets de réponse des backends https/backend_response_bytes_count Nombre d'octets envoyés en tant que réponses par les backends (y compris le cache) à l'équilibreur de charge HTTP(S) externe
* Il n'est pas garanti que la somme du DAR d'interface et des latences de backend soit inférieure ou égale au total des latences. En effet, bien que nous interrogions le DAR sur le socket du GFE au client au moment où l'accusé de réception de la réponse HTTP est envoyé, nous dépendons des rapports du noyau pour certaines des mesures, et nous ne pouvons pas garantir que le noyau aura une mesure du DAR spécifique pour la réponse HTTP concernée. Le résultat final est une valeur DAR lissée qui est également affectée par les précédentes réponses HTTP, les demandes de synchronisation/accusés de réception (SYN/ACK) et les handshakes SSL qui n'affectent pas les durées réelles des requêtes HTTP.

Filtrer les dimensions pour les métriques

Vous pouvez appliquer des filtres pour les métriques de l'équilibreur de charge HTTP(S) externe.

Les métriques sont agrégées pour chaque équilibreur de charge HTTP(S) externe global. Vous pouvez filtrer les métriques agrégées selon les dimensions suivantes pour resource.type="http_load_balancer".

Propriété Description
backend_scope Champ d'application Google Cloud (région ou zone) du groupe d'instances de service de backend ayant diffusé la connexion.

Si aucun groupe d'instances n'était disponible ou si la requête a été diffusée par une autre entité, l'une des valeurs suivantes s'affiche au lieu de la région ou la zone du groupe d'instances de service de backend.

  • FRONTEND_5XX : une erreur interne s'est produite avant que le GFE ne puisse sélectionner un backend. Le GFE a renvoyé un code 5XX au client.
  • INVALID_BACKEND : le GFE n'a pas pu trouver un backend opérationnel auquel attribuer la requête. Par conséquent, il a renvoyé une réponse 5XX au demandeur.
  • NO_BACKEND_SELECTED : une erreur ou une autre interruption s'est produite avant qu'un backend ne puisse être sélectionné.
  • SERVED_FROM_BACKEND_BUCKET : un bucket backend a traité la requête.
  • SERVED_FROM_CACHE : un cache GFE a traité la requête. Aucun backend n'a donc été attribué.
  • MULTIPLE_BACKENDS : la requête a potentiellement été diffusée par plusieurs backends. Le cache a envoyé une ou plusieurs requêtes de plage d'octets à un autre backend. Utilisez la répartition BACKEND_SCOPE pour visualiser chaque requête de l'équilibreur de charge vers le backend.

Une fois cette répartition effectuée, les graphiques affichent les métriques de backend (équilibreur de charge vers les backends), et non les métriques d'interface (client vers équilibreur de charge).
backend_scope = "backend_zone" Si le groupe d'instances était zonal, il s'agit de la zone Google Cloud du groupe d'instances ayant diffusé la requête du client. (Exemples :us-central1-a,europe-west1-b, asia-east1-c)

Une fois cette répartition effectuée, les graphiques affichent les métriques de backend (équilibreur de charge vers backends), et non les métriques d'interface (client vers équilibreur de charge).
backend_scope = "backend_region" Si le groupe d'instances était régional, il s'agit de la région Google Cloud du groupe d'instances ayant diffusé la requête du client. (Exemples :us-central1,europe-west1, asia-east1)

Une fois cette répartition effectuée, les graphiques affichent les métriques de backend (équilibreur de charge vers backends), et non les métriques d'interface (client vers équilibreur de charge).
proxy_continent Continent du GFE HTTP(S) ayant mis fin à la connexion HTTP(S) de l'utilisateur. Exemples : America, Europe, Asia.
backend_type = "INSTANCE GROUP" Nom du groupe d'instances ayant diffusé la requête du client.

Si aucun groupe d'instances n'était disponible ou si la requête a été diffusée par une autre entité, l'une des valeurs suivantes s'affiche au lieu d'un groupe d'instances.

  • FRONTEND_5XX : une erreur interne s'est produite avant que le GFE ne puisse sélectionner un backend. Le GFE a renvoyé un code 5XX au client.
  • INVALID_BACKEND : le GFE n'a pas pu trouver un backend opérationnel auquel attribuer la requête. Par conséquent, il a renvoyé une réponse 5XX au demandeur.
  • NO_BACKEND_SELECTED : une erreur ou une autre interruption s'est produite avant qu'un backend ne puisse être sélectionné.
  • SERVED_FROM_BACKEND_BUCKET : un bucket backend a traité la requête.
  • SERVED_FROM_CACHE : Cloud CDN a traité la requête. Aucun backend n'a donc été attribué.
  • MULTIPLE_BACKENDS : plusieurs backends ont diffusé la requête.

Une fois cette répartition effectuée, les graphiques affichent les métriques de backend (équilibreur de charge vers les backends), et non les métriques d'interface (client vers équilibreur de charge).
backend_target_type = "BACKEND_SERVICE" Nom du service de backend ayant diffusé la requête du client.
matched_url_path_rule Règle de chemin de mappage d'URL correspondant au préfixe de la requête HTTP(S) (50 caractères maximum).
forwarding_rule_name Nom de la règle de transfert utilisée par le client pour envoyer la requête.

Étapes suivantes