I dati degli SLO vengono archiviati in serie temporali. Puoi recuperare le serie temporali SLO specificando un selettore di serie temporali nel parametro filter del metodo timeSeries.list o utilizzando la modalità di filtro diretto in Esploratore delle metriche.
Criteri di avviso basati su SLO
Se stai creando un criterio di avviso utilizzando l'API Cloud Monitoring, specifica il filtro utilizzando un selettore di serie temporali come campo nella condizione di soglia del criterio. Per informazioni su come creare criteri di avviso basati su SLO utilizzando l'API Monitoring, consulta Creare un criterio di avviso.
Nei criteri di avviso è possibile utilizzare solo un sottoinsieme dei selettori delle serie temporali disponibili per gli SLO.
Inoltre, i criteri di avviso basati su SLO e creati con la console Google Cloud
utilizza sempre il selettore select_slo_burn_rate.
Utilizzare un selettore di serie temporali in un filtro
Per recuperare i dati delle serie temporali per gli SLO, il filtro deve specificare una serie temporale selettore. I dati SLO non vengono archiviati con i tipi di metriche e non possono da recuperare con il filtro che specifica una coppia di metriche e tipi di risorse monitorate.
Nomi e argomenti
I selettori delle serie temporali hanno uno dei seguenti formati:
SELECTOR_NAME(SLO_NAME) SELECTOR_NAME(SLO_NAME, LOOKBACK_PERIOD)
I selettori hanno nomi che iniziano con select_slo_ e accettano uno o due argomenti:
Il primo argomento del selettore è il nome della risorsa per un SLO, che ha il seguente aspetto:
projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID
L'espressione precedente contiene tre variabili:
- PROJECT_ID: nome o numero di un progetto Google Cloud.
- SERVICE_ID: nome di un servizio.
- SLO_ID: identificatore di uno SLO definito per il servizio.
Per informazioni su come trovare i valori per SERVICE_ID e SLO_ID campi per il tuo progetto Google Cloud, vedi Utilizzo dell'API.
Il secondo argomento, se supportato, è un periodo di riferimento. Consulta i tipi di avvisi relativi al budget di errore per informazioni sui periodi di riferimento. Le unità di tempo valide sono "ns", "us", "ms", "s", "m", "h".
Ad esempio, il selettore select_slo_budget prende un argomento SLO_NAME,
pertanto un filtro che utilizza questo selettore ha il seguente aspetto:
select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID")
Al contrario, il selettore select_slo_burn_rate richiede
SLO_NAME e LOOKBACK_PERIOD argomenti,
pertanto un filtro che utilizza questo selettore ha il seguente aspetto:
select_slo_burn_rate("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID", "3600s")
Per un elenco e una descrizione di tutti i selettori, vedi Selettori delle serie temporali.
Recupero dei dati con un selettore
Un modo per eseguire query sui dati delle serie temporali è utilizzare lo strumento Explorer API
Nella pagina di riferimento del metodo timeSeries.list.
Per informazioni su questo strumento, consulta Explorer API.
Ad esempio, per recuperare informazioni sul budget di uno SLO, completa la nello strumento Explorer API:
- name:
projects/PROJECT_ID - filter:
select_slo_budget("projects/PROJECT_ID/services/SERVICE_ID/serviceLevelObjectives/SLO_ID") - interval.startTime:
2021-10-07T13:00:20-04:00 - interval.endTime:
2021-10-08T13:00:20-04:00
Per un sistema, dopo che le variabili come PROJECT_ID vengono sostituite con e il metodo viene eseguito, vengono restituiti i seguenti dati delle serie temporali:
Selettori delle serie temporali
Questa sezione elenca i selettori delle serie temporali disponibili per gli SLO e descrive cosa rappresentano. Tutti i selettori possono essere utilizzati nei filtri con
Metodo timeSeries.list per recuperare i dati delle serie temporali. Non tutti sono supportati nei criteri di avviso.
select_slo_burn_rate
Sintassi: select_slo_burn_rate(SLO_NAME, LOOKBACK_PERIOD)
Il selettore delle serie temporali "burn-rate" restituisce il rapporto tra tasso di errori attuali (la percentuale di richieste errate nell'intervallo di ricerca) al tasso di errore sostenibile per lo SLO. Il tasso di errori sostenibile è il tasso con cui lo SLO viene soddisfatto esattamente.
I valori di questa serie temporale possono essere compresi tra 0 e infinito:
- Il valore 1 indica che il servizio mostra l'errore ideale non troppo rischioso, non troppo conservativo.
- Un valore maggiore di uno indica che il tasso di errore supera il tasso sostenibile. Più elevato è il valore, prima lo SLO non è conforme.
- Un valore inferiore a uno indica che il tasso di errore attuale è inferiore a la tariffa sostenibile.
Per monitorare la burn rate, ti consigliamo di utilizzare due criteri di avviso: un criterio di bruciatura rapida per avvisare dell'utente di picchi di burn-rate e di una combustione lenta per avvisarti di aumenti graduali.
Puoi creare e modificare i criteri di avviso in base a questo selettore delle serie temporali utilizzando l'API o la console Google Cloud.
Tutti i criteri di avviso basati su SLO creati utilizzando la console Google Cloud utilizzano questo selettore per recuperare i dati SLO.
select_slo_health
Sintassi: select_slo_health(SLO_NAME)
La serie temporale "SLO Health" risponde alla domanda "Durante un dato il periodo di allineamento, qual è stato il rapporto tra le richieste soddisfacenti e il totale di Google Cloud?" Lo SLI del servizio definisce ciò che viene considerato come una buona richiesta. Per ulteriori informazioni sugli SLI, consulta Panoramica.
Questa serie temporale misura il rendimento del servizio: se ogni richiesta al servizio è valida, i punti dati in questa serie temporale hanno il valore 1. Con l'aumento del numero di richieste non valide, i valori dei punti dati diminuiscono.
select_slo_compliance
Sintassi: select_slo_compliance(SLO_NAME)
La serie temporale "Conformità allo SLO" risponde alla domanda "Qual è il rapporto tra unità valide e unità totali dall'inizio del periodo di conformità?". Lo SLO definisce il periodo di conformità come una finestra mobile o un intervallo di tempo di calendario. L'unità può essere una richiesta o una finestra di tempo. Per ulteriori informazioni, vedi Conformità negli SLO basati su richieste e finestre.
Questa serie temporale fornisce un quadro generale del livello di efficacia del servizio rispetto allo SLO. Non genera un segnale di urgenza operativa.
Non utilizzare questo selettore di serie temporali nei criteri di avviso.
select_slo_budget
Sintassi: select_slo_budget(SLO_NAME)
La serie temporale "Budget SLO" risponde alla domanda "Quanto del budget di errore è rimasto al momento della misurazione?". Il budget di errore può essere misurato in richieste o minuti e l'importo rimanente viene calcolato in base al fatto che il periodo di conformità sia misurato in tempo di calendario o come finestra mobile. Per saperne di più, consulta la sezione Budget di errore.
Questa serie temporale misura il rischio relativo all'affidabilità di un servizio. Se budget di errore inferiore a zero, potrebbe non essere possibile lo SLO per il periodo corrente. Un mancato rispetto dello SLO potrebbe avere conseguenze reali per un dell'ambiente di produzione dell'organizzazione, a seconda di come che regola l'affidabilità.
Non utilizzare questo selettore di serie temporali nei criteri di avviso.
select_slo_budget_fraction
Sintassi: select_slo_budget_fraction(SLO_NAME)
La serie temporale "Frazione del budget SLO" risponde a questa domanda: "Quanto del budget di errore, come frazione dall'infinito negativo a una, rimane al momento?".
Non utilizzare questo selettore di serie temporali nei criteri di avviso.
select_slo_budget_total
Sintassi: select_slo_budget_total(SLO_NAME)
La serie temporale "Budget totale SLO" risponde a questa domanda: "Qual è il budget di errore totale (in richieste o minuti) che si prevede che sia disponibile al momento, in base al comportamento del servizio dall'inizio del periodo di conformità?" Lo SLO definisce la conformità periodo come una finestra temporale continua o un intervallo di tempo nel calendario.
Non utilizzare questo selettore delle serie temporali nei criteri di avviso.
select_slo_counts
Sintassi: select_slo_counts(SLO_NAME)
La serie temporale "Conteggi SLO" risponde alla domanda "Durante un determinato periodo di allineamento, qual è il numero di richieste valide e non valide?". Questo selettore fornisce una serie temporale che registra lo stato generale ed è adatta per l'importazione in sistemi di archiviazione a lungo termine.
Non utilizzare questo selettore di serie temporali nei criteri di avviso.