Quickstart: Uw eerste Resource Graph-query uitvoeren met Behulp van Azure Resource Graph Explorer

  • Artikel

De kracht van Azure Resource Graph is rechtstreeks beschikbaar in Azure Portal via Azure Resource Graph Explorer. Met Resource Graph Explorer kunt u query's uitvoeren op informatie over de Resource Manager-resourcetypen en -eigenschappen van Azure Resource Manager. Resource Graph Explorer biedt ook een interface voor het werken met meerdere query's, het evalueren van de resultaten en het converteren van de resultaten van sommige query's naar een grafiek die kan worden vastgemaakt aan een Azure-dashboard.

Vereisten

Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.

Uw eerste Resource Graph-query uitvoeren

Voer uw eerste query uit vanuit Azure Portal met behulp van Azure Resource Graph Explorer.

  1. Meld u aan bij het Azure-portaal.

  2. Zoek naar resourcegrafiek en selecteer Resource Graph Explorer.

    Schermopname van Azure Portal om te zoeken naar resourcegrafiek.

  3. Kopieer en plak de volgende query in het gedeelte Query 1 van het venster. Selecteer vervolgens Query uitvoeren.

    resources
| project name, type
| limit 5

    Schermopname van Azure Resource Graph Explorer waarin de query, resultaten en berichten worden gemarkeerd.

    Dit queryvoorbeeld biedt geen sorteeraanpassing zoals order by. Als u deze query meerdere keren uitvoert, levert dit waarschijnlijk een andere set resources per aanvraag op.

  4. Controleer het queryantwoord op het tabblad Resultaten en selecteer het tabblad Berichten om details over de query weer te geven, inclusief het aantal resultaten en de duur van de query. Fouten, indien aanwezig, worden weergegeven in Berichten.

  5. Werk de query bij naar order by de naameigenschap . Selecteer vervolgens Query uitvoeren

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

    Net als bij de eerste query levert het uitvoeren van deze query meerdere keren een andere set resources per aanvraag op. De volgorde van de queryopdrachten is belangrijk. In dit voorbeeld komt order by na limit. Met deze opdracht worden de queryresultaten eerst beperkt en vervolgens gerangschikt.

  6. Werk de query bij naar order by de naameigenschap en vervolgens limit naar de top vijf resultaten. Selecteer vervolgens Query uitvoeren.

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

    Wanneer de laatste query meerdere keren wordt uitgevoerd en zonder wijzigingen in uw omgeving, zijn de resultaten consistent en gerangschikt op de naameigenschap , maar nog steeds beperkt tot de top vijf resultaten.

Schemabrowser

De schemabrowser bevindt zich in het linkerdeelvenster van Resource Graph Explorer. Deze lijst met resources bevat alle resourcetypen van Azure-resources die worden ondersteund door Azure Resource Graph en die aanwezig zijn in uw tenant. Selecteer een resourcetype of eigenschap om onderliggende eigenschappen weer te geven die kunnen worden gebruikt om een Resource Graph-query te maken.

Selecteer een tabelnaam in de schemabrowser en deze wordt toegevoegd aan de query. Wanneer u een resourcetype selecteert, wordt het toegevoegd aan de query, zoals where type =="<resource type>". Als u een eigenschap selecteert, wordt deze toegevoegd aan de volgende regel in de query, zoals where <propertyName> == "INSERT_VALUE_HERE". U kunt de schemabrowser gebruiken om eigenschappen te vinden die u in query's kunt gebruiken. Zorg ervoor dat u vervangt door INSERT_VALUE_HERE uw eigen waarde en pas de query aan met voorwaarden, operators en functies.

In dit voorbeeld ziet u een query die is gemaakt vanuit de schemabrowser door de tabel authorizationresources met het resourcetype microsoft.authorization/roledefinitions en de eigenschap roleNamete selecteren.

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

Schermopname van de schemabrowser van Azure Resource Graph Explorer waarin het resourcetype en de eigenschappen worden gemarkeerd.

Queryresultaten downloaden als een CSV-bestand

