Démarrage rapide : Exécuter votre première requête Resource Graph à l’aide de l’Explorateur Azure Resource Graph

Vous pouvez accéder à la puissance d’Azure Resource Graph directement dans le portail Azure par le biais de l’Explorateur Azure Resource Graph. L’Explorateur Azure Resource Graph vous permet d’obtenir des informations sur les types de ressources et les propriétés d’Azure Resource Manager. L’Explorateur Resource Graph fournit également une interface qui vous permet d’utiliser plusieurs requêtes, d’évaluer les résultats et même de convertir les résultats de certaines requêtes sous forme de graphique que vous pouvez épingler à un tableau de bord Azure.

Prérequis

Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.

Exécuter votre première requête Resource Graph

Exécuter votre première requête à partir du portail Azure et à l’aide de l’Explorateur Azure Resource Graph.

1. Connectez-vous au portail Azure.

2. Recherchez Graphique de ressources et sélectionnez Explorateur Azure Resource Graph.

   

3. Dans la partie Requête 1 de la fenêtre, copiez et collez la requête suivante. Sélectionnez ensuite Exécuter la requête.

   resources
   | project name, type
   | limit 5
   

   

   Cet exemple de requête ne fournit pas de modificateur de tri comme order by. Si vous exécutez cette requête plusieurs fois, il est probable que vous obtiendrez un ensemble de ressources différent par requête.

4. Évaluez la réponse de la requête dans l’onglet Résultats et sélectionnez l’onglet Messages pour consulter les détails de la requête, notamment le nombre de résultats et la durée de la requête. Les erreurs éventuelles sont affichées dans Messages.

5. Mise à jour de la requête vers order by le nom de la propriété. Sélectionnez ensuite Exécuter la requête

   resources
   | project name, type
   | limit 5
   | order by name asc
   

   Comme précédemment, l’exécution répétée de cette requête peut produire un ensemble différent de ressources. L’ordre des commandes de requête est important. Dans cet exemple, order by vient après limit. Cet ordre de commande limite d’abord les résultats de la requête, puis les classe.

6. Mettez à jour la requête vers order by le nom de la propriété, puis limit vers les cinq premiers résultats. Sélectionnez ensuite Exécuter la requête.

   resources
   | project name, type
   | order by name asc
   | limit 5
   

   Lorsque la requête finale est exécutée plusieurs fois, sans modification de l’environnement, les résultats sont cohérents et classés selon le nom de la propriété, mais restent limités aux cinq premiers résultats.

Navigateur de schémas

Le navigateur de schémas est situé dans le volet gauche de l’Explorateur Resource Graph. Cette liste de ressources montre tous les types de ressource Azure pris en charge par Azure Resource Graph et présents sur le locataire auquel vous avez accès. Sélectionnez un type de ressource ou de propriété pour montrer les propriétés enfants qui peuvent être utilisées pour créer une requête Resource Graph.

Sélectionnez un nom de table dans le navigateur de schéma et il est ajouté à la requête. Lorsque vous sélectionnez un type de ressource qu’il est ajouté à la requête, par exemple where type =="<resource type>". Si vous sélectionnez une propriété qu’elle est ajoutée à la ligne suivante de la requête, par exemple where <propertyName> == "INSERT_VALUE_HERE". Vous pouvez utiliser le navigateur de schémas pour rechercher les propriétés que vous pouvez utiliser dans les requêtes. Veillez à remplacer INSERT_VALUE_HERE par votre valeur et à adapter la requête à l’aide de conditions, d’opérateurs et de fonctions.

Cet exemple montre une requête générée à partir du navigateur de schémas en sélectionnant la table authorizationresources avec le type de ressource microsoft.authorization/roledefinitions et la propriété roleName.

authorizationresources
| where type == "microsoft.authorization/roledefinitions"
| where properties['roleName'] == "INSERT_VALUE_HERE"

Télécharger les résultats de la requête dans un fichier CSV

