In questa pagina viene descritto come utilizzare l'editor di codice per PromQL. L'editore è disponibili nella console Google Cloud e fornisce suggerimenti e altri strumenti per la creazione di query PromQL valide.
Questa pagina non tratta il linguaggio PromQL. Per informazioni su PromQL, ti consigliamo di consultare la documentazione open source. Le seguenti risorse possono aiutarti a iniziare:
Accedi all'editor di codice
Puoi accedere a PromQL dalle seguenti pagine della console Google Cloud:
- Esplora metriche
- Aggiungi widget durante la creazione delle dashboard
Per aprire l'editor di codice quando utilizzi Metrics Explorer, segui questi passaggi:
-
Nella console Google Cloud, vai alla pagina leaderboard Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante code MQL o code PromQL.
- Verifica che PromQL sia selezionato nel pulsante di attivazione/disattivazione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
Dopo aver completato la query, puoi configurare la legenda o modificare il modo vengono visualizzati i dati. Per ulteriori informazioni, consulta le seguenti pagine:
Utilizzare l'editor di codice
Per utilizzare l'editor di codice, digita la query nel campo di testo e fai clic su Esegui query.
Completamento automatico
Mentre digiti la query, l'editor visualizza un elenco di dati sintatticamente validi
i completamenti obiettivo. Puoi visualizzare manualmente il menu di completamento automatico premendo Control+Space e chiuderlo premendo Escape.
Per navigare nell'elenco delle opzioni, utilizza i tasti Freccia.
Premendo Enter viene inserita la scelta selezionata.
Per inserire il prefisso comune a tutte le opzioni disponibili, premi Tab.
Trova e sostituisci
L'editor supporta una funzionalità di ricerca e sostituzione. Per trovare e, facoltativamente
sostituisci termini della query, premi Control+F (o Command+F su Mac). Lo screenshot seguente mostra la funzionalità:
Controlli dell'editor
L'editor dispone di due controlli che determinano il modo in cui interagisce con la query.
Per impostazione predefinita, la query viene eseguita solo quando fai clic su Esegui query. Puoi impostare l'editor in modo che esegua automaticamente la query digitata, ma questa opzione è disattivata per impostazione predefinita.
Per attivare l'opzione di esecuzione automatica, utilizza il pulsante di attivazione/disattivazione Esecuzione automatica. Quando questa opzione è abilitata, l'editor funziona nel seguente modo:
- Il pulsante Esegui query non viene visualizzato.
- I messaggi di errore vengono visualizzati continuamente durante la digitazione.
Se il cursore si trova alla fine di una query incompleta, ma senza errori, nell'editor viene visualizzato un triangolo giallo nella barra di controllo. Se c'è spazio, viene visualizzato anche il testo Query incompleta.
L'editor non tenta di valutare le query incomplete.
È presente anche una barra di scorrimento tra l'editor di codice e la regione del grafico. Utilizza questa barra per modificare le dimensioni relative delle due regioni.
Salvare i grafici
Il modo in cui salvi un grafico dipende dal contesto in cui hai creato grafico:
- Da Esplora metriche.
- Nell'ambito della creazione o della modifica di una dashboard personalizzata.
Salvare i grafici da Metrics Explorer
Nell'editor di codice in Metrics Explorer, puoi scegliere di salvare del grafico a una dashboard personalizzata. Per salvare il grafico:
-
Nella console Google Cloud, vai alla pagina leaderboard Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
- Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante code MQL o code PromQL.
- Verifica che PromQL sia selezionato con l'opzione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che consente di formattare la query.
- Inserisci la query nell'editor.
Se non hai attivato l'opzione di esecuzione automatica per l'editor di codice, esegui la query facendo clic su Esegui query prima di salvare il grafico. Per impostazione predefinita, le dashboard personalizzate salvano periodicamente le modifiche. Se non esegui prima la query, l'editor di codice salva l'ultima query eseguita.
Fai clic su Salva grafico.
Per continuare a salvare il grafico:
- Assegna al grafico un titolo descrittivo.
- Seleziona la dashboard per il nuovo grafico.
- Fai clic su Salva nella finestra di dialogo.
Salvare i grafici in una dashboard personalizzata
Per salvare un nuovo grafico nella dashboard:
Assegna un titolo descrittivo al grafico.
Se non hai attivato l'opzione di esecuzione automatica per l'editor di codice, esegui la query facendo clic su Esegui query prima di salvare il grafico. Per impostazione predefinita, le dashboard personalizzate salvano periodicamente le modifiche. Quando non esegui prima la query, l'editor di codice salva l'ultima query eseguita.
Se il salvataggio automatico non è attivo per la dashboard, fai clic su Salva.
La console Google Cloud supporta filtri a livello di pagina per dashboard. Questi filtri sono supportati per PromQL nelle tue dashboard personalizzate.
Esci dall'editor di codice
Per uscire dall'editor di codice senza salvare la query, fai clic su una delle altre schede del selettore. Qualsiasi testo della query nell'editor viene eliminato, ma hai la possibilità di salvarlo negli appunti.