Journalisation et surveillance de l'équilibreur de charge d'application externe régional

Ce document explique comment configurer et utiliser Cloud Logging et Cloud Monitoring avec des équilibreurs de charge d'application externes régionaux.

Journalisation

Vous pouvez activer, désactiver et afficher les journaux d'un service de backend d'équilibreur de charge d'application externe.

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 d'application 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.

Champs facultatifs

Les enregistrements de journal contiennent des champs obligatoires et des champs facultatifs. La section Contenu consigné répertorie les champs facultatifs et les champs obligatoires. Tous les champs obligatoires sont toujours inclus. Vous pouvez personnaliser quels sont les champs facultatifs à conserver.

Si vous sélectionnez Inclure tous les champs facultatifs, tous les champs facultatifs du format d'enregistrement du journal sont inclus dans les journaux. Lorsque de nouveaux champs facultatifs sont ajoutés au format d'enregistrement, les journaux incluent automatiquement les nouveaux champs.
Si vous sélectionnez Exclure tous les champs facultatifs, tous les champs facultatifs sont omis.
Si vous sélectionnez Personnalisé, vous pouvez spécifier les champs facultatifs que vous souhaitez inclure, par exemple tls.protocol,tls.cipher.

Pour obtenir des instructions sur la personnalisation des champs facultatifs, consultez la section Activer la journalisation sur un nouveau service de backend.

Activer la journalisation sur un nouveau service de backend

Console

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

Accéder à 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.
Dans la section Journalisation, cochez la case 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 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.
Facultatif : pour inclure tous les champs facultatifs dans les journaux, dans la section Champs facultatifs, cliquez sur Inclure tous les champs facultatifs.
Conseil de pro : Pour spécifier l'option PERSONNALISÉ, utilisez gcloud CLI et l'API REST.
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 régional

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 \
    --region=REGION \
    --enable-logging \
    --logging-sample-rate=VALUE \
    --load-balancing-scheme=EXTERNAL_MANAGED \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Où :

--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 d'application externes régionaux.
--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.
--logging-optional vous permet de spécifier les champs facultatifs que vous souhaitez inclure dans les journaux :
- INCLUDE_ALL_OPTIONAL pour inclure tous les champs facultatifs.
- EXCLUDE_ALL_OPTIONAL (par défaut) pour exclure tous les champs facultatifs.
- CUSTOM pour inclure une liste personnalisée de champs facultatifs que vous spécifiez dans OPTIONAL_FIELDS.
--logging-optional-fields vous permet de spécifier une liste de champs facultatifs séparés par une virgule que vous souhaitez inclure dans les journaux.

Par exemple, tls.protocol,tls.cipher ne peut être défini que si LOGGING_OPTIONAL_MODE est défini sur CUSTOM.

Activer la journalisation sur un service de backend existant

Console

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

Accéder à 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.
Dans la section Journalisation, cochez la case 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 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.
Facultatif : pour inclure tous les champs facultatifs dans les journaux, dans la section Champs facultatifs, cliquez sur Inclure tous les champs facultatifs.
Conseil de pro : Pour spécifier l'option PERSONNALISÉ, utilisez gcloud CLI et l'API REST.
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 régional

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 \
    --region=REGION \
    --enable-logging \
    --logging-sample-rate=VALUE \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Où :

--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 d'application externes régionaux.
--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.
--logging-optional vous permet de spécifier les champs facultatifs que vous souhaitez inclure dans les journaux.
- INCLUDE_ALL_OPTIONAL pour inclure tous les champs facultatifs.
- EXCLUDE_ALL_OPTIONAL (par défaut) pour exclure tous les champs facultatifs.
- CUSTOM pour inclure une liste personnalisée de champs facultatifs que vous spécifiez dans OPTIONAL_FIELDS.
--logging-optional-fields vous permet de spécifier une liste de champs facultatifs séparés par une virgule que vous souhaitez inclure dans les journaux.

Par exemple, tls.protocol,tls.cipher. Ne peut être défini que si LOGGING_OPTIONAL_MODE est défini sur CUSTOM.

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.

Accéder à 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.
Pour désactiver complètement la journalisation, décochez la case Activer la journalisation dans la section 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 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.
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 régional

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 \
    --region=REGION \
    --no-enable-logging

