Présentation

Dans cet atelier, vous allez apprendre à utiliser Cloud Trace en envoyant une requête HTTP à l'exemple d'application.

Objectifs

Découvrez comment utiliser Trace en effectuant les tâches suivantes :

• Déployer un exemple d'application sur un cluster Google Kubernetes Engine (GKE)
• Créer une trace en envoyant une requête HTTP à l'exemple d'application
• Utiliser l'interface Trace pour afficher les informations de latence de la trace que vous avez créée

Préparation

Pour chaque atelier, nous vous attribuons un nouveau projet Google Cloud et un nouvel ensemble de ressources pour une durée déterminée, sans frais.

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 sans frais.

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, ou saisissez le nom du service ou du produit dans le champ Recherche.

Tâche 1 : Télécharger et déployer votre application

Dans cette tâche, vous allez télécharger un exemple d'application à partir de GitHub, activer l'API Google Kubernetes Engine, créer un cluster GKE, modifier les identifiants du cluster, vérifier l'accès et déployer les trois services de l'application.

Pour télécharger et déployer l'exemple d'application, procédez comme suit :

1. Pour ouvrir Cloud Shell, cliquez sur "Activer Cloud Shell" dans la barre d'outils de la console Google Cloud. Cliquez sur Continuer si vous y êtes invité.

Après quelques instants, une session Cloud Shell s'ouvre dans la console Google Cloud.

2. Pour télécharger le code source depuis GitHub, exécutez la commande suivante :

git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

3. Activez l'API Google Kubernetes Engine à l'aide de la commande suivante. Cliquez sur Autoriser si vous y êtes invité.

gcloud services enable container.googleapis.com

4. Pour créer le cluster GKE nommé "cloud-trace-demo" dans la zone , exécutez les commandes suivantes dans Cloud Shell :

ZONE={{{project_0.default_zone|place_holder_text}}} gcloud container clusters create cloud-trace-demo \ --zone $ZONE

Cette opération prend quelques minutes. Une fois l'opération terminée, votre projet Google Cloud contient le cluster GKE nommé "cloud-trace-demo". Vous devez être autorisé à créer des clusters disposant d'un accès externe dans votre projet Google Cloud.

5. Mettez à jour les informations d'identification de votre cluster GKE en exécutant la commande suivante :

gcloud container clusters get-credentials cloud-trace-demo --zone $ZONE

6. Vérifiez l'accès au cluster en exécutant la commande suivante :

kubectl get nodes

Voici un exemple de sortie pour cette commande :

NAME STATUS ROLES AGE VERSION gke-cloud-trace-demo-default-pool-063c0416-113s Ready 78s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-1n27 Ready 79s v1.22.12-gke.2300 gke-cloud-trace-demo-default-pool-063c0416-frkd Ready 78s v1.22.12-gke.2300

7. Déployez l'exemple d'application en exécutant la commande suivante :

cd python-docs-samples/trace/cloud-trace-demo-app-opentelemetry && ./setup.sh

Le script setup.sh configure trois services de l'application à l'aide d'une image prédéfinie. Les charges de travail sont nommées "cloud-trace-demo-a", "cloud-trace-demo-b" et "cloud-trace-demo-c". Le script de configuration attend que toutes les ressources soient provisionnées. La configuration peut donc prendre plusieurs minutes.

Voici un exemple de sortie pour cette commande :

deployment.apps/cloud-trace-demo-a is created service/cloud-trace-demo-a is created deployment.apps/cloud-trace-demo-b is created service/cloud-trace-demo-b is created deployment.apps/cloud-trace-demo-c is created service/cloud-trace-demo-c is created

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un cluster et déployer l'exemple d'application

Tâche 2 : Créer une trace

Dans cette tâche, vous allez générer des traces en envoyant des requêtes curl à "cloud-trace-demo-a", puis afficher les données de trace dans Trace.

1. Pour créer une trace en envoyant une requête curl à "cloud-trace-demo-a", utilisez la commande suivante :

curl $(kubectl get svc -o=jsonpath='{.items[?(@.metadata.name=="cloud-trace-demo-a")].status.loadBalancer.ingress[0].ip}')

Vous pouvez exécuter la commande curl plusieurs fois pour générer plusieurs traces.

La sortie ressemble à ceci :

Hello, I am service A And I am service B Hello, I am service C

Cliquez sur Vérifier ma progression pour valider l'objectif. Créer une trace cloud

Afficher les données de trace

1. Dans la console Google Cloud, accédez au menu de navigation (), puis cliquez sur Afficher tous les produits > Observabilité > Trace.

Trace affiche les traces distribuées à analyser. Il présente une carte de densité des durées de segments au fil du temps, ainsi qu'un tableau de segments individuels, filtrable par nom de service, et nom, état, durée et type de segment. L'interface permet aux utilisateurs d'enquêter sur les problèmes de performances et de comprendre le flux de requêtes dans un système distribué.

La vue graphique affiche la durée des segments au fil du temps à l'aide d'une carte de densité. Chaque bloc coloré représente un segment, et l'intensité de sa couleur indique sa durée. Cela vous permet d'identifier rapidement les segments lents ou les tendances de latence.

2. Dans la vue graphique, cliquez sur l'un des blocs de segment plus foncés.

3. Dans le tableau des segments, cliquez sur un ID de segment. Une vue décomposée détaillée de la trace en question s'affiche. Chaque barre horizontale représente la durée de chaque segment dans la trace. La longueur de la barre correspond à la durée du segment.

Cette section de la trace fournit une vue détaillée du parcours d'une seule requête dans le système, en le divisant en opérations individuelles (segments), et en affichant leur durée et leurs relations. Cela permet de repérer les goulots d'étranglement et de comprendre la séquence des événements.

4. Pour consulter les détails d'un segment, cliquez sur l'une des barres de segment.

Le volet des détails présente des informations supplémentaires sur chaque segment.

Félicitations !

Dans cet atelier, vous avez :

• déployé un exemple d'application sur un cluster Google Kubernetes Engine (GKE) ;
• créé une trace en envoyant une requête HTTP à l'exemple d'application ;
• utilisé l'interface Trace pour afficher les informations de latence de la trace que vous avez créée.

Bravo !

Terminer l'atelier

Une fois l'atelier terminé, cliquez sur Terminer l'atelier. Google Cloud Skills Boost supprime les ressources que vous avez utilisées, puis efface le compte.

Si vous le souhaitez, vous pouvez noter l'atelier. Sélectionnez un nombre d'étoiles, saisissez un commentaire, puis cliquez sur Envoyer.

Le nombre d'étoiles correspond à votre degré de satisfaction :

• 1 étoile = très insatisfait(e)
• 2 étoiles = insatisfait(e)
• 3 étoiles = ni insatisfait(e), ni satisfait(e)
• 4 étoiles = satisfait(e)
• 5 étoiles = très satisfait(e)

Si vous ne souhaitez pas donner votre avis, vous pouvez fermer la boîte de dialogue.

Pour soumettre des commentaires, suggestions ou corrections, veuillez accéder à l'onglet Assistance.

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