Utilizzare l'editor di codice per MQL

Questa sezione descrive le funzionalità dell'editor di codice per Monitoring Query Language (MQL). L'editor è disponibile in console Google Cloud e fornisce suggerimenti, rilevamento degli errori e altre per la creazione di query MQL valide.

Questa pagina non riguarda la lingua MQL; per una serie di esempi e per ulteriori informazioni sulla lingua, consulta gli esempi e Informazioni sulla lingua MQL. Riferimento MQL fornisce un riferimento completo per la lingua.

Accesso all'editor di codice

Per accedere all'editor di codice quando utilizzi Esplora metriche, procedi nel seguente modo:

1. Nella console Google Cloud, vai alla Pagina Esplora metriche:

   Vai a Esplora metriche

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.

2. Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
3. Verifica che sia selezionato MQL con l'opzione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti. consente di formattare la query.

Utilizzi passaggi simili per accedere all'editor di codice quando crei un grafico in una Fitbit.com.

Utilizzo dell'editor di codice

Per utilizzare l'editor di codice, digita la query nell'editor di query 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.

Messaggi di errore

I messaggi di errore vengono visualizzati nella parte inferiore del riquadro dell'editor.

Se nella query sono presenti errori che interferiscono con il completamento automatico suggerimenti, messaggi di errore visualizzati durante la digitazione. In caso contrario, i messaggi di errore appaiono quando esegui la query.

Piegatura del codice

L'editor offre la possibilità di comprimere i segmenti del per nasconderle temporaneamente.

L'editor indica i segmenti pieghevoli della query con l'accento circonflesso accanto al numeri di riga, come mostrato nello screenshot seguente:

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 configurare l'editor di codice 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 , l'editor mostra un triangolo giallo nella barra di controllo. Se c'è nella stanza virtuale, viene visualizzato anche il testo Query incompleta.

  L'editor di codice 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

Da Esplora metriche

Dall'editor di codice in Metrics Explorer, puoi scegliere di salvare in una dashboard. Per salvare il grafico:

1. Se l'opzione di esecuzione automatica non è abilitata, esegui la query facendo clic su Esegui query prima di salvare il grafico. Se non esegui la query l'editor di codice salva l'ultima query eseguita.

2. Fai clic su Salva grafico. Una finestra di dialogo indica che il salvataggio del grafico sostituisce la query con una in un modulo di testo. Per ulteriori informazioni, consulta la sezione Query in formato rigido.

3. Per continuare a salvare il grafico:

   1. Assegna al grafico un titolo descrittivo.
   2. Seleziona la dashboard per il nuovo grafico.
   3. Fai clic su Salva nella finestra di dialogo.

Da una dashboard

Per salvare un grafico che stai aggiungendo a una dashboard, segui questi passaggi:

1. Assegna al grafico un titolo descrittivo.

2. Se l'opzione di esecuzione automatica non è abilitata, esegui la query facendo clic su Esegui query prima di salvare il grafico. Se non esegui la query l'editor di codice salva l'ultima query eseguita.

3. Fai clic su Salva. Una finestra di dialogo indica che il salvataggio del grafico sostituisce la query con una in un modulo di testo. Per ulteriori informazioni, consulta la sezione Query in formato rigido.

4. Fai clic su Salva nella finestra di dialogo per salvare il grafico e tornare alla dashboard.

Esci dall'editor di codice

Per uscire dall'editor di codice senza salvare un grafico o una condizione: Fai clic su Torna al widget del selettore di query. Qualsiasi testo della query nell'editor viene eliminato, ma hai la possibilità di salvarlo negli appunti.

Visualizza le query in formato rigido

Per visualizzare una query in forma rigorosa quando utilizzi l'editor di codice: fai clic su Altre opzioni e seleziona Visualizza in forma rigida.

Per ulteriori informazioni, consulta la sezione Query in formato rigido.

Intervalli di tempo, grafici e l'editor di codice

Ad eccezione delle query MQL utilizzate nelle condizioni per i criteri di avviso, Le query MQL nell'editor di codice devono includere un intervallo di tempo. L'intervallo di tempo specifica il sottoinsieme di dati da restituire come parte la query. L'intervallo di tempo può essere espresso implicitamente utilizzando il metodo selettore dell'intervallo di tempo o esplicitamente nel testo della query MQL.

