Parametry zasobu skoroszytu

Parametry zasobu umożliwiają wybieranie zasobów w skoroszytach. Ta funkcja jest przydatna w ustawianiu zakresu, z którego mają być uzyskiwane dane. Przykładem może być wybranie zestawu maszyn wirtualnych, które wykresy będą używane później podczas prezentowania danych.

Wartości z selektorów zasobów mogą pochodzić z kontekstu skoroszytu, listy statycznej lub zapytań usługi Azure Resource Graph.

Uwaga

Etykieta dla każdego zasobu na liście parametrów zasobu jest oparta na identyfikatorze zasobu. Nie można zastąpić tej nazwy inną wartością. Aby uzyskać jasność, przykłady w tym dokumencie pokazują pole etykiety ustawione na identyfikator, ale ta wartość nie jest używana w rzeczywistym parametrze.

Tworzenie parametru zasobu (zasoby skoroszytu)

  1. Zacznij od pustego skoroszytu w trybie edycji.

  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    1. Nazwa parametru: Applications
    2. Typ parametru: Resource picker
    3. Wymagane: checked
    4. Zezwalaj na wiele wyborów: checked
    5. Pobieranie danych z: Workbook Resources
    6. Uwzględnij tylko typy zasobów: Application Insights
  4. Wybierz pozycję Zapisz , aby utworzyć parametr.

    Zrzut ekranu przedstawiający tworzenie parametru zasobu przy użyciu zasobów skoroszytu.

Tworzenie parametru zasobu usługi Azure Resource Graph

  1. Zacznij od pustego skoroszytu w trybie edycji.

  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.

  3. W otwartym okienku nowego parametru wprowadź:

    1. Nazwa parametru: Applications
    2. Typ parametru: Resource picker
    3. Wymagane: checked
    4. Zezwalaj na wiele wyborów: checked
    5. Pobieranie danych z: Query
    6. Typ zapytania: Azure Resource Graph
    7. Subskrypcje: Use default subscriptions
    8. W kontrolce zapytania dodaj ten fragment kodu:
    where type == 'microsoft.insights/components'
    | project value = id, label = id, selected = false, group = resourceGroup
    
  4. Wybierz pozycję Zapisz , aby utworzyć parametr.

    Zrzut ekranu przedstawiający tworzenie parametru zasobu przy użyciu usługi Azure Resource Graph.

Aby uzyskać więcej informacji na temat usługi Azure Resource Graph, zobacz Co to jest usługa Azure Resource Graph?.

Tworzenie parametru zasobu listy JSON

  1. Zacznij od pustego skoroszytu w trybie edycji.
  2. Wybierz pozycję Dodaj parametry>Dodaj parametr.
  3. W otwartym okienku nowego parametru wprowadź:
    1. Nazwa parametru: Applications

    2. Typ parametru: Resource picker

    3. Wymagane: checked

    4. Zezwalaj na wiele wyborów: checked

    5. Pobieranie danych z: JSON

    6. W kontrolce zawartości dodaj ten fragment kodu JSON:

      [
          { "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. Wybierz Aktualizuj.

  4. Opcjonalnie ustaw wartość Include only resource typesApplication Szczegółowe informacje.
  5. Wybierz pozycję Zapisz , aby utworzyć parametr.

Odwołanie do parametru zasobu

  1. Wybierz pozycję Dodaj zapytanie, aby dodać kontrolkę zapytania, a następnie wybierz zasób Application Szczegółowe informacje.

  2. Użyj listy rozwijanej Szczegółowe informacje aplikacji, aby powiązać parametr z kontrolką. W tym kroku ustawia zakres zapytania na zasoby zwracane przez parametr w czasie wykonywania.

  3. W kontrolce KQL dodaj ten fragment kodu:

    requests
    | summarize Requests = count() by appName, name
    | order by Requests desc
    
  4. Uruchom zapytanie, aby wyświetlić wyniki.

    Zrzut ekranu przedstawiający parametr zasobu, do którego odwołuje się kontrolka zapytania.

Takie podejście może służyć do powiązania zasobów z innymi kontrolkami, takimi jak metryki.

Opcje parametrów zasobu

Parametr Opis Przykład
{Applications} Wybrany identyfikator zasobu. /subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label} Etykieta wybranego zasobu. acmefrontend Uwaga: w przypadku parametrów zasobu wielowartościowego etykieta może zostać skrócona acmefrontend (+3 others) i może nie zawierać wszystkich etykiet wszystkich wybranych wartości
{Applications:value} Wartość wybranego zasobu. "/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication"
{Applications:name} Nazwa wybranego zasobu. acmefrontend
{Applications:resourceGroup} Grupa zasobów wybranego zasobu. acmegroup
{Applications:resourceType} Typ wybranego zasobu. microsoft.insights/components
{Applications:subscription} Subskrypcja wybranego zasobu.
{Applications:grid} Siatka przedstawiająca właściwości zasobu. Przydatne do renderowania w bloku tekstowym podczas debugowania.

Następne kroki

Wprowadzenie do skoroszytów platformy Azure