Où :

--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 d'application 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 | --region=REGION \
 --logging-sample-rate=VALUE

Afficher les journaux

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 à la page 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 d'application externes régionaux,vous pouvez exporter des métriques basées sur les journaux à l'aide des journaux de ressources (resource.type="http_external_regional_lb_rule").

Contenu consigné

Les entrées des journaux d'équilibreur de charge d'application 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. Les enregistrements de journal contiennent des champs facultatifs qui ajoutent des informations supplémentaires sur votre trafic HTTP(S). Ils peuvent être omis pour réduire les coûts de stockage.

Le format "multi-champs" de certains champs affiche plusieurs données dans un même champ. Par exemple, le champ tls est au format TlsDetails, qui contient le protocole TLS et l'algorithme de chiffrement TLS dans un seul champ. Ces champs particuliers sont décrits dans le tableau sur le format des enregistrements ci-dessous.

Champ	Format du champ	Type de champ : obligatoire ou facultatif	Description
Champ	Format du champ	Type de champ : obligatoire ou facultatif	Description	gravité ID d'insertion code temporel Nom du journal	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 `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 : `proxyStatus` `tls` `backendTargetProjectNumber` `mtls`
	chaîne	Requis	Le champ `proxyStatus` contient une chaîne qui spécifie la raison pour laquelle l'équilibreur de charge d'application externe régional a renvoyé le `HttpRequest.status`. Ce champ n'est renseigné que lorsque le proxy renvoie un code d'erreur avec `4XX` ou `5XX`. Les valeurs possibles sont `connection_timeout`, `destination_unavailable` et `http_request_error`. Le champ n'est pas consigné si la valeur est une chaîne vide. Pour en savoir plus, consultez la section Message proxyStatus.
	TlsDetails	Facultatif	Le champ `tls` contient TlsDetails qui spécifie les métadonnées TLS pour la connexion entre le client et l'équilibreur de charge d'application externe régional. Ce champ n'est disponible que si le client utilise le chiffrement TLS/SSL.
	MtlsDetails	Facultatif	Le champ `mtls` contient la valeur MtlsDetails qui spécifie les métadonnées mTLS pour la connexion entre le client et l'équilibreur de charge d'application externe régional. Ce champ n'est disponible que si l'équilibreur de charge utilise le protocole d'authentification TLS mutuelle (mTLS) d'interface.

