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 riguarda la lingua PromQL; per informazioni su PromQL, consigliamo di consultare la documentazione open source. Le seguenti risorse possono aiutarti a iniziare:
Accedere 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:
-
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 della riquadro Query Builder, seleziona il pulsante con 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. 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 del completamento automatico premendo
Control+Space e puoi chiuderla premendo Escape.
Per spostarti nell'elenco delle opzioni, utilizza i tasti freccia.
Premi Enter per inserire 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 la sua modalità di interazione con la query.
Per impostazione predefinita, la query viene eseguita solo quando fai clic su Esegui query. Puoi configurare l'editor in modo che esegua automaticamente la query mentre digiti, 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 è attiva, 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 ci sono spazio, viene visualizzato anche il testo Query incompleta.
L'editor non tenta di valutare le query incomplete.
È presente anche una barra di trascinamento tra l'editor di codice e l'area 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 lo hai creato:
- Da Esplora metriche.
- Durante la creazione o la 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 della riquadro Query Builder, seleziona il pulsante con 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. 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 un titolo descrittivo al grafico.
- 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 al grafico un titolo descrittivo.
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 non hai attivato il salvataggio automatico per la dashboard: fai clic su Salva.
La console Google Cloud supporta filtri a livello di pagina per dashboard. Questi filtri sono supportati per i grafici PromQL nelle 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. Il testo della query nell'editor viene eliminato, ma hai la possibilità di salvarlo negli appunti.