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. Ad esempio consente di selezionare il set di macchine virtuali, che i grafici usano in un secondo momento durante la presentazione dei dati.

I valori risultanti dalla selezione delle risorse possono provenire dal contesto della cartella di lavoro, da un elenco statico o dalle query di Azure Resource Graph.

Nota

L'etichetta di ogni risorsa nell'elenco dei parametri delle risorse 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 riquadro del nuovo parametro che viene aperto, immettere:

    1. Nome parametro: Applications
    2. Tipo di parametro: Resource picker
    3. Obbligatorio: checked
    4. Consenti selezioni multiple: checked
    5. Ottieni i dati da: Workbook Resources
    6. Includi solo i tipi di risorse : Application Insights
  4. Selezionare Salva per creare il parametro.

    Screenshot che mostra la creazione di un parametro di risorsa tramite le risorse della cartella di lavoro.

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 riquadro del nuovo parametro che viene aperto, immettere:

    1. Nome parametro: Applications
    2. Tipo di parametro: Resource picker
    3. Obbligatorio: checked
    4. Consenti selezioni multiple: checked
    5. Ottieni i 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.

    Screenshot che mostra la creazione di un parametro di risorsa tramite Azure Resource Graph.

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

Creare un parametro di risorsa per l’elenco JSON

  1. Iniziare con una cartella di lavoro vuota in modalità di modifica.
  2. Selezionare Aggiungi parametri>Aggiungi parametro.
  3. Nel riquadro del nuovo parametro che viene aperto, immettere:
    1. Nome parametro: Applications

    2. Tipo di parametro: Resource picker

    3. Obbligatorio: checked

    4. Consenti selezioni multiple: checked

    5. Ottieni i 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 Include only resource types su Application 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 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.

    Screenshot che mostra un parametro di risorsa a cui si fa riferimento in un controllo query.

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

Opzioni dei parametri delle risorse

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 in 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 di 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

Iniziare a utilizzare Cartelle di lavoro di Azure