Per impostazione predefinita, il selettore dell'intervallo di tempo è impostato su un'ora.

Per modificare l'intervallo di tempo di un grafico, utilizza il selettore dell'intervallo di tempo. Per Ad esempio, se vuoi visualizzare i dati dell'ultima settimana, seleziona Ultima settimana dal selettore dell'intervallo di tempo. Puoi anche specificare un'ora di inizio e di fine o specifica un orario in cui esplorare il mondo.

Per informazioni sulla creazione di criteri di avviso con l'editor di codice, consulta Creazione di criteri di avviso MQL.

Utilizzare le impostazioni del grafico per la selezione temporale

Puoi impostare il periodo di tempo per una query utilizzando il selettore di data e ora del grafico. Questo selettore è il modo predefinito per impostare il periodo di tempo. Per modificare l'ora periodo, seleziona un'opzione di tempo diversa sul grafico. Se selezioni, ad esempio, una settimana, la query restituisce i dati da oggi a una settimana prima.

Quando utilizzi questo meccanismo predefinito, non devi specificare un nel testo della query. Il valore sul grafico è utilizzato in modo implicito.

Utilizzo di within per la selezione dell'intervallo di tempo

Puoi specificare l'intervallo di tempo per la query in modo esplicito nella query utilizzando l'operazione within. Questa operazione determina l'intervallo che ha restituito dati. Se la query include un'operazione within, le opzioni di selezione dell'ora sul grafico sono disabilitate e l'intervallo di tempo specificato della query.

Se rimuovi un'operazione within esplicita dalla query, il grafico vengono riattivate automaticamente, assicurando che la query include un periodo di tempo.

Devi utilizzare una selezione temporale esplicita se vuoi usare il metodo API timeSeries.query per eseguire la query. Per ulteriori informazioni, vedi Utilizzo di MQL dall'API Monitoring.

Impostazioni di tempo e grafici salvati

Se utilizzi MQL per creare un grafico e poi lo salvi in una dashboard, accadono due cose alla tua query:

1. La query che hai fornito nell'editor viene convertita in canonica oppure rigorosa, forma. La conversione non cambia il significato della tua query, rende espliciti ciò che si presume nella query, come la colonna intera nomi o operazioni di allineamento. Per ulteriori informazioni, vedi Query in formato restrittivo.

2. La selezione dell'intervallo di tempo nella query viene rimossa. Grafici sulle dashboard condividi un selettore di orario e le modifiche apportate a quest'ultimo si applicano a tutti i grafici la dashboard. Pertanto, il selettore dell'intervallo di tempo della query originale non è più necessario.

Per informazioni sulla gestione delle dashboard e sulla modifica dei grafici, consulta Gestire le dashboard personalizzate.

Query, allineamento e periodi di visualizzazione

MQL include una serie di operazioni potenzialmente poco chiare, che specificano il tempo cicli. Le seguenti operazioni sono correlate all'intervallo di una query:

• within: specifica la finestra di output della query. Questo determina la quantità di dati restituiti. Se, ad esempio, specifichi within 1h, la query produce solo punti i cui timestamp sono compresi nell'ultima ora, motivo per cui questa operazione ha la precedenza sulla del selettore dell'ora.

• Le seguenti operazioni riguardano il periodo di allineamento dell'output tabelle. Entrambe richiedono una tabella allineata come input oppure forniscono un valore predefinito:

  • every: specifica il periodo per l'output della tabella allineato.

  • window: specifica la finestra per le operazioni di allineamento.

  In entrambi i casi, se un'operazione align viene fornita con un'istruzione finestra di allineamento, deve corrispondere al periodo specificato per window operativa, se fornita. Per la funzione di allineamento delta, la finestra di allineamento e il periodo devono essere uguali; se un allineamento esplicito finestra, l'operazione every, se fornita, deve accettare. In tutto in alcuni casi, la finestra di allineamento deve essere grande almeno quanto del periodo o dei dati di input verranno ignorati.

MQL ha anche un'operazione graph_period, che specifica il periodo dei punti di output per i grafici. Questa operazione è utile delle query date all'API il cui output viene rappresentato da un software di terze parti. Il software di creazione di grafici di Monitoring ignora l'graph_period operativa nelle query, impostando il periodo di punti in base alla larghezza dell'output del grafico di output.

