Journalisation et surveillance des encadrés Cloud Load Balancing

Cette page vous explique comment configurer et utiliser Cloud Logging et Cloud Monitoring avec des appels d'extensions de service pour Cloud Load Balancing.

Journalisation

Cette section décrit la journalisation des appels d'équilibreur de charge d'application.

Activer la journalisation sur un service de backend

Vous pouvez activer la journalisation pour les appels d'équilibreur de charge d'application lors de la création du service en activant la journalisation sur le service de backend qui est la cible d'une requête (et non sur le service de backend associé à l'extension).

Pour activer la journalisation du service de backend cible, utilisez la gcloud compute backend-services update commande.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-logging \
    --logging-sample-rate=RATE \
    --region=REGION \
    --logging-optional=LOGGING_OPTIONAL_MODE \
    --logging-optional-fields=OPTIONAL_FIELDS

Remplacez les éléments suivants :

  • BACKEND_SERVICE : nom du service de backend
  • RATE : valeur comprise entre 0.0 et 1.0, où 0.0 signifie qu'aucune requête n'est journalisée et 1.0 signifie que 100% des requêtes sont journalisées. La valeur par défaut est 1.0. Ce paramètre n'est effectif que lorsqu'il est utilisé avec le enable-logging paramètre. Lorsque vous omettez enable-logging, la journalisation est désactivée.
  • REGION : région du backend

  • LOGGING_OPTIONAL_MODE : active la journalisation des champs facultatifs dans l'un des modes suivants :

    • INCLUDE_ALL_OPTIONAL inclut tous les champs facultatifs.
    • EXCLUDE_ALL_OPTIONAL (par défaut) exclut tous les champs facultatifs.
    • CUSTOM inclut une liste personnalisée de champs facultatifs.
  • OPTIONAL_FIELDS : liste de champs facultatifs séparés par une virgule lorsque vous sélectionnez le CUSTOM mode

Une fois la journalisation activée sur le service de backend, les requêtes HTTP ou HTTPS sont journalisées à l'aide des journaux Cloud Logging.

Pour afficher les journaux, accédez à la page Explorateur de journaux dans la Google Cloud console.

Pour en savoir plus, consultez les pages "Surveillance et dépannage" de la documentation sur l'équilibreur de charge d'application, telles que Journalisation et surveillance de l'équilibreur de charge d'application interne.

Messages de journal pour un service de backend

En général, les entrées de journal de l'équilibreur de charge d'application contiennent des informations utiles pour surveiller et déboguer votre trafic HTTP ou HTTPS. Il s'agit des types d'informations suivants :

  • Informations affichées dans la plupart des Google Cloud journaux, telles que la gravité, ID du projet, numéro du projet et horodatage, comme décrit dans le LogEntry.
  • HttpRequest.

Les journaux de requêtes pour les équilibreurs de charge HTTP et HTTPS contiennent un objet service_extension_info dans la charge utile JSON de l'entrée de journal de l'équilibreur de charge avec les informations suivantes :

Champ Type Description
backend_target_name chaîne Nom de la cible de backend de l'extension.
backend_target_type chaîne Type de la cible de backend.
chain chaîne Nom de la chaîne d'extension dans la ressource d'extension de service qui correspond à la requête.
extension chaîne Nom de l'extension dans la chaîne d'extension.
failed_open booléen Lorsque la configuration de l'extension est définie sur failOpen défini sur true, la valeur true pour cette métrique indique que le traitement s'est poursuivi lorsque l'extension a expiré ou a échoué.

S'applique uniquement aux équilibreurs de charge d'application externes régionaux, aux équilibreurs de charge d'application internes régionaux et aux équilibreurs de charge d'application internes interrégionaux.
grpc_status enum Dernier état du flux gRPC. Pour en savoir plus, consultez la section Codes d'état gRPC.
per_processing_request_info tableau Liste des statistiques ProcessingRequest pour les extensions ext_proc ou des statistiques CheckRequest pour les extensions ext_authz qui se produisent sur le flux gRPC.
per_processing_request_info[].event_type enum Type d'événement de ProcessingRequest. Les valeurs possibles sont les suivantes : REQUEST_HEADERS, REQUEST_BODY, RESPONSE_HEADERS, ou RESPONSE_BODY.
per_processing_request_info[].latency duration Durée entre le moment où le premier octet du ProcessingRequest message est envoyé à l'extension et le moment où le dernier octet du ProcessingResponse message est reçu.
per_processing_request_info[].processing_effect enum Résultat du traitement pour chaque événement d'une requête de traitement.

S'applique uniquement aux équilibreurs de charge d'application externes régionaux, aux équilibreurs de charge d'application internes régionaux et aux équilibreurs de charge d'application internes interrégionaux.

Les valeurs possibles sont les suivantes :

  • NONE : indique que le contenu n'a pas été modifié.
  • NONE_FAILED_OPEN : indique qu'aucune mutation n'a été effectuée, car l'extension a échoué.
  • CONTENT_MODIFIED : indique que le contenu a été modifié par une requête de mutation appliquée avec succès.
  • IMMEDIATE_RESPONSE : indique qu'une réponse immédiate a été envoyée par l'extension pour interrompre tout traitement ultérieur.
  • MUTATION_REJECTED : indique que l'extension a demandé au moins une modification non autorisée et que le traitement ultérieur a été interrompu. Les messages d'erreur appropriés sont consignés.
  • UNSPECIFIED : indique que l'effet du traitement n'est pas connu.
