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 la lingua PromQL; per informazioni su PromQL, 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 leaderboard Pagina Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- 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.
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à Trova e sostituisci. Per trovare e, facoltativamente
sostituisci termini della query, premi Control+F (o Command+F su Mac). La
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 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 che gli errori, l'editor mostrerà 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 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 hai creato grafico:
- 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 leaderboard Pagina Esplora metriche:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- 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 l'opzione di esecuzione automatica non è abilitata per l'editor di codice, esegui della 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.
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 al grafico un titolo descrittivo.
Se l'opzione di esecuzione automatica non è abilitata per l'editor di codice, esegui della 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 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.