Nei grafici di Monitoring, il periodo del grafico è impostato in base alla valore del selettore dell'intervallo di tempo del grafico e il numero massimo di punti che un grafico può visualizzare. Ad esempio, se selezioni una settimana, potrebbe essere di un'ora. Per i grafici sulle dashboard, per visualizzare al periodo del grafico, fai clic su Statistiche query.

La relazione tra il periodo di allineamento della query e il periodo del grafico può modificare l'aspetto di un grafico. Questa relazione viene descritta di seguito .

Bande min/max

Quando il periodo di allineamento della query si avvicina al periodo del grafico, il grafico rappresenta ogni serie temporale grafica con una singola linea. Se la query periodo di allineamento è inferiore alla metà del periodo del grafico, il grafico include un'area ombreggiata attorno a ogni linea. Questa regione, chiamata min/max band, mostra l'intervallo di valori che hanno prodotto il valore medio.

Ad esempio, supponi la seguente query MQL:

fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
| group_by [zone], mean(val())
| every 1h

Questa query restituisce l'utilizzo medio della CPU delle VM per zona, con un periodo di allineamento di un'ora.

Se il selettore di tempo del grafico è impostato su una settimana, il periodo del grafico è un'ora, come indicato in un chip. Per la query di esempio, il grafico periodo e periodo di allineamento sono uguali. L'esecuzione della query produce un grafico ha il seguente aspetto:

Ad esempio, se modifichi il periodo di allineamento passato a every operazione da 1h a 1m nella query precedente, la query produce un che include le bande min/max:

Le linee del grafico sono rappresentate con un periodo di un'ora, basato sul una settimana per il grafico, in modo che le linee siano le stesse dell'esempio precedente. ma la query produce un punto ogni minuto, Le bande min/max mostrano l'intervallo di valori di un minuto della query che rientrano in ogni punto del grafico di un'ora.

Se l'operazione every viene omessa, il periodo di allineamento della query predefinito è il valore della finestra di allineamento o, se la finestra di allineamento non è specificato, un minuto.

Criteri di avviso basati su MQL

Puoi anche utilizzare MQL e l'editor di codice per creare query per i criteri di avviso.

Per creare un criterio di avviso basato su MQL dalla console Google Cloud, segui la consueta procedura di creazione della norma, descritta nella Gestire i criteri di avviso, ma quando crei la condizione per il criterio di avviso, utilizzerai l'editor di codice anziché l'editor di codice selettore delle metriche.

Per saperne di più, consulta la sezione Creazione di criteri di avviso MQL.

Conversione query

Puoi utilizzare il selettore di metriche per i grafici o in Metrics Explorer per creare una query e poi convertirla in MQL. La query MQL corrispondente viene mostrata nell'editor.

Per convertire una query creata tramite menu in MQL, quando utilizzi Metrics Explorer, segui questi passaggi:

1. Nella barra degli strumenti della riquadro Query Builder, seleziona il pulsante con  MQL o  PromQL.
2. Verifica che sia selezionato MQL con l'opzione Lingua. Il pulsante di attivazione/disattivazione della lingua si trova nella stessa barra degli strumenti. consente di formattare la query.

Per convertire una query basata su modulo in MQL, quando visualizzi un grafico in una dashboard, fai clic su MQL.

Consideriamo una richiesta molto semplice, ad esempio "Ottieni l'utilizzo della CPU di Compute Engine." Questa query riguarda gce_instance tipo di risorsa monitorata e compute.googleapis.com/instance/cpu/usage_time tipo di metrica.

Il seguente screenshot mostra questa query nel selettore di metriche basate su moduli:

I tipi di metrica e di risorse monitorate sono stati inseriti manualmente. Tutti gli altri campi hanno i loro valori predefiniti.

Il seguente screenshot mostra il risultato della conversione del modello in una query MQL:

La query MQL recupera le serie temporali per la metrica specificata e tipi di risorse ed esegue l'allineamento della frequenza a intervalli di 1 minuto. La query convertita è in formato restrittivo.

Nota: non puoi riconvertire la rappresentazione MQL in impostazioni del del selettore di metriche basato sul modulo. MQL supporta query che non puoi creare con il selettore delle metriche. Quando esci dall'editor di codice, il testo della query viene viene eliminato se non lo salvi.