GSP091

Présentation

Les métriques basées sur les journaux sont des métriques Cloud Monitoring qui s'appuient sur le contenu d'entrées de journal. Elles vous permettent d'identifier des tendances, d'extraire des valeurs numériques de journaux et de configurer une alerte lorsqu'une entrée de journal spécifique est ajoutée en créant une métrique associée à cet événement. Vous pouvez utiliser les métriques basées sur les journaux du système et celles définies par l'utilisateur dans Cloud Monitoring pour créer des graphiques et des règles d'alerte.

L'interface des métriques basées sur les journaux se compose d'ailleurs de deux volets dédiés à ces types de métriques.

Les métriques basées sur les journaux définies par le système sont fournies par Cloud Logging et peuvent être utilisées dans n'importe quel projet Google Cloud. Elles ne sont calculées qu'à partir des journaux ingérés par Logging. Si un journal a été explicitement exclu de l'ingestion, il n'est pas pris en compte dans ces métriques.

Quant aux métriques basées sur les journaux définies par l'utilisateur, vous les créez pour suivre des éléments de votre projet Google Cloud. Par exemple, vous pouvez en créer une pour compter le nombre d'entrées de journal correspondant à un filtre donné.

Enfin, il est également possible de créer une règle d'alerte en fonction d'une métrique basée sur les journaux.

Objectifs

Dans cet atelier, vous allez apprendre à effectuer les tâches suivantes :

• Créer une alerte basée sur les journaux
• Créer une métrique basée sur les journaux définie par le système
• Créer une métrique basée sur les journaux définie par l'utilisateur
• Créer une alerte pour la métrique basée sur les journaux définie par l'utilisateur

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre vous-même les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Nous vous fournissons des identifiants temporaires pour vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome) ;

Remarque : Ouvrez une fenêtre de navigateur en mode incognito/navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le temporaire étudiant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• vous disposez d'un temps limité ; une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Si vous possédez déjà votre propre compte ou projet Google Cloud, veillez à ne pas l'utiliser pour réaliser cet atelier afin d'éviter que des frais supplémentaires ne vous soient facturés.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, un pop-up s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau Détails concernant l'atelier, qui contient les éléments suivants :

   • Le bouton Ouvrir la console Google Cloud
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page Se connecter dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau Détails concernant l'atelier.

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau Détails concernant l'atelier.

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais gratuits.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour afficher un menu contenant la liste des produits et services Google Cloud, cliquez sur le menu de navigation en haut à gauche.

Activer Cloud Shell

Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.

1. Cliquez sur Activer Cloud Shell  en haut de la console Google Cloud.

Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET. Le résultat contient une ligne qui déclare YOUR_PROJECT_ID (VOTRE_ID_PROJET) pour cette session :

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.

2. (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

3. Cliquez sur Autoriser.

4. Vous devez à présent obtenir le résultat suivant :

Résultat :

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Facultatif) Vous pouvez lister les ID de projet à l'aide de cette commande :

gcloud config list project

Résultat :

[core] project = <ID_Projet>

Exemple de résultat :

[core] project = qwiklabs-gcp-44776a13dea667a6 Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.

Une machine virtuelle a été créée lors du lancement de cet atelier. Avant de continuer, attendez de voir le message "Lab Running" (Atelier démarré) qui s'affiche en vert sur la page à partir de laquelle vous avez démarré l'atelier.

Ensuite, connectez-vous à un cluster Google Kubernetes Engine et confirmez qu'il a été créé correctement.

1. Définissez la zone dans gcloud :

gcloud config set compute/zone us-east1-c

2. Autorisez Cloud Shell.

3. Définissez l'ID du projet :

export PROJECT_ID=$(gcloud info --format='value(config.project)')

4. Déployez un cluster GKE standard. Vous serez alors invité à autoriser et à activer l'API GKE.

gcloud container clusters create gmp-cluster --num-nodes=1 --zone us-east1-c

Cliquez sur Vérifier ma progression pour valider l'objectif. Déployer le cluster GKE

Tâche 1 : Créer une alerte basée sur les journaux

Les alertes basées sur les journaux vous avertissent lorsqu'un message spécifique s'affiche dans vos journaux. Configurez-en une qui vous avertira lorsqu'une VM s'arrête pour tester cette fonctionnalité.

1. Dans la barre de recherche de la console Cloud, saisissez "explorateur de journaux", puis cliquez sur le résultat Explorateur de journaux.

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

3. Saisissez les paramètres suivants pour créer une alerte basée sur les journaux :

