Creare un widget basato su query utilizzando le metriche

È possibile creare un widget basato su query utilizzando le metriche del servizio Oracle Cloud Infrastructure Monitoring.

1. Andare alla pagina Dashboard.
2. Fare clic su Crea dashboard per creare un nuovo dashboard o aprirne uno esistente in modalità di modifica.
3. Facoltativamente, aggiungere il filtro Dimensione metrica al dashboard.

   È possibile utilizzare il filtro Dimensione metrica per specificare l'input della dimensione metrica per un widget basato su query. Per informazioni, vedere Utilizzare il filtro dimensione metrica.

4. Nella scheda Widget, fare clic sull'icona Aggiungi gruppo di widget e widget () e fare clic su Crea widget basato su query....
   Viene visualizzato il generatore di widget basato su query.
5. Facoltativamente, fare clic sull'icona Apri/chiudi pannello filtri () per visualizzare i filtri aggiunti al dashboard e apportare le modifiche necessarie.

   Tenere presente che quando si crea un widget basato su query per aggiungerlo a un nuovo dashboard, viene aggiunto automaticamente un filtro Compartimento e l'input del compartimento per il nuovo widget in fase di creazione viene collegato a questo nuovo filtro aggiunto. Inoltre, la casella di controllo Compartimenti secondari viene visualizzata nel filtro Compartimento ed è possibile selezionarla per visualizzare i dati delle metriche da tutti i compartimenti secondari all'interno del compartimento radice. L'opzione per visualizzare i dati delle metriche dai compartimenti secondari può essere utilizzata solo se il compartimento radice è selezionato nel filtro Compartimento.

6. Nell'angolo in alto a destra selezionare il periodo di tempo per il quale si desidera visualizzare i dati nel widget.
7. Selezionare Monitoraggio nel campo Origine dati.
8. Specificare i dettagli della metrica del servizio di monitoraggio riportati di seguito.
   1. Spazio di nomi: selezionare lo spazio di nomi applicabile.
   2. Gruppo di risorse: è possibile selezionare un gruppo di risorse, se disponibile. Un gruppo di risorse è una stringa personalizzata fornita con una metrica personalizzata e può essere utilizzata come filtro o per aggregare i risultati.
   3. Query: modificare la query predefinita visualizzata in questo campo o immettere una nuova query per recuperare le informazioni sulla metrica che si desidera visualizzare nel widget.

      Le query utilizzate per creare widget basati su query utilizzano la sintassi MQL (METRIC[auto].grouping().mean()), che regola le espressioni per l'esecuzione di query sulle metriche pubblicate nel servizio di monitoraggio. Per informazioni, vedere Riferimento MQL (Monitoring Query Language).

   4. Fare clic su Esegui.

   La query viene eseguita e i dati della metrica vengono visualizzati in formato tabulare con il nome della metrica, l'indicatore orario e il valore. Sotto il grafico Tabella, viene visualizzata un'altra tabella con i dati non elaborati restituiti dalla query ed è possibile fare clic su Nascondi dati non elaborati per nasconderli.

