Parametri delle risorse della cartella di lavoro

I parametri delle risorse consentono di selezionare le risorse nelle cartelle di lavoro. Questa funzionalità è utile per impostare l'ambito da cui ottenere i dati. Un esempio consente di selezionare il set di macchine virtuali, che i grafici usano in un secondo momento durante la presentazione dei dati.

I valori di selezione risorse possono provenire dal contesto della cartella di lavoro, dall'elenco statico o dalle query di Azure Resource Graph.

Nota

L'etichetta per ogni risorsa nell'elenco dei parametri della risorsa si basa sull'ID risorsa. Non è possibile sostituire tale nome con un altro valore. Per maggiore chiarezza, gli esempi in questo documento mostrano il campo etichetta impostato sull'ID, ma tale valore non viene usato nel parametro effettivo.

Creare un parametro di risorsa (risorse della cartella di lavoro)

1. Iniziare con una cartella di lavoro vuota in modalità di modifica.

2. Selezionare Aggiungi parametri>Aggiungi parametro.

3. Nel nuovo riquadro dei parametri visualizzato immettere:

   1. Nome parametro: Applications
   2. Tipo di parametro: Resource picker
   3. Obbligatorio: checked
   4. Consenti selezioni multiple: checked
   5. Ottenere dati da: Workbook Resources
   6. Includere solo i tipi di risorse: Application Insights

4. Selezionare Salva per creare il parametro.

   

Creare un parametro di risorsa di Azure Resource Graph

1. Iniziare con una cartella di lavoro vuota in modalità di modifica.

2. Selezionare Aggiungi parametri>Aggiungi parametro.

3. Nel nuovo riquadro dei parametri visualizzato immettere:

   1. Nome parametro: Applications
   2. Tipo di parametro: Resource picker
   3. Obbligatorio: checked
   4. Consenti selezioni multiple: checked
   5. Ottenere dati da: Query
   6. Tipo di query: Azure Resource Graph
   7. Sottoscrizioni: Use default subscriptions
   8. Nel controllo query aggiungere questo frammento di codice:

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

4. Selezionare Salva per creare il parametro.

   

Per altre informazioni su Azure Resource Graph, vedere Informazioni su Azure Resource Graph.

Creare un parametro di risorsa elenco JSON

1. Iniziare con una cartella di lavoro vuota in modalità di modifica.
2. Selezionare Aggiungi parametri>Aggiungi parametro.
3. Nel nuovo riquadro dei parametri visualizzato immettere:

   1. Nome parametro: Applications

   2. Tipo di parametro: Resource picker

   3. Obbligatorio: checked

   4. Consenti selezioni multiple: checked

   5. Ottenere dati da: JSON

   6. Nel controllo contenuto aggiungere questo frammento 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. Selezionare Aggiorna.

4. Facoltativamente, impostare su Include only resource typesApplication Insights.
5. Selezionare Salva per creare il parametro.

Fare riferimento a un parametro di risorsa

1. Selezionare Aggiungi query per aggiungere un controllo query e quindi selezionare una risorsa di Application Insights.

2. Usare l'elenco a discesa di Application Insights per associare il parametro al controllo . Questo passaggio imposta l'ambito della query sulle risorse restituite dal parametro in fase di esecuzione.

3. Nel controllo KQL aggiungere questo frammento di codice:

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

4. Eseguire la query per visualizzare i risultati.

   

Questo approccio può essere usato per associare risorse ad altri controlli come le metriche.

Opzioni dei parametri della risorsa

Parametro	Descrizione	Esempio
{Applications}	ID risorsa selezionato.	/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication
{Applications:label}	Etichetta della risorsa selezionata.	acmefrontend Nota: per i parametri delle risorse multivalore, questa etichetta può essere abbreviata come acmefrontend (+3 others) e potrebbe non includere tutte le etichette di tutti i valori selezionati
{Applications:value}	Valore della risorsa selezionata.	'/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication'
{Applications:name}	Nome della risorsa selezionata.	acmefrontend
{Applications:resourceGroup}	Gruppo di risorse della risorsa selezionata.	acmegroup
{Applications:resourceType}	Tipo della risorsa selezionata.	microsoft.insights/components
{Applications:subscription}	Sottoscrizione della risorsa selezionata.
{Applications:grid}	Griglia che mostra le proprietà della risorsa. Utile per il rendering in un blocco di testo durante il debug.

Passaggi successivi

Introduzione alle cartelle di lavoro di Azure