Créer un workbook qui interroge vos ressources

  • 8 minutes

Les workbooks fournissent un canevas pour la création de rapports visuels interactifs. Dans cet exercice, vous allez créer un workbook, ajouter du texte descriptif et un paramètre pour interroger toutes les ressources d’un abonnement sélectionné. À la fin de cette unité, vous disposerez d’un rapport qui montre la distribution de vos ressources sur une carte.

Déployer des ressources pour l’exercice en utilisant Azure CLI

La première chose que nous allons faire est d’activer le bac à sable Azure et de déployer un modèle ARM contenant toutes les ressources Azure dont nous avons besoin pour cet exercice.

  1. Activez le bac à sable Azure. Quand le bac à sable est activé, un groupe de ressources portant le nom learn-{guid} est créé, que vous allez pouvoir utiliser. Ce groupe de ressources sera visible dans le portail Azure ou via des commandes CLI comme az group list.

  2. Dans Azure Cloud Shell, obtenez le nom du groupe de ressources qui a été généré pour votre bac à sable.

    az group list

  3. La sortie contient une ligne avec le nom du groupe de ressources. Le nom commence par « learn- ».

    Screenshot of Cloud Shell displaying resource group name for sandbox.

  4. Copiez le nom du groupe de ressources en cliquant avec le bouton droit sur le nom, puis en sélectionnant Copier.

  5. Entrez cette commande pour définir le groupe de ressources. (Cliquez avec le bouton droit et sélectionnez Coller pour coller le nom du groupe de ressources. Vous devrez peut-être supprimer les caractères en trop autour du nom du groupe de ressources.)

    resourceGroup="<your resource group name>"

  6. Exécutez ces commandes pour déployer le groupe de ressources et les ressources Azure :

       git clone https://github.com/MicrosoftDocs/ms-learn-azure-monitor-workbooks.git 
   cd ms-learn-azure-monitor-workbooks/Resources/
   az deployment group create --resource-group $resourceGroup --template-file deploy-resources.bicep

  7. Quand vous êtes invité à entrer un mot de passe, entrez un mot de passe conforme aux exigences pour les mots de passe. Par exemple, entrez « Learn@123456 ». Le mot de passe doit :

    • Comprendre au moins 12 caractères
    • Contenir au moins 3 des quatre caractéristiques suivantes :
      • une lettre minuscule
      • une lettre majuscule
      • un chiffre
      • un caractère spécial, différent de \ et de -.

  8. Attendez que les ressources dont vous avez besoin pour le module soient déployées. Cette opération prendra quelques minutes.

  9. Vous pouvez vous connecter au portail Azure pour voir les ressources déployées dans votre bac à sable pour ce module d’apprentissage.

  10. Dans la page Accueil, sélectionnez Groupes de ressources ou recherchez « Groupes de ressources » dans la barre de recherche en haut de la page.

  11. Sélectionnez le groupe de ressources « learn » créé lors de l’activation du bac à sable.

  12. Examinez dans la liste des ressources les ressources créées pour cet exercice.

    Screenshot of the resources in a resource group.

Créer un workbook

  1. Dans la page d’accueil du portail Azure, recherchez et sélectionnez Superviser.

  2. Sélectionnez Workbooks dans le volet gauche.

  3. Sélectionnez + Nouveau dans la barre d’outils du haut. Screenshot that shows the New workbook icon Azure Workbooks page.

  4. Ajoutez un texte descriptif en haut du workbook :

    1. Sélectionnez Ajouter, puis Ajouter du texte.

      Screenshot that shows the Add text button in an Azure workbook.

    2. L’éditeur de texte des workbooks Azure utilise le format Markdown. Entrez du texte dans l’éditeur. Si vous le souhaitez, vous pouvez copier ce texte.

          # Learn module exercise workbook
    **Select a subscription from the drop-down below.**

    3. Sélectionnez Modification terminée. Vous disposez maintenant d’un workbook simple avec du texte.

    Screenshot of a new Azure workbook with text.

Ajouter un sélecteur d’abonnement à votre workbook

  1. Sélectionnez Modifier à droite de la section que vous avez créée.

    Screenshot that shows the edit button from a section of a workbook.

  2. Sélectionnez Ajouter, puis Ajouter des paramètres.

    Screenshot that shows the add parameters button in a workbook.

  3. Sélectionnez Ajouter un paramètre.

  4. Dans la fenêtre Nouveau paramètre :

    1. Dans les champs Nom du paramètre et Nom d’affichage, entrez « Abonnement ».
    2. Dans le champ Type de paramètre, sélectionnez Sélecteur d’abonnement.
    3. Cochez la case Obligatoire.

    Screenshot that shows the parameter settings in a workbook.

    1. Sélectionnez Enregistrer, puis Modification effectuée.

  5. Resélectionnez Modification effectuée. Vous disposez maintenant d’un workbook avec un sélecteur de liste déroulante Abonnement.

    Screenshot that shows an Azure workbook with a subscription picker drop-down list.

Ajouter une carte pour montrer la distribution des ressources de l’abonnement

  1. Sélectionnez Modifier dans la barre d’outils du haut.

  2. Sélectionnez l’abonnement dans la liste déroulante Abonnement.

  3. Sélectionnez Ajouter une requête.

    Screenshot that shows the add query icon in a workbook.

  4. Dans le champ Source de données, sélectionnez Azure Resource Graph.

  5. Dans le champ Abonnement, sous Paramètres de ressource, cochez la case Abonnement.

  6. Ajoutez cette requête à la section Requête - Abonnements Azure Resource Graph :

        resources
   | summarize count() by location

    Screenshot that shows a query being configured in a workbook.

  7. Sélectionnez Run Query (Exécuter la requête).

  8. Vous verrez les résultats de votre requête dans un tableau sous la requête.

  9. Pour montrer vos ressources dans une carte, dans le champ Visualisation en haut de la requête, sélectionnez Carte.

  10. Dans la fenêtre Paramètres de la carte, conservez les paramètres par défaut de la carte, puis sélectionnez Enregistrer et fermer.

  11. Sélectionnez Paramètres avancés en haut de la requête, puis entrez « Distribution des ressources par région » dans le Titre du graphique.

  12. Sélectionnez Modification terminée. Vous disposez maintenant d’un workbook qui permet à l’utilisateur de sélectionner un abonnement et d’afficher toutes les ressources de cet abonnement dans une carte.

    Screenshot that shows an Azure workbook with a map displaying a subscription's resources.

  13. Sélectionnez Enregistrer sous.

  14. Entrez un Nom pour votre workbook, sélectionnez l’Abonnement et le Groupe de ressources, puis sélectionnez Appliquer.