Pour télécharger des valeurs séparées par des virgules (CSV) à partir du portail Azure, accédez à l’explorateur Azure Resource Graph et lancez une requête. Dans la barre d’outils, sélectionnez Télécharger au format CSV, comme illustré dans la capture d’écran suivante :

Lorsque vous utilisez la fonctionnalité d’exportation Télécharger en tant que CSV de l’Explorateur Azure Resource Graph, l’ensemble des résultats est limité à 55 000 enregistrements. Il s’agit d’une limite de plate-forme qui ne peut pas être surmontée en déposant un ticket de support Azure.

Créer un graphique à partir de la requête Resource Graph

Après l’exécution de la requête précédente, si vous sélectionnez l’onglet Graphiques, vous obtenez un message indiquant que le jeu de résultats n’est pas compatible avec une visualisation de graphique à secteurs. Les requêtes qui répertorient les résultats ne peuvent pas être transformées en graphique, mais les requêtes qui fournissent des nombres de ressources le peuvent.

1. Dans la partie Requête 1 de la fenêtre, entrez la requête suivante, puis sélectionnez Exécuter la requête.

   resources
   | where type == "microsoft.compute/virtualmachines"
   | summarize count() by tostring(properties.storageProfile.osDisk.osType)
   

2. Sélectionnez l’onglet Résultats, puis notez que la réponse à cette requête fournit des décomptes.

3. Sélectionnez l’onglet Graphiques. Modifiez le type de Sélectionner le type de graphique... en graphique à barres ou graphique en anneau.

   

Épingler la visualisation de requête à un tableau de bord

Lorsque les résultats d’une requête peuvent être visualisés, cette visualisation de données peut être épinglée sur le tableau de bord de votre portail Azure. Après avoir exécuté la requête précédente, effectuez les étapes suivantes :

1. Sélectionnez Enregistrer, puis indiquez le nom Machine virtuelle par type de système d’exploitation. Sélectionnez ensuite Enregistrer en bas du volet droit.
2. Sélectionnez Exécuter la requête pour réexécuter la requête que vous avez enregistrée.
3. Sous l’onglet Graphiques, sélectionnez une visualisation des données. Sélectionnez ensuite Épingler au tableau de bord.
4. À partir de Épingler au tableau de bord, sélectionnez le tableau de bord existant dans lequel vous souhaitez que le graphique apparaisse.

La requête est désormais disponible sur votre tableau de bord sous le titre Machine virtuelle par type de système d’exploitation. Si la requête n’a pas été enregistrée avant d’être épinglée, le nom est Requête 1 à la place.

La requête et la visualisation des données résultante sont exécutées et mises à jour à chaque chargement du tableau de bord. Ainsi, elles fournissent des insights dynamiques et en temps réel à votre environnement Azure directement dans votre workflow.

Les requêtes qui aboutissent à une liste peuvent également être épinglées au tableau de bord. La fonctionnalité n’est pas limitée aux visualisations des données des requêtes.

Pour plus d’informations sur l’utilisation des tableaux de bord, consultez Créer un tableau de bord dans le portail Azure.

Nettoyer les ressources

Si vous souhaitez supprimer les exemples de tableaux de bord Resource Graph de votre environnement Azure Portal, procédez comme suit :

1. Sélectionnez Tableau de bord dans le menu hamburger (trois lignes horizontales) en haut, à gauche de n’importe quelle page du portail.
2. Sur votre tableau de bord, trouvez le graphique Machine virtuelle par type de système d’exploitation et sélectionnez l’ellipse (...) pour afficher le menu.
3. Sélectionnez Supprimer du tableau de bord sélectionnez Enregistrer pour confirmer.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez utilisé l’Explorateur Azure Resource Graph pour exécuter votre première requête et vous avez examiné les exemples de tableau de bord produits par Resource Graph. Pour plus d’informations sur le langage Resource Graph, passez à la page des détails du langage de requête.

Présentation du langage de requête Azure Resource Graph