per_processing_request_info[].processing_effect_details chaîne Lorsque processing_effect est MUTATION_REJECTED, les détails expliquant pourquoi une mutation a été rejetée.

S'applique uniquement aux équilibreurs de charge d'application externes régionaux, équilibreurs de charge d'application internes régionaux et équilibreurs de charge d'application internes interrégionaux.
resource chaîne Nom de la ressource d'extension

Surveillance

Cette section explique comment surveiller les appels configurés à l'aide des extensions de service pour Cloud Load Balancing.

Afficher un tableau de bord Monitoring

Les équilibreurs de charge d'application exportent les données de surveillance vers Cloud Monitoring.

Utilisez les métriques Monitoring aux fins suivantes :

  • Évaluation de la configuration, de l'utilisation et des performances d'un équilibreur de charge
  • Résolution des problèmes
  • Amélioration de l'utilisation des ressources et de l'expérience utilisateur

Pour afficher un tableau de bord prédéfini, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Présentation des tableaux de bord.

    Accéder à la page de présentation des tableaux de bord

  2. Dans la section Catégories, cliquez sur GCP.
    • Pour afficher la liste des tableaux de bord de tous vos équilibreurs de charge, cliquez sur le tableau de bord nommé Équilibreurs de charge Google Cloud dans la liste Tableaux de bord GCP. Pour afficher le tableau de bord d'un équilibreur de charge spécifique, recherchez-le dans la liste puis cliquez sur son nom.
    • Pour afficher les tableaux de bord prédéfinis uniquement pour vos équilibreurs de charge, sélectionnez le tableau de bord approprié.

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

Pour en savoir plus, consultez les pages "Surveillance et dépannage" de la documentation sur l'équilibreur de charge d'application, telles que Journalisation et surveillance de l'équilibreur de charge d'application interne.

Métriques de surveillance pour les appels

Vous pouvez surveiller les métriques suivantes pour les services de backend d'appel.

En version preview, vous pouvez surveiller les métriques suivantes pour les extensions sur tous les types d'équilibreurs de charge d'application. Ces métriques sont précédées du préfixe networkservices.googleapis.com. Le préfixe est omis des entrées du tableau suivant.

Le tableau suivant fournit le type de métrique, le nom à afficher, le type, l'unité et la description de chaque métrique.

Type de métrique Nom à afficher
Type, Unité
Description
extension/invocation_count Nombre d'appels d'extension
DELTA, INT64, 1
Nombre d'appels envoyés à l'extension.
extension/invocation_latencies Latences d'appel d'extension
DELTA, DISTRIBUTION, ms
Distribution calculée à partir de la latence de chaque appel d'extension.
extension/sent_chunks_count Nombre de blocs envoyés par l'extension
DELTA, INT64, 1
Applicable uniquement aux événements request_body et response_body. Nombre de blocs de données envoyés à l'extension.
extension/received_chunks_count Nombre de blocs reçus par l'extension
DELTA, INT64, 1
Applicable uniquement aux événements request_body et response_body. Nombre de blocs reçus de l'extension.
extension/failed_open_count Nombre d'appels d'extension ayant échoué avec fail-open
DELTA, INT64, 1
Nombre d'échecs d'un appel lorsque le système était configuré pour échouer et que la requête était autorisée à se poursuivre.
extension/mutation_rejections_count Nombre de rejets de mutation d'extension
DELTA, INT64, 1
Nombre d'appels qui ont demandé des mutations d'en-tête, de corps ou de bande-annonce, mais qui ont été rejetés. Les rejets peuvent se produire pour diverses raisons, par exemple lorsque la mutation n'est pas valide ou dépasse les limites de taille.
extension/sent_bytes_count Nombre d'octets envoyés par l'extension
DELTA, INT64, By
Nombre d'octets envoyés à l'extension.
extension/received_bytes_count Nombre d'octets reçus par l'extension
DELTA, INT64, By
Nombre d'octets reçus de l'extension.

Vous pouvez également surveiller les métriques suivantes. Ces métriques sont précédées du préfixe loadbalancing.googleapis.com/. Le préfixe est omis des entrées du tableau.

Type de métrique Nom à afficher
Type, Unité
Description
https/backend_request_count,
https/external/regional/backend_request_count,
https/internal/backend_request_count 		Nombre de requêtes de backend
DELTA, INT64, 1
Nombre d'appels d'un service de backend d'appel à partir de l'équilibreur de charge d'application.
https/backend_request_bytes_count,
https/external/regional/backend_request_bytes_count,
https/internal/backend_request_bytes_count 		Octets de requête de backend
DELTA, INT64, By
Nombre d'octets envoyés par l'équilibreur de charge au service de backend d'appel.
https/backend_response_bytes_count,
https/external/regional/backend_response_bytes_count,
https/internal/backend_response_bytes_count 		Octets de réponse de backend
DELTA, INT64, By
Nombre d'octets reçus par l'équilibreur de charge du backend d'extension.
https/backend_latencies,
https/external/regional/backend_latencies,
https/internal/backend_latencies 		Latence du backend
DELTA, DISTRIBUTION, ms
Distribution calculée à partir de la somme des latences de chaque appel d'extension entre l'équilibreur de charge et le service de backend d'appel. Échantillonné toutes les 60 secondes.

Étape suivante