Remarque : Les redirections (code d'état de réponse HTTP 302 Found) émises par l'équilibreur de charge ne sont pas consignées. Les redirections émises à partir des instances backend sont consignées.

Format de champ TlsDetails

Champ	Format du champ	Type de champ : obligatoire ou facultatif	Description
protocol	chaîne	Facultatif	Protocole TLS utilisé par les clients pour établir une connexion avec l'équilibreur de charge. Les valeurs possibles sont TLS `1.0, 1.1, 1.2, 1.3`, et `QUIC`. Cette valeur est définie sur `NULL` si le client n'utilise pas le chiffrement TLS/SSL.
cipher	chaîne	Facultatif	Algorithme de chiffrement TLS que les clients peuvent utiliser pour établir une connexion avec l'équilibreur de charge. Cette valeur est définie sur `NULL` si le client n'utilise pas HTTP(S) ou s'il n'utilise pas le chiffrement TLS/SSL.

Format de champ MtlsDetails

Champ	Format du champ	Type de champ : obligatoire ou facultatif	Description
clientCertPresent	Bool	Facultatif	`true` si le client a fourni un certificat lors du handshake TLS. Sinon, `false`.
clientCertChainVerified	Bool	Facultatif	`true` si la chaîne de certificats client est validée par rapport à une configuration `TrustStore` configurée ou `false`.
clientCertError	chaîne	Facultatif	Chaînes prédéfinies représentant les conditions d'erreur. Pour plus d'informations sur les chaînes d'erreur, consultez la section Modes de validation des clients mTLS.
clientCertSha256Fingerprint	chaîne	Facultatif	Empreinte SHA-256 du certificat client, encodée en base64.
clientCertSerialNumber	chaîne	Facultatif	Numéro de série du certificat client. Si le numéro de série est plus de 50 octets, la chaîne `client_cert_serial_number_exceeded_size_limit` est ajoutée à `client_cert_error` et le numéro de série est défini sur une chaîne vide.
clientCertValidStartTime	chaîne	Facultatif	Horodatage (format de chaîne de date RFC 3339) avant lequel le certificat client n'est pas valide. Par exemple, `2022-07-01T18:05:09+00:00`.
clientCertValidEndTime	chaîne	Facultatif	Horodatage (format de chaîne de date RFC 3339) après lequel le certificat client n'est pas valide. Par exemple, `2022-07-01T18:05:09+00:00`.
clientCertSpiffeId	chaîne	Facultatif	L'ID SPIFFE du champ "Autre nom de l'objet (SAN)". Si la valeur n'est pas valide ou dépasse 2 048 octets, l'ID SPIFFE est défini sur une chaîne vide. Si l'ID SPIFFE dépasse 2 048 octets, la chaîne `client_cert_spiffe_id_exceeded_size_limit` est ajoutée à `client_cert_error`.
clientCertUriSans	chaîne	Facultatif	Liste des extensions SAN de type URI encodées en base64, séparées par une virgule. Les extensions SAN sont extraites du certificat client. L'ID SPIFFE n'est pas inclus dans le champ `client_cert_uri_sans`. Si le champ `client_cert_uri_sans` comporte plus de 512 octets, la chaîne `client_cert_uri_sans_exceeded_size_limit` est ajoutée à `client_cert_error` et la liste d'éléments séparés par des virgules est définie sur une chaîne vide.
clientCertDnsnameSans	chaîne	Facultatif	Liste des extensions SAN de type DNSName encodées en base64, séparées par une virgule. Les extensions SAN sont extraites du certificat client. Si le champ `client_cert_dnsname_sans` comporte plus de 512 octets, la chaîne `client_cert_dnsname_sans_exceeded_size_limit` est ajoutée à `client_cert_error` et la liste d'éléments séparés par des virgules est définie sur une chaîne vide.
clientCertIssuerDn	chaîne	Facultatif	Champ Issuer (émetteur) complet, encodé en base64, tiré du certificat. Si le champ `client_cert_issuer_dn` dépasse 512 octets, la chaîne `client_cert_issuer_dn_exceeded_size_limit` est ajoutée à `client_cert_error` et `client_cert_issuer_dn` est défini sur une chaîne vide.
clientCertSubjectDn	chaîne	Facultatif	Champ Subject (objet) complet, encodé en base64, tiré du certificat. Si le champ `client_cert_subject_dn` dépasse 512 octets, la chaîne `client_cert_subject_dn_exceeded_size_limit` est ajoutée à `client_cert_error` et `client_cert_subject_dn` est défini sur une chaîne vide.
clientCertLeaf	chaîne	Facultatif	Certificat d'entité finale du client pour une connexion mTLS établie où le certificat a été validé. L'encodage des certificats est conforme à RFC 9440 : le certificat DER binaire est encodé en base64 (sans sauts de ligne, espaces ni autres caractères en dehors de l'alphabet en base64) et est délimité par des signes deux-points de chaque côté. Si `client_cert_leaf` dépasse 16 Ko non encodé, `client_cert_validated_leaf_exceeded_size_limit` est défini sur `client_cert_error` et `client_cert_leaf` est défini sur une chaîne vide.
clientCertChain	chaîne	Facultatif	Liste de certificats séparés par une virgule (dans l'ordre TLS standard) de la chaîne de certificats client pour une connexion mTLS établie où le certificat client a été validé, sans inclure le certificat d'entité finale. L'encodage du certificat est conforme à la norme RFC 9440. Si la taille combinée de `client_cert_leaf` et `client_cert_chain` avant encodage en base64 dépasse 16 Ko, la chaîne `client_cert_validated_chain_exceeded_size_limit` est ajoutée à `client_cert_error` et `client_cert_chain` est défini sur une chaîne vide.

Étiquettes de ressource

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

Champ	Type	Description
`backend_name`	chaîne	Nom du groupe d'instances backend ou groupe de points de terminaison du réseau.
`backend_scope`	chaîne	Champ d'application du backend (nom de la zone ou nom de la région). Peut être `UNKNOWN` quand `backend_name` est inconnu.
`backend_scope_type`	chaîne	Champ d'application du backend (`REGION`/`ZONE`). Peut être `UNKNOWN` quand `backend_name` est inconnu.
`backend_target_name`	chaîne	Nom du backend sélectionné pour gérer la requête, en fonction de la règle de chemin de mappage d'URL ou de la règle de routage correspondant à la requête.
`backend_target_type`	chaîne	Type de la cible de backend. Peut être `BACKEND_SERVICE` ou `UNKNOWN` si le backend n'a pas été attribué.
`backend_type`	chaîne	Type du groupe de backend. Peut être `INSTANCE_GROUP`, `NETWORK_ENDPOINT_GROUP` ou `UNKNOWN` si le backend n'a pas été attribué.
`forwarding_rule_name`	chaîne	Nom de l'objet de règle de transfert.
`matched_url_path_rule`	chaîne	Règle de chemin de mappage d'URL ou règle de routage configurée dans le cadre de la clé de mappage d'URL. En cas d'absence de correspondance, ce champ peut prendre la valeur `UNMATCHED` ou `UNKNOWN`. `UNMATCHED` fait référence à une requête qui ne correspond à aucune règle de chemin d'URL, et utilise donc la règle de chemin par défaut. `UNKNOWN` indique une erreur interne.
`network_name`	chaîne	Nom du réseau VPC de l'équilibreur de charge.
`project_id`	chaîne	Identifiant du projet Google Cloud associé à cette ressource.
`region`	chaîne	Région dans laquelle l'équilibreur de charge est défini.
`target_proxy_name`	chaîne	Nom de l'objet de proxy cible référencé par la règle de transfert.
`url_map_name`	chaîne	Nom de l'objet de mappage d'URL configuré pour sélectionner un service de backend.

Message proxyStatus

Filtrer ce tableau :

proxyStatus	Signification	Codes de réponse d'accompagnement courants
`destination_unavailable`	L'équilibreur de charge considère que le backend est indisponible. Par exemple, les tentatives récentes de communication avec le backend ont échoué, ou une vérification d'état peut indiquer un échec.	500, 503
`connection_timeout`	La tentative d'ouverture d'une connexion au backend par l'équilibreur de charge a expiré.	504
`connection_terminated`	La connexion de l'équilibreur de charge au backend a été fermée avant la réception d'une réponse complète.	502, 503
`connection_refused`	La connexion de l'équilibreur de charge au backend a été refusée.	502, 503
`connection_limit_reached`	L'équilibreur de charge est configuré pour limiter le nombre de connexions au backend dont il dispose, et cette limite a été dépassée.	502, 503
`destination_not_found`	L'équilibreur de charge ne peut pas déterminer le backend approprié à utiliser pour cette requête. Par exemple, il peut ne pas être configuré.	500, 404
`dns_error`	L'équilibreur de charge a rencontré une erreur DNS lors de la tentative de recherche d'une adresse IP pour le nom d'hôte du backend.	502, 503
`http_response_timeout`	L'équilibreur de charge a atteint une limite de temps configurée en attente de la réponse complète du backend.	504, 408
`http_request_error`	L'équilibreur de charge génère une réponse client (4xx) au nom du client.	400, 403, 405, 406, 408, 411, 413, 414, 415, 416, 417 ou 429
`proxy_configuration_error`	L'équilibreur de charge a rencontré une erreur concernant sa configuration.	500
`http_protocol_error`	L'équilibreur de charge a rencontré une erreur de protocole HTTP lors de la communication avec le backend.	502
`proxy_internal_error`	L'équilibreur de charge a rencontré une erreur interne.	500, 502
`proxy_internal_response`	L'équilibreur de charge a généré la réponse sans tenter de se connecter au backend.	Tout code d'état HTTP peut s'afficher en fonction du type de problème. Par exemple, le code d'état HTTP "410" signifie que le backend n'est pas disponible en raison d'un défaut de paiement.

Interagir avec les journaux

Vous pouvez interagir avec les journaux de l'équilibreur de charge d'application 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.

Définir des règles d'alerte

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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis Alertes :
Accéder à l'interface des 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 Sélectionner une métrique, puis procédez comme suit :
1. Pour limiter le menu aux entrées pertinentes, saisissez Regional External Application Load Balancer 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'équilibreur de charge d'application externe régional.
3. Sélectionnez une Catégorie de métrique et une Métrique, puis cliquez sur Appliquer.
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.

Pour plus d'informations, consultez la page 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 :

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

Accéder à 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 :
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 :
2. Pour un équilibreur de charge d'application externe régional, sélectionnez le type de ressource Règle d'équilibreur de charge d'application externe régional.
3. Cliquez sur Appliquer.
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 d'application 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 d'application externes.

Les métriques suivantes pour les équilibreurs de charge d'application externes régionaux sont consignées dans Cloud Monitoring. Ces métriques sont précédées du préfixe loadbalancing.googleapis.com/.

Filtrer ce tableau :

Métrique	Nom	Description
Nombre de requêtes	`https/external/regional/request_count`	Nombre de requêtes diffusées par l'équilibreur de charge d'application externe régional.
Nombre d'octets de requête	`https/external/regional/request_bytes`	Nombre d'octets envoyés en tant que requêtes par les clients à l'équilibreur de charge d'application externe régional.
Nombre d'octets de réponse	`https/external/regional/response_bytes`	Nombre d'octets envoyés en tant que réponses au client depuis l'équilibreur de charge d'application externe régional.
Total des latences	`https/external/regional/total_latencies`	Distribution de la latence, en millisecondes. La latence est mesurée entre le moment où le proxy reçoit le premier octet de la requête et le moment où le proxy envoie le dernier octet de la réponse.
Latences de backend	`https/external/regional/backend_latencies`	Distribution de la latence, en millisecondes. La latence est mesurée entre le moment où le proxy envoie le premier octet de la requête au backend et le moment où le proxy reçoit le dernier octet de la réponse du backend.

Filtrer les dimensions pour les métriques

Vous pouvez appliquer des filtres de métriques pour les équilibreurs de charge d'application externes.

Les métriques sont agrégées pour chaque équilibreur de charge d'application externe régional. Vous pouvez filtrer les métriques agrégées à l'aide des dimensions suivantes pour resource.type="http_external_regional_lb_rule".

Filtrer ce tableau :

Propriété	Description
`backend_name`	Nom du groupe d'instances backend ou groupe de points de terminaison du réseau.
`backend_scope`	Champ d'application du backend (nom de la zone ou nom de la région). Peut être `UNKNOWN` quand `backend_name` est inconnu.
`backend_scope_type`	Champ d'application du backend (`REGION`/`ZONE`). Peut être `UNKNOWN` quand `backend_name` est inconnu.
`backend_target_name`	Nom du backend sélectionné pour gérer la requête, en fonction de la règle de chemin de mappage d'URL ou de la règle de routage correspondant à la requête.
`backend_target_type`	Type de la cible de backend. Peut être `BACKEND_SERVICE` ou `UNKNOWN` si le backend n'a pas été attribué.
`backend_type`	Type du groupe de backend. Peut être `INSTANCE_GROUP`, `NETWORK_ENDPOINT_GROUP` ou `UNKNOWN` si le backend n'a pas été attribué.
`forwarding_rule_name`	Nom de l'objet de règle de transfert.
`matched_url_path_rule`	Règle de chemin de mappage d'URL ou règle de routage configurée dans le cadre de la clé de mappage d'URL. En cas d'absence de correspondance, ce champ peut prendre la valeur `UNMATCHED` ou `UNKNOWN`. `UNMATCHED` fait référence à une requête qui ne correspond à aucune règle de chemin d'URL, et utilise donc la règle de chemin par défaut. `UNKNOWN` indique une erreur interne.
`network_name`	Nom du réseau VPC de l'équilibreur de charge.
`project_id`	Identifiant du projet Google Cloud associé à cette ressource.
`region`	Région dans laquelle l'équilibreur de charge est défini.
`target_proxy_name`	Nom de l'objet de proxy cible référencé par la règle de transfert.
`url_map_name`	Nom de l'objet de mappage d'URL configuré pour sélectionner un service de backend.

Étapes suivantes

Consultez les informations conceptuelles sur les équilibreurs de charge d'application externes.