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
Dans la console Google Cloud, accédez à la page Équilibrage de charge.
Cliquez sur le nom de votre équilibreur de charge.
Cliquez sur Modifier (
).Cliquez sur Configuration du backend.
Sélectionnez Créer un service backend.
Renseignez les champs obligatoires du service de backend.
Cliquez sur Activer la journalisation.
Dans le champ Taux d'échantillonnage, définissez la probabilité d'échantillonnage. Vous pouvez définir un nombre compris entre
0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.0
signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est1.0
.Pour terminer la modification du service de backend, cliquez sur Mettre à jour.
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 entre0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.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 sur0.0
équivaut à désactiver la journalisation. La valeur par défaut est1.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 entre0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.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 sur0.0
équivaut à désactiver la journalisation. La valeur par défaut est1.0
.
Activer la journalisation sur un service de backend existant
Console
Dans la console Google Cloud, accédez à la page Équilibrage de charge.
Cliquez sur le nom de votre équilibreur de charge.
Cliquez sur Modifier (
).Cliquez sur Configuration du backend.
Cliquez sur Modifier (
) à côté de votre service de backend.Cliquez sur Activer la journalisation.
Dans le champ Taux d'échantillonnage, définissez la probabilité d'échantillonnage. Vous pouvez définir un nombre compris entre
0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.0
signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est1.0
.Pour terminer la modification du service de backend, cliquez sur Mettre à jour.
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 entre0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.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 sur0.0
équivaut à désactiver la journalisation. La valeur par défaut est1.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 entre0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.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 sur0.0
équivaut à désactiver la journalisation. La valeur par défaut est1.0
.
Désactiver ou modifier la journalisation sur un service de backend existant
Console
Dans la console Google Cloud, accédez à la page Équilibrage de charge.
Cliquez sur le nom de votre équilibreur de charge.
Cliquez sur Modifier (
).Cliquez sur Configuration du backend.
Cliquez sur Modifier (
) à côté de votre service de backend.Décochez la case Activer la journalisation pour désactiver complètement la journalisation.
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
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.0
signifie que 100 % des requêtes sont enregistrées. La valeur par défaut est1.0
. Pour réduire le nombre de journaux stockés à 20 %, définissez la valeur sur0.2
.Pour terminer la modification du service de backend, cliquez sur Mettre à jour.
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 entre0.0
et1.0
, où0.0
signifie qu'aucune requête n'est enregistrée et1.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 sur0.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 :
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.
|
resource | MonitoredResource | Requis | MonitoredResource est le type de ressource associé à une entrée de journal. MonitoredResourceDescriptor décrit le schéma d'un objet |
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 :
|
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 pourresource.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
Dans Google Cloud Console, accédez à la page Explorateur de journaux.
Cliquez sur le bouton Afficher la requête.
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
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 :
Accédez à Monitoring dans Google Cloud Console.
Dans le panneau de navigation Monitoring, cliquez sur Tableaux de bords.
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
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 :
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.
- Dans la console Google Cloud, accédez à la page Monitoring.
- Dans le volet de navigation Monitoring, sélectionnez notifications Alertes :
- 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.
- Sur la page Alertes, cliquez sur Créer une règle.
- Pour sélectionner la métrique, développez le menu Select a metric (Sélectionner une métrique), puis procédez comme suit :
- 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. - Pour le champ Type de ressource, sélectionnez Règle d'équilibrage de charge HTTP/S Google Cloud.
- Sélectionnez une Catégorie de métrique et une Métrique, puis cliquez sur Appliquer.
- Pour limiter le menu aux entrées pertinentes, saisissez
- Cliquez sur Next (Suivant).
- 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.
- Cliquez sur Next (Suivant).
- 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.
- (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.
- Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
- Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
- Cliquez sur Créer une stratégie.
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 :
Dans la console Google Cloud, accédez à la page Monitoring.
Sélectionnez Tableaux de bord > Créer un tableau de bord.
Cliquez sur Ajouter un graphique, puis attribuez-lui un titre.
Pour identifier la série temporelle à afficher, choisissez un type de ressource et un type de métrique :
- 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.
- Cliquez sur Appliquer.
- 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 spécifier des filtres de surveillance, cliquez sur Filtres > Ajouter un filtre.
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 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 :
|
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 |
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.
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.
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
- Consultez la présentation de la journalisation Cloud CDN.
- En savoir plus sur la mise en cache.
- En savoir plus sur les URL et cookies signés.