GSP092

Présentation

Dans cet atelier, vous allez utiliser Cloud Monitoring pour afficher les détails de Cloud Run Functions dans la console Google Cloud. Les détails des fonctions Cloud Run incluent la durée et le nombre des exécutions, ainsi que l'utilisation de la mémoire.

Objectifs

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

• Créer une fonction Cloud Run
• Créer une métrique basée sur les journaux pour une fonction Cloud Run
• Utiliser l'explorateur de métriques pour afficher les données de votre fonction Cloud Run
• Créer des graphiques dans la fenêtre "Aperçu" de Monitoring

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 les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de 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 (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

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

Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

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, une boîte de dialogue 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 sans frais.

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

Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.

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.

2. Passez les fenêtres suivantes :

   • Accédez à la fenêtre d'informations de Cloud Shell.
   • Autorisez Cloud Shell à utiliser vos identifiants pour effectuer des appels d'API 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 l'ID_PROJET pour cette session :

Your Cloud Platform project in this session is set to {{{project_0.project_id | "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.

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

gcloud auth list

4. Cliquez sur Autoriser.

Résultat :

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} 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 = {{{project_0.project_id | "PROJECT_ID"}}} Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.

Tâche 1 : Afficher les journaux et les métriques d'une fonction Cloud Run dans Cloud Monitoring

Avant de pouvoir collecter des journaux et des alertes, vous devez avoir quelque chose à surveiller. Dans cette section, vous allez créer une fonction Cloud Run Hello World à surveiller.

1. Dans la console Cloud, sélectionnez le menu de navigation () > Cloud Run, puis cliquez sur Écrire une fonction.

2. Renseignez les champs suivants :

   • Nom du service : helloworld
   • Région :
   • Environnement d'exécution : Node.js 22
   • Authentification : sélectionnez la case d'option Autoriser les appels non authentifiés.

3. Développez Conteneur(s), volumes, mise en réseau et sécurité et définissez les éléments suivants :

   • Environnement d'exécution : sélectionnez Deuxième génération.

   • Scaling de révision : définissez le nombre maximal d'instances sur 5.

4. Laissez les valeurs par défaut des autres champs. Cliquez sur Créer.

Remarque : Un pop-up peut s'afficher afin de vérifier que les API requises pour le projet sont activées. Cliquez sur le bouton Activer si vous y êtes invité.

5. Cliquez sur Enregistrer et redéployer.

La fonction se déploie automatiquement et est répertoriée sur la page "Fonction Cloud Run". L'opération prend quelques minutes. Une coche verte s'affiche à côté du nom de la fonction Cloud Run lorsque son exécution est terminée.

Tester la tâche terminée

Cliquez sur Vérifier ma progression pour valider la tâche exécutée. Si votre tâche a bien été exécutée, vous recevez une note d'évaluation.

Créer une fonction Cloud Run

6. Ouvrez une nouvelle fenêtre Cloud Shell en cliquant sur Activer Cloud Shell  en haut de la console Google Cloud.

7. Dans Cloud Shell, exécutez la commande suivante pour récupérer l'outil vegeta, qui va vous permettre d'envoyer du trafic à votre fonction Cloud Run pour la tester :

curl -LO 'https://github.com/tsenart/vegeta/releases/download/v12.12.0/vegeta_12.12.0_linux_386.tar.gz'

8. Décompressez l'outil vegeta à l'aide de la commande suivante :

tar -xvzf vegeta_12.12.0_linux_386.tar.gz

9. Sur la page Cloud Run, cliquez sur le nom de votre fonction, puis sur son URL helloworld.

Si le message Hello World! s'affiche dans l'onglet du navigateur qui s'ouvre, votre fonction Cloud est opérationnelle.

10. Définissez et vérifiez le lien d'URL Cloud Run :

CLOUD_RUN_URL=$(gcloud run services describe helloworld --region={{{ project_0.default_region }}} --format='value(status.url)') echo $CLOUD_RUN_URL

11. Envoyez maintenant du trafic à votre fonction Cloud Run.

echo "GET $CLOUD_RUN_URL" | ./vegeta attack -duration=300s -rate=200 > results.bin

12. Laissez-le s'exécuter en arrière-plan pendant que vous effectuez les étapes suivantes.

Tâche 2 : Créer une métrique basée sur les journaux

Vous allez maintenant créer une métrique de type "Distribution" basée sur les journaux afin d'extraire la latence du champ httpRequest.latency dans les entrées de journal.

1. Dans la console, accédez au menu de navigation > Afficher tous les produits > Observabilité > Journalisation > Explorateur de journaux. Cloud Logging s'ouvre dans la console.

2. Pour afficher uniquement les journaux de votre fonction Cloud Run, dans le menu déroulant Toutes les ressources, sélectionnez Révision Cloud Run > helloWorld, puis cliquez sur Appliquer.

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

4. Dans le menu déroulant "Actions", cliquez sur Créer une métrique.

5. Dans le formulaire "Créer une métrique basée sur les journaux" :

• Définissez le type de métrique sur Distribution.
• Dans "Nom de la métrique basée sur les journaux", saisissez CloudRunFunctionLatency-Logs.
• Saisissez httpRequest.latency pour le nom du champ.

La métrique basée sur les journaux doit se présenter comme suit :

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

La métrique que vous venez de définir figure maintenant sur la page "Métriques basées sur les journaux".

Tester la tâche terminée

Cliquez sur Vérifier ma progression pour valider la tâche exécutée. Si votre tâche a bien été exécutée, vous recevez une note d'évaluation.

Créer une métrique basée sur les journaux

Tâche 3 : Explorateur de métriques

Vous allez maintenant examiner les données de votre fonction Cloud Run à l'aide de l'explorateur de métriques.

Créer un champ d'application des métriques Monitoring

Définissez un champ d'application des métriques Monitoring associé à votre projet Google Cloud. Suivez les étapes ci-dessous pour créer un compte incluant un essai gratuit de Monitoring.

• Dans la console Cloud, cliquez sur le menu de navigation (), puis sur Afficher tous les produits > Observabilité > Monitoring.

Lorsque la page Aperçu de Monitoring s'affiche, votre projet de champ d'application des métriques est prêt.

1. Dans le menu de gauche, cliquez sur Explorateur de métriques.

2. Cliquez sur le menu déroulant Sélectionner une métrique. Désélectionnez le bouton Actives.

3. Saisissez CloudRunFunctionLatency-Logs dans "Filtrer par nom de ressource ou de métrique", puis sélectionnez Révision Cloud Run > Métrique basée sur les journaux > Logging/user/CloudRunFunctionLatency-Logs parmi les métriques suggérées et cliquez sur Appliquer.

Remarque : Si "Révision Cloud Run" n'apparaît pas dans le menu déroulant, décochez Actives. Les métriques basées sur les journaux peuvent initialement s'afficher comme "Non actives" dans l'explorateur de métriques. Cela signifie que la métrique n'a pas encore reçu suffisamment de données pour être considérée comme active. Il peut s'écouler plusieurs minutes avant que la génération de trafic soit suffisante et que la métrique devienne active.

Si vous rencontrez des problèmes :

• Vérifiez que vous avez sélectionné la bonne ressource et la bonne métrique dans Cloud Monitoring.
• Assurez-vous qu'aucun filtre n'est appliqué dans Cloud Monitoring.
• Vérifiez que la période est définie correctement dans Cloud Monitoring.
• Générez plus de trafic avec l'outil vegeta en augmentant la durée ou le taux.
• Patientez, car le traitement des journaux peut prendre du temps.

4. En haut à droite, définissez le type de widget sur Graphique à barres empilées à l'aide du menu déroulant.

5. Explorez les autres options de graphiques disponibles et essayez une autre métrique. Par exemple, cliquez sur la métrique Révision Cloud Run actuellement sélectionnée pour ouvrir le menu déroulant, puis sélectionnez Révision Cloud Run > Nombre de requêtes et définissez le type de widget sur Graphique en aires empilées.

6. Continuez votre exploration. Par exemple, revenez à la métrique Révision Cloud Run et définissez Agrégation sur 95e centile. Sélectionnez le type de widget Graphique en courbes.

Tâche 4 : Créer des graphiques dans la fenêtre "Aperçu" de Monitoring

La création de graphiques dans la fenêtre "Aperçu de la surveillance" est un bon moyen de suivre les métriques qui vous intéressent. Dans cette section, vous allez générer les mêmes graphiques que ceux créés précédemment, en les enregistrant cette fois dans la fenêtre "Aperçu" de Monitoring.

1. Dans le menu de gauche, cliquez sur Tableaux de bord.

2. Cliquez sur Créer un tableau de bord personnalisé.

3. Cliquez sur Ajouter le widget.

4. Sous "Visualisation", sélectionnez Barres empilées.

5. Dans le menu déroulant Sélectionner une métrique, sélectionnez la métrique par défaut Révision Cloud Run > Nombre de requêtes pour ouvrir le menu déroulant et changer la métrique. Cliquez sur Appliquer en haut à droite.

6. Cliquez sur Ajouter le widget. Sous "Visualisation", sélectionnez Carte de densité.

7. Commencez à saisir Révision Cloud Run dans le menu déroulant Sélectionner une métrique, puis sélectionnez Révision Cloud Run > Métrique basée sur les journaux > Logging/user/CloudRunFunctionLatency-Logs parmi les métriques suggérées et cliquez sur Appliquer.

Remarque : Si la métrique CloudRunFunctionLatency-Logs n'apparaît pas dans le menu déroulant, décochez Actives.

8. Cliquez sur Ajouter le widget. Sous "Visualisation", sélectionnez Courbes.

9. Commencez à saisir Révision Cloud Run dans le menu déroulant Sélectionner une métrique, puis sélectionnez Révision Cloud Run > Request_latency parmi les métriques suggérées. Définissez Agrégation sur Moyenne, puis cliquez sur Appliquer.

10. Cliquez sur Ajouter le widget. Sous "Visualisation", sélectionnez Barres empilées.

11. Commencez à saisir Révision Cloud Run dans le menu déroulant Sélectionner une métrique, puis sélectionnez Révision Cloud Run > Conteneur > Allocation de processeur du conteneur parmi les métriques suggérées. Cliquez sur Appliquer.

Par défaut, les graphiques sont nommés en fonction de la métrique utilisée, mais vous pouvez les renommer.

12. Cliquez sur le nom du tableau de bord en haut (il doit commencer par Nouveau tableau de bord), puis renommez-le Cloud Run Function Custom Dashboard.

Cliquez sur Tableaux de bord dans le panneau de gauche de la page Monitoring pour afficher rapidement ces graphiques.

Tâche 5 : Tester vos connaissances

Voici quelques questions à choix multiples qui vous permettront de mieux maîtriser les concepts abordés lors de cet atelier. Répondez-y du mieux que vous le pouvez.

Félicitations !

Dans cet atelier, vous avez créé une fonction Cloud Run et une métrique basée sur les journaux, utilisé l'explorateur de métriques et créé des graphiques dans la fenêtre "Aperçu" de Monitoring.

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 : 5 mars 2025

Dernier test de l'atelier : 5 mars 2025

Copyright 2025 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.