Ressourcenparameter für Arbeitsmappen

Ressourcenparameter ermöglichen das Auswählen von Ressourcen in Arbeitsmappen. Diese Funktion ist nützlich, um den Bereich festzulegen, aus dem die Daten abgerufen werden sollen. Beispielsweise kann ein Benutzer die Gruppe virtueller Computer auswählen, die später in den Diagrammen bei der Vorstellung der Daten verwendet werden.

Die Werte aus der Ressourcenauswahl können aus dem Arbeitsmappenkontext, einer statischen Liste oder aus Azure Resource Graph-Abfragen stammen.

Hinweis

Die Bezeichnung der einzelnen Ressourcen in der Ressourcenparameterliste basiert auf der Ressourcen-ID. Dieser Namen kann nicht durch einen anderen Wert ersetzt werden. Hinweis: In den Beispielen in diesem Dokument ist das Bezeichnungsfeld auf die ID festgelegt, dieser Wert wird jedoch im tatsächlichen Parameter nicht verwendet.

Erstellen eines Ressourcenparameters (Arbeitsmappenressourcen)

1. Beginnen Sie mit einer leeren Arbeitsmappe im Bearbeitungsmodus.

2. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.

3. Geben Sie in das sich öffnende neue Parameterfenster ein:

   1. Name des Parameters: Applications
   2. Typ des Parameters: Resource picker
   3. Erforderlich: checked
   4. Mehrfachauswahl zulassen: checked
   5. Daten abrufen aus: Workbook Resources
   6. Nur folgende Ressourcentypen einschließen: Application Insights

4. Wählen Sie Speichern aus, um den Parameter zu erstellen.

   

Erstellen eines Azure Resource Graph-Ressourcenparameters

1. Beginnen Sie mit einer leeren Arbeitsmappe im Bearbeitungsmodus.

2. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.

3. Geben Sie in das sich öffnende neue Parameterfenster ein:

   1. Name des Parameters: Applications
   2. Typ des Parameters: Resource picker
   3. Erforderlich: checked
   4. Mehrfachauswahl zulassen: checked
   5. Daten abrufen aus: Query
   6. Abfragetyp: Azure Resource Graph
   7. Abonnements: Use default subscriptions
   8. Fügen Sie im Abfragesteuerelement den folgenden Codeausschnitt ein:

   where type == 'microsoft.insights/components'
   | project value = id, label = id, selected = false, group = resourceGroup
   

4. Wählen Sie Speichern aus, um den Parameter zu erstellen.

   

Weitere Informationen über Azure Resource Graph finden Sie unter Was ist Azure Resource Graph?.

Erstellen eines JSON-Listenressourcenparameters

1. Beginnen Sie mit einer leeren Arbeitsmappe im Bearbeitungsmodus.
2. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.
3. Geben Sie im anschließend angezeigten Bereich für den neuen Parameter Folgendes ein:

   1. Name des Parameters: Applications

   2. Typ des Parameters: Resource picker

   3. Erforderlich: checked

   4. Mehrfachauswahl zulassen: checked

   5. Daten abrufen aus: JSON

   6. Fügen Sie im Inhaltssteuerelement den folgenden JSON-Codeausschnitt hinzu:

      [
          { "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. Wählen Sie Aktualisieren aus.

4. Definieren Sie optional Include only resource types als Application Insights.
5. Wählen Sie Speichern aus, um den Parameter zu erstellen.

Verweisen auf einen Ressourcenparameter

1. Wählen Sie Abfrage hinzufügen, um ein Abfragesteuerelement hinzuzufügen und wählen Sie dann eine Application Insights-Ressource aus.

2. Verwenden Sie das Dropdownmenü unter Application Insights, um den Parameter an das Steuerelement anzubinden. Hierdurch wird der Bereich der Abfrage auf die Ressourcen festgelegt, die während der Laufzeit vom Parameter zurückgegeben werden.

3. Fügen Sie im KQL-Steuerelement den folgenden Codeausschnitt hinzu:

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

4. Führen Sie die Abfrage aus, um sich die Ergebnisse anzeigen zu lassen.

   

Diese Methode kann verwendet werden, um Ressourcen an andere Steuerelemente (z.B. Metriken) zu binden.

Optionen für Ressourcenparameter

Parameter	BESCHREIBUNG	Beispiel
{Applications}	Die ausgewählte Ressourcen-ID.	/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label}	Das Kennzeichen der ausgewählten Ressource.	acmefrontend Hinweis: Bei Ressourcenparametern mit mehreren Werten wird diese Bezeichnung ggf. gekürzt (Beispiel: acmefrontend (+3 others)) und enthält nicht alle Bezeichnungen aller ausgewählten Werte.
{Applications:value}	Der Wert der ausgewählten Ressource.	'/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication'
{Applications:name}	Der Name der ausgewählten Ressource.	acmefrontend
{Applications:resourceGroup}	Die Ressourcengruppe der ausgewählten Ressource.	acmegroup
{Applications:resourceType}	Die Art der ausgewählten Ressource.	microsoft.insights/components
{Applications:subscription}	Das Abonnement der ausgewählten Ressource.
{Applications:grid}	Ein Raster mit den Ressourceneigenschaften. Kann während des Debuggens in einen Textblock umgewandelt werden.

Nächste Schritte

Erste Schritte mit Azure-Arbeitsmappen