resource.type="gce_instance" protoPayload.methodName="v1.compute.instances.stop"

4. Cliquez sur le bouton Créer une alerte.

5. Ajoutez les paramètres ci-dessous en cliquant sur Suivant pour passer au paramètre suivant.

• Nom de l'alerte : "vm arrêtée".
• Choose logs to include in the alert (Sélectionner les journaux à inclure dans l'alerte) : ce champ sera automatiquement rempli avec la requête que vous avez saisie.
• Set notification frequency and autoclose duration (Définir la fréquence des notifications et le délai pour la fermeture automatique) : sélectionnez 5 min pour "Délai entre les notifications" et 1 h pour "Délai pour la fermeture automatique de l'incident". Cliquez sur Suivant.

Qui doit être informé ? (facultatif) :

• Cliquez sur la flèche du menu déroulant à côté de Canaux de notification, puis sur Gérer les canaux de notification.
• Une page "Canaux de notification" s'ouvre dans un nouvel onglet.
• Faites défiler l'écran vers le bas, puis cliquez sur le bouton AJOUTER associé à Adresse e-mail.
• Saisissez votre adresse e-mail personnelle dans le champ Adresse e-mail et renseignez le champ Nom à afficher.
• Cliquez sur Save (Enregistrer).
• Lorsque vous avez terminé, revenez à l'onglet "Explorateur de journaux".
• Actualisez les canaux de notification, puis sélectionnez celui que vous venez de créer. Cliquez sur OK.

6. Cliquez sur Enregistrer.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une alerte basée sur les journaux

Vous allez maintenant arrêter votre VM.

7. Pour cela, accédez au second onglet affichant la console Cloud, puis cliquez sur le menu de navigation > Compute Engine > Instances de VM.

8. Cochez la case à côté de instance1 et cliquez sur Arrêter une première fois en haut de la page, puis une seconde fois dans la fenêtre pop-up. Un cercle gris s'affiche à la place de la coche verte lorsque l'instance s'arrête.

9. Dans la barre de recherche, saisissez "monitoring", puis sélectionnez le résultat Monitoring.

10. Cliquez sur l'onglet Alertes. Vous constatez que votre alerte a été enregistrée. Sous "Règles d'alerte", cliquez sur le lien Afficher toutes les règles. Vous voyez alors l'alerte basée sur les journaux que vous avez créée.

Tâche 2 : Créer une métrique basée sur les journaux définie par le système

Les métriques basées sur les journaux vous permettent de suivre les erreurs dans les journaux afin de répondre de manière proactive aux problèmes et symptômes similaires avant qu'ils ne soient remarqués par les utilisateurs finaux.

1. Au début de l'atelier, vous avez déployé un cluster GKE standard. Exécutez la commande suivante pour vérifier que le cluster nommé gmp-cluster a bien été créé :

gcloud container clusters list Si l'état du cluster indique PROVISIONNEMENT, attendez un peu et exécutez une nouvelle fois la commande ci-dessus. Réexécutez la commande jusqu'à ce que l'état EXÉCUTION soit indiqué.

2. Authentifiez le cluster :

gcloud container clusters get-credentials gmp-cluster

Le message suivant s'affiche :

Fetching cluster endpoint and auth data. kubeconfig entry generated for gmp-cluster.

3. Créez un espace de noms dans lequel travailler :

kubectl create ns gmp-test

4. À présent, exécutez la commande suivante pour déployer une application simple qui émet des métriques au niveau du point de terminaison /metrics :

kubectl -n gmp-test apply -f https://storage.googleapis.com/spls/gsp091/gmp_flask_deployment.yaml kubectl -n gmp-test apply -f https://storage.googleapis.com/spls/gsp091/gmp_flask_service.yaml

5. Vérifiez que l'espace de noms est prêt et qu'il émet des métriques :

kubectl get services -n gmp-test

Le résultat suivant doit s'afficher :

NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE hello LoadBalancer 10.0.12.114 34.83.91.157 80:32058/TCP 71s

Cliquez sur Vérifier ma progression pour valider l'objectif. Déployer une application simple qui émet des métriques

6. Réexécutez la commande jusqu'à ce que l'adresse External-IP soit renseignée.

7. Vérifiez que l'application Python Flask livre des métriques à l'aide de la commande suivante :

curl $(kubectl get services -n gmp-test -o jsonpath='{.items[*].status.loadBalancer.ingress[0].ip}')/metrics

Le résultat suivant doit s'afficher :

# HELP flask_exporter_info Multiprocess metric # TYPE flask_exporter_info gauge flask_exporter_info{version="0.18.5"} 1.0

Tâche 3 : Créer une métrique basée sur les journaux définie par l'utilisateur

1. Revenez à la page Explorateur de journaux.

2. Cliquez sur le bouton Créer une métrique.

3. Sur la page "Créer une métrique de journaux", définissez les informations suivantes :

• Type de métrique : conservez le paramètre par défaut, à savoir "Compteur".
• Nom de la métrique basée sur les journaux : "hello-app-error".
• Sélection du filtre : saisissez la commande ci-dessous dans la zone de texte "Créer un filtre".

severity=ERROR resource.labels.container_name="hello-app" textPayload: "ERROR: 404 Error page not found"

4. Cliquez sur Créer une métrique.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une métrique basée sur les journaux

Tâche 4 : Créer une alerte basée sur une métrique

1. Dans le volet de gauche de la fenêtre Journalisation, sélectionnez Métriques basées sur les journaux. Dans la section "Métriques définies par l'utilisateur", cliquez sur les trois points verticaux à côté d'une métrique et sélectionnez Créer une alerte à partir de la métrique.

2. Sous Sélectionner une métrique, les paramètres de la métrique sont automatiquement renseignés.

• Définissez la fenêtre glissante sur 2 min.
• Conservez les autres paramètres par défaut.
• Cliquez sur Suivant.

3. Vous devrez configurer les notifications. Pour cela, n'hésitez pas à réutiliser le canal que vous avez créé précédemment dans cet atelier.

4. Nommez la règle d'alerte Alerte pour métrique basée sur les journaux.

5. Cliquez sur Créer une règle.

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une alerte basée sur une métrique

Tâche 5 : Générer quelques erreurs

Maintenant, vous allez générer quelques erreurs correspondant à la métrique basée sur les journaux que vous avez créée afin de déclencher l'alerte associée.

1. Pour cela, exécutez la commande suivante dans Cloud Shell :

timeout 120 bash -c -- 'while true; do curl $(kubectl get services -n gmp-test -o jsonpath='{.items[*].status.loadBalancer.ingress[0].ip}')/error; sleep $((RANDOM % 4)) ; done'

2. Revenez à la page Explorateur de journaux, puis accédez à la section "Gravité" en bas à gauche. Cliquez sur Erreur. À présent, cherchez l'erreur 404 Error page not found. Pour afficher plus d'informations, développez l'un des messages d'erreur 404.

3. Revenez à la page Monitoring et cliquez sur Alertes. Vous trouverez alors les deux règles que vous avez créées.

4. Cliquez sur le lien Règles d'alerte. Les deux alertes doivent alors s'afficher dans la section "Incidents". Cliquez sur un incident pour afficher ses informations.

Remarque : L'alerte pour la métrique basée sur les journaux finira par se résoudre automatiquement. Si vous avez besoin de plus de temps pour examiner les erreurs, réexécutez le script de celles-ci et attendez que l'alerte se déclenche à nouveau. Cliquez sur **Vérifier ma progression** pour valider l'objectif. Générer quelques erreurs

Félicitations !

Félicitations ! Dans cet atelier, vous avez créé une alerte basée sur les journaux, une métrique basée sur les journaux définie par le système, une métrique basée sur les journaux définie par l'utilisateur et une alerte basée sur une métrique. Vous avez également généré des erreurs afin de déclencher l'alerte. Enfin, vous avez appris à afficher les incidents et les détails des alertes.

Étapes suivantes et informations supplémentaires

• Pour apprendre à utiliser BigQuery et Cloud Monitoring conjointement, lisez cet article du blog.
• Pour apprendre à gérer des règles d'alerte, consultez ce guide.
• Pour apprendre à créer des règles d'alerte pour vos métriques basées sur les journaux, parcourez cette section.

Formations et certifications Google Cloud

Les formations et certifications Google Cloud vous aident à tirer pleinement parti des technologies Google Cloud. Nos cours portent sur les compétences techniques et les bonnes pratiques à suivre pour être rapidement opérationnel et poursuivre votre apprentissage. Nous proposons des formations pour tous les niveaux, à la demande, en salle et à distance, pour nous adapter aux emplois du temps de chacun. Les certifications vous permettent de valider et de démontrer vos compétences et votre expérience en matière de technologies Google Cloud.

Dernière mise à jour du manuel : 31 janvier 2024

Dernier test de l'atelier : 7 août 2023

Copyright 2024 Google LLC Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.