In questa pagina viene descritto come utilizzare l'editor di codice per PromQL. L'editor, disponibile nella console Google Cloud, 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 di creazione di query, seleziona il pulsante con il nome code MQL o code PromQL.
- Verifica che l'opzione PromQL sia selezionata nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.
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 completamenti
sintatticamente validi. Puoi visualizzare manualmente il menu del completamento automatico premendo
Control+Space e chiuderlo 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à Trova e sostituisci. Per trovare e, facoltativamente, sostituire i termini nella query, premi Control+F (o Command+F su Mac). Il
seguente screenshot 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 durante la digitazione, 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 priva di errori, l'editor mostra 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 controllo tra l'editor di codice e l'area del grafico. Utilizza questa barra per modificare le dimensioni relative delle due regioni.
Salva 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 salvare il grafico in 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 di creazione di query, seleziona il pulsante con il nome code MQL o code PromQL.
- Verifica che l'opzione PromQL sia selezionata nell'opzione di attivazione/disattivazione Lingua. L'opzione di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti che ti consente di formattare la query.
- Inserisci la query nell'editor.
Se l'opzione di esecuzione automatica per l'editor di codice non è abilitata, 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 che ti interessa 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 l'opzione di esecuzione automatica per l'editor di codice non è abilitata, 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.
Se non hai attivato il salvataggio automatico per la dashboard, fai clic su Salva.
La console Google Cloud supporta i filtri a livello di pagina per le dashboard personalizzate. 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. Qualsiasi testo della query nell'editor viene ignorato, ma hai la possibilità di salvarlo negli appunti.