9. Facoltativamente, aggiungere i parametri di input per rendere riutilizzabile il widget fornendo valori diversi di tale parametro. Ad esempio, i parametri di input possono essere configurati per filtrare i dati in base a una dimensione specifica, in cui il valore viene fornito tramite il parametro. Se si sta creando un widget basato su query per il servizio Gestione database (spazio di nomi oracle_oci_database) per visualizzare l'utilizzo della CPU (metrica CpuUtilization), è possibile aggiungere un parametro di input utilizzando la dimensione resourceName e configurare i valori delle dimensioni per visualizzare i dati di utilizzo della CPU per risorse specifiche nel widget.
   1. Nella scheda Impostazioni, fare clic su Aggiungi input +.
   2. Nella finestra di dialogo Configura input per widget senza titolo (facoltativo):
      1. Nome di input: immettere un nome per il parametro di input. Ad esempio, se si desidera aggiungere la dimensione resourceName come parametro di input per il widget, il nome input potrebbe essere nome risorsa. Si noti che il nome di input è obbligatorio quando si aggiunge un'espressione segnaposto alla query.
      2. Etichetta di input: immettere un nome visualizzato per l'input. Il nome di input viene visualizzato in questo campo per impostazione predefinita ed è possibile modificarlo per renderlo più intuitivo.
      3. Impostazioni predefinite: se necessario, rivedere e modificare le impostazioni predefinite.
         Nota
         
         Se si aggiornano le impostazioni predefinite per configurare il parametro di input, le stesse impostazioni verranno applicate ogni volta che questo widget viene aggiunto a un dashboard diverso. Per configurare un parametro di input il cui valore può essere modificato dopo la creazione e l'aggiunta del widget alla libreria di widget, utilizzare le opzioni disponibili nella sezione Configura input widget di questa finestra di dialogo.
         • Obbligatorio: selezionare questa opzione per indicare che si tratta di un input widget obbligatorio. Se si seleziona questa casella di controllo e non si configura il parametro di input, i dati non verranno visualizzati nel widget.
         • Consenti valori multipli: selezionare questa opzione per consentire la configurazione di più valori per il parametro di input.
         • Consenti agli utenti del widget di collegare l'input <nome> con un filtro: deselezionare questa casella di controllo per specificare solo un valore di parametro di input fisso. Questa casella di controllo è selezionata per impostazione predefinita e, se deselezionata, i campi disponibili per collegare l'input a un filtro non vengono visualizzati nella finestra di dialogo.
         • Consenti agli utenti del widget di specificare l'input <nome>: deselezionare questa casella di controllo per collegare solo l'input a un filtro. Questa casella di controllo è selezionata per impostazione predefinita e, se deselezionata, i campi disponibili per specificare un valore di parametro di input fisso non vengono visualizzati nella finestra di dialogo.
      4. Configura input del widget: selezionare una delle opzioni riportate di seguito per configurare il parametro di input.
         • Collegare l'input a un filtro esistente: selezionare questa opzione per collegare il parametro di input a un filtro esistente nel widget.
         • Specificare l'input: selezionare questa opzione per specificare un valore di parametro di input fisso che verrà utilizzato solo nel contesto del widget.
         • Non configurato: selezionare questa opzione per lasciare l'input non configurato.
   3. Aggiungere un segnaposto alla query per visualizzare i dati del parametro di input aggiuntivo nel widget utilizzando l'espressione seguente:

      {<dimension>=$(params.<input_name>)}

      Prendendo lo stesso esempio indicato all'inizio del passo 8, dopo l'aggiunta di un parametro di input per la dimensione resourceName, è necessario aggiungere la seguente espressione segnaposto (in grassetto) alla query CpuUtilization per filtrare i dati in base alla risorsa nel widget:

      CpuUtilization[auto]{resourceName=$(params.resourcename)}.mean()

10. Utilizzare le seguenti schede sul lato destro per eseguire attività quali l'aggiunta di un nome per il widget e la personalizzazione della visualizzazione dei dati nel widget:
    Nota
    
    È possibile fare clic su JSON nell'angolo superiore destro per modificare direttamente i metadati JSON del widget. L'editor JSON offre una maggiore flessibilità e più opzioni per visualizzare i dati nel widget. Tuttavia, si consiglia di utilizzarlo solo se si ha familiarità con la modifica del widget JSON. Per ulteriori informazioni sull'editor JSON, contattare il Supporto Oracle.

    • Informazioni: immettere un nome per il widget, selezionare il compartimento in cui si desidera che il widget risieda e aggiungere una descrizione per il widget.

      Facoltativamente, fare clic su Mostra opzioni avanzate per aggiungere tag in formato libero o definiti al widget. Se si dispone delle autorizzazioni necessarie per creare un widget, si dispone anche delle autorizzazioni per aggiungere tag in formato libero. Per aggiungere una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag. Per informazioni su:

      • Applicazione di tag ai concetti e alle autorizzazioni necessarie per utilizzare le tag. Vedere Panoramica sull'applicazione di tag.
      • Per informazioni su come aggiungere una tag durante la creazione della risorsa, vedere Per aggiungere una tag durante la creazione della risorsa.
    • Visualizzazione: selezionare un tipo di grafico e personalizzare la visualizzazione specificando o modificando opzioni aggiuntive.

      Per informazioni sui tipi di grafico e sulle opzioni di visualizzazione in una Costruzione guidata widget basata su query, vedere Informazioni sui tipi di grafico e sulle opzioni di visualizzazione.

    • Impostazioni: rivedere e modificare gli input dei widget, se necessario.
11. Fare clic su Salva per salvare il widget nella libreria di widget e aggiungerlo al dashboard.