Als u csv-resultaten (door komma's gescheiden waarden) wilt downloaden uit Azure Portal, bladert u naar Azure Resource Graph Explorer en voert u een query uit. Selecteer Downloaden als CSV op de werkbalk, zoals wordt weergegeven in de volgende schermopname:

Schermopname van Azure Resource Graph Explorer met Downloaden als CSV gemarkeerd.

Wanneer u de downloadfunctie Downloaden als CSV-exportfunctionaliteit van Azure Resource Graph Explorer gebruikt, is de resultatenset beperkt tot 55.000 records. Deze beperking is een platformlimiet die niet kan worden overschreven door een ondersteuning voor Azure ticket in te dienen.

Een grafiek maken op basis van de Resource Graph-query

Als u het tabblad Grafieken selecteert nadat u de vorige query hebt uitgevoerd, krijgt u een bericht dat de resultatenset niet compatibel is met een visualisatie van een cirkeldiagram. Query's met lijstresultaten kunnen niet in een grafiek worden gemaakt, maar query's die aantallen resources kunnen bieden.

  1. Voer in het gedeelte Query 1 van het venster de volgende query in en selecteer Query uitvoeren.

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

  2. Selecteer het tabblad Resultaten en merk op dat met deze query aantallen als resultaat worden weergegeven.

  3. Selecteer het tabblad Grafieken . Wijzig het type in Grafiektype selecteren... in staafdiagram of ringdiagram.

    Schermopname van Azure Resource Graph Explorer met het vervolgkeuzemenu Grafieken gemarkeerd.

De visualisatie van de query vastmaken aan een dashboard

Wanneer u resultaten hebt van een query die kan worden gevisualiseerd, kan die gegevensvisualisatie worden vastgemaakt aan uw Azure Portal-dashboard. Voer de volgende stappen uit nadat u de vorige query hebt uitgevoerd:

  1. Selecteer Opslaan en geef de naam van de VM op type besturingssysteem op. Selecteer vervolgens Opslaan onder in het rechterdeelvenster.
  2. Selecteer Query uitvoeren om de query die u hebt opgeslagen, opnieuw uit te voeren.
  3. Selecteer een gegevensvisualisatie op het tabblad Grafieken. Selecteer vervolgens Vastmaken aan dashboard.
  4. Selecteer van Vastmaken aan dashboard het bestaande dashboard waarin u de grafiek wilt weergeven.

De query is nu beschikbaar op uw dashboard met de titel-VM op type besturingssysteem. Als de query niet is opgeslagen voordat deze werd vastgemaakt, is de naam in plaats daarvan Query 1 .

De query en resulterende gegevensvisualisatie worden uitgevoerd en bijgewerkt telkens wanneer het dashboard wordt geladen, waardoor realtime en dynamische inzichten in uw Azure-omgeving rechtstreeks in uw werkstroom worden geboden.

Ook query's waarmee een lijst als resultaat wordt weergegeven, kunnen worden vastgemaakt aan het dashboard. De functie is niet beperkt tot gegevensvisualisaties van query's.

Zie Een dashboard maken in Azure Portal voor meer informatie over het werken met dashboards.

Resources opschonen

Als u de voorbeelddashboards van Resource Graph uit uw Azure Portal-omgeving wilt verwijderen, voert u de volgende stappen uit:

  1. Selecteer Dashboard in het hamburgermenu (drie horizontale lijnen) linksboven op een portalpagina.
  2. Zoek op het dashboard de VM op typegrafiek van het besturingssysteem en selecteer het beletselteken (...) om het menu weer te geven.
  3. Selecteer Verwijderen uit het dashboard de optie Opslaan om te bevestigen.

Volgende stappen

In deze quickstart hebt u Azure Resource Graph Explorer gebruikt om uw eerste query uit te voeren en gekeken naar dashboardvoorbeelden die mogelijk worden gemaakt door Resource Graph. Ga verder naar de pagina met details van de querytaal voor meer informatie over de taal van Resource Graph.

Informatie over de querytaal van Azure Resource Graph