Resursparametrar för arbetsbok

  • Artikel

Resursparametrar tillåter val av resurser i arbetsböcker. Den här funktionen är användbar för att ange det omfång som data ska hämtas från. Ett exempel skulle vara att låta dig välja den uppsättning virtuella datorer som diagram använder senare när du presenterar data.

Värden från resursväljare kan komma från arbetsbokskontexten, statisk lista eller Azure Resource Graph-frågor.

Kommentar

Etiketten för varje resurs i resursparameterlistan baseras på resurs-ID:t. Du kan inte ersätta det namnet med ett annat värde. För tydlighetens skull visar exemplen i det här dokumentet etikettfältet inställt på ID:t, men det värdet används inte i den faktiska parametern.

Skapa en resursparameter (arbetsboksresurser)

  1. Börja med en tom arbetsbok i redigeringsläge.

  2. Välj Lägg till parametrar>Lägg till parameter.

  3. I det nya parameterfönstret som öppnas anger du:

    1. Parameternamn: Applications
    2. Parametertyp: Resource picker
    3. Krävs: checked
    4. Tillåt flera val: checked
    5. Hämta data från: Workbook Resources
    6. Inkludera endast resurstyper: Application Insights

  4. Välj Spara för att skapa parametern.

    Skärmbild som visar hur du skapar en resursparameter med hjälp av arbetsboksresurser.

Skapa en Azure Resource Graph-resursparameter

  1. Börja med en tom arbetsbok i redigeringsläge.

  2. Välj Lägg till parametrar>Lägg till parameter.

  3. I det nya parameterfönstret som öppnas anger du:

    1. Parameternamn: Applications
    2. Parametertyp: Resource picker
    3. Krävs: checked
    4. Tillåt flera val: checked
    5. Hämta data från: Query
    6. Frågetyp: Azure Resource Graph
    7. Prenumerationer: Use default subscriptions
    8. Lägg till följande kodfragment i frågekontrollen:
    where type == 'microsoft.insights/components'
| project value = id, label = id, selected = false, group = resourceGroup

  4. Välj Spara för att skapa parametern.

    Skärmbild som visar hur du skapar en resursparameter med hjälp av Azure Resource Graph.

Mer information om Azure Resource Graph finns i Vad är Azure Resource Graph?.

Skapa en JSON-listresursparameter

  1. Börja med en tom arbetsbok i redigeringsläge.
  2. Välj Lägg till parametrar>Lägg till parameter.
  3. I det nya parameterfönstret som öppnas anger du:

    1. Parameternamn: Applications

    2. Parametertyp: Resource picker

    3. Krävs: checked

    4. Tillåt flera val: checked

    5. Hämta data från: JSON

    6. Lägg till det här JSON-kodfragmentet i innehållskontrollen:

      [
    { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication", "selected":true, "group":"Acme Backend" },
    { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeweb", "selected":false, "group":"Acme Frontend" }
]

    7. Välj Uppdatera.

  4. Du kan också ange Include only resource types till Application Insights.
  5. Välj Spara för att skapa parametern.

Referera till en resursparameter

  1. Välj Lägg till fråga för att lägga till en frågekontroll och välj sedan en Application Insights-resurs.

  2. Använd listrutan Application Insights för att binda parametern till kontrollen. Det här steget anger frågans omfång till de resurser som returneras av parametern vid körning.

  3. Lägg till följande kodfragment i KQL-kontrollen:

    requests
| summarize Requests = count() by appName, name
| order by Requests desc

  4. Kör frågan för att se resultatet.

    Skärmbild som visar en resursparameter som refereras till i en frågekontroll.

Den här metoden kan användas för att binda resurser till andra kontroller som mått.

Alternativ för resursparameter

Parameter Description Exempel
{Applications} Det valda resurs-ID:t. /subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label} Etiketten för den valda resursen. acmefrontend Obs! För resursparametrar med flera värden kan den här etiketten förkortas som acmefrontend (+3 others) och kanske inte innehåller alla etiketter för alla markerade värden
{Applications:value} Värdet för den valda resursen. "/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication"
{Applications:name} Namnet på den valda resursen. acmefrontend
{Applications:resourceGroup} Resursgruppen för den valda resursen. acmegroup
{Applications:resourceType} Den valda resursens typ. microsoft.insights/components
{Applications:subscription} Prenumerationen på den valda resursen.
{Applications:grid} Ett rutnät som visar resursegenskaperna. Användbart för att rendera i ett textblock vid felsökning.

Nästa steg

Komma igång med Azure-arbetsböcker