È possibile creare un widget basato su query utilizzando i trace di Application Performance 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. 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.
4. Facoltativamente, fare clic sull'icona Apri/chiudi pannello filtri () per visualizzare i filtri già 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.

5. Nell'angolo in alto a destra selezionare il periodo di tempo per il quale si desidera visualizzare i dati nel widget.
6. Selezionare Tracce nell'elenco a discesa Origine dati.
   Se un filtro dominio APM non viene aggiunto al dashboard, viene aggiunto automaticamente quando si seleziona Tracce.
7. Modificare la query predefinita visualizzata nel campo Query o immettere una nuova query, quindi fare clic su Esegui.

   Utilizzare la sintassi TQL per creare query e recuperare i dati di trace da Application Performance Monitoring. Per informazioni su TQL, vedere Utilizzo delle query.

   I dati di trace vengono visualizzati in formato tabulare con il nome del servizio e altri dettagli. Sotto il grafico della tabella viene visualizzata un'altra tabella con i dati di tipo RAW restituiti dalla query di trace. È possibile fare clic su Nascondi dati di tipo RAW per nasconderli.

8. 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.

     Se si seleziona Tabella come tipo di grafico, è possibile rimuovere alcune colonne oppure selezionare la casella di controllo Tutte le colonne per visualizzare tutte le colonne. I tipi di grafico con assi X e Y, ad esempio il grafico Linea, dispongono di una combinazione delle seguenti opzioni di visualizzazione aggiuntive:

     • Asse X: selezionare l'attributo dati che si desidera proiettare sull'asse X.
     • Asse Y: selezionare l'attributo dati che si desidera proiettare sull'asse Y. L'asse Y supporta gli attributi di dati numerici e solo quelli sono elencati.
     • Serie: selezionare l'attributo dati che si desidera rappresentare in serie separate nel grafico. Questa opzione è disponibile anche per un grafico A torta.
     • Dimensione: selezionare un attributo dati ai cui valori si desidera assegnare la dimensione. Questa opzione è disponibile solo per un grafico A bolle.
     • Colore per: selezionare l'attributo dati al quale si desidera assegnare colori distinti. In genere, l'opzione Colore per viene utilizzata insieme all'opzione Serie per assegnare colori distinti alla serie separata. Questa opzione è disponibile anche per un grafico A torta.
     • Titolo asse X: specificare un titolo per l'attributo dati proiettato sull'asse X.
     • Titolo asse Y: specificare un titolo per l'attributo dati proiettato sull'asse Y.
     • Legenda: specificare la posizione della legenda nel widget. Questa opzione è disponibile anche per un grafico A torta.
     • Descrizione comandi correlate: selezionare questa opzione per correlare le descrizioni comandi in tutti i widget basati su query nel dashboard.
     • Cursore dati: selezionare questa opzione per visualizzare la descrizione comandi quando si passa il puntatore del mouse sul widget.
     • In pila: selezionare questa opzione se si desidera sovrapporre gli attributi dati visualizzati nel grafico, per colore.
     • Usa colore tinta unita: quando si utilizza un grafico Area per la visualizzazione, l'area che rappresenta la presenza di dati viene coperta con un colore tinta unita. Questa opzione è selezionata per impostazione predefinita.

     Per ulteriori informazioni sulle opzioni di visualizzazione in una Costruzione guidata widget basata su query, vedere Informazioni sulle opzioni di visualizzazione.

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