Utilizzo di espressioni matematiche con metriche CloudWatch - Amazon CloudWatch

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo di espressioni matematiche con metriche CloudWatch

La matematica metrica consente di interrogare più CloudWatch metriche e utilizzare espressioni matematiche per creare nuove serie temporali basate su tali metriche. Puoi visualizzare le serie temporali risultanti sulla CloudWatch console e aggiungerle ai dashboard. Utilizzando le AWS Lambda metriche come esempio, puoi dividere la Errors metrica per la metrica per ottenere un Invocations tasso di errore. Quindi aggiungi le serie temporali risultanti a un grafico sulla dashboard. CloudWatch

È inoltre possibile eseguire calcoli metrici a livello di codice, utilizzando l'operazione. GetMetricData API Per ulteriori informazioni, vedere. GetMetricData

Aggiungere un'espressione matematica a un grafico CloudWatch

Puoi aggiungere un'espressione matematica a un grafico sulla dashboard CloudWatch . Ogni grafico è limitato all'utilizzo di un massimo di 500 parametri ed espressioni, perciò è possibile aggiungere un'espressione matematica solo se il grafico ha al massimo 499 parametri. Ciò vale anche se non tutti i parametri vengono visualizzati sul grafico.

Per aggiungere un'espressione matematica a un grafico
  1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Creare o modificare un grafico. Ci deve essere almeno una metrica nel grafico.

  3. Seleziona Graphed metrics (Parametri nel grafico).

  4. Scegli Math expression (Espressione matematica), Start with an empty expression (Inizia con un'espressione vuota). Viene visualizzata una nuova riga per l'espressione.

  5. Nella nuova riga, nella colonna Dettagli immetti l'espressione matematica. Le tabelle della sezione Sintassi e funzioni della formula di parametri elencano le funzioni che è possibile utilizzare nell'espressione.

    Per utilizzare una metrica o il risultato di un'altra espressione come parte della formula per questa espressione, utilizzate il valore mostrato nella colonna Id: ad esempio, m1+m2 o e1- (e1). MIN

    Puoi modificare il valore di Id. È possibile includere numeri, lettere un carattere di sottolineatura e devono iniziare con una lettera minuscola. Modificando il valore di Id con un nome più significativo, inoltre, è possibile ottenete un grafico più comprensibile: ad esempio, si può modificare m1 e m2 con errors e requests.

    Suggerimento

    Scegli la freccia verso il basso accanto a Math Expression (Espressione matematica) per visualizzare un elenco di funzioni supportate, che è possibile utilizzare durante la creazione dell'espressione.

  6. Nella colonna Label (Etichetta) dell'espressione, immetti un nome che descriva ciò che l'espressione sta calcolando.

    Se il risultato di un'espressione è una gamma di serie temporali, ognuna di queste serie temporali viene visualizzata nel grafico con una linea separata, con colori diversi. Immediatamente sotto il grafico c'è una legenda per ogni riga nel grafico. Per una singola espressione che produce più serie temporali, le didascalie delle legende per tali serie temporali hanno il formato Expression-Label Metric-Label. Ad esempio, se il grafico include una metrica con un'etichetta Errors e un'espressione FILL(METRICS(), 0) con un'etichetta Filled With 0:, una riga nella legenda sarà Filled With 0: Errors. Per fare in modo che la legenda mostri solo le etichette delle metriche originali, imposta Expression-Label essere vuoto.

    Quando un'espressione produce un array di serie temporali nel grafico, non è possibile modificare i colori utilizzati per ciascuna di tali serie temporali.

  7. Dopo aver aggiunto le espressioni desiderate, è possibile semplificare il grafico nascondendo alcuni dei parametri originali. Per nascondere un parametro o un'espressione, deseleziona la casella di controllo a sinistra del campo Id.

Sintassi e funzioni della matematica dei parametri

Le seguenti sezioni spiegano le funzioni disponibili per la matematica dei parametri. Tutte le funzioni devono essere scritte in lettere maiuscole (ad esempio AVG) e il campo Id per tutte le metriche e le espressioni matematiche deve iniziare con una lettera minuscola.

Il risultato finale di qualsiasi espressione matematica deve essere una singola serie temporale o un array di serie temporali. Alcune funzioni producono un numero scalare. È possibile utilizzare queste funzioni all'interno di una funzione più grande che produce alla fine una serie temporale. Ad esempio, il calcolo AVGdi una singola serie temporale produce un numero scalare, quindi non può essere il risultato finale dell'espressione. Ma è possibile utilizzarlo nella funzione m1- AVG (m1) per visualizzare una serie temporale della differenza tra ogni singolo punto dati e il valore medio nella serie temporale.

Abbreviazioni dei tipi di dati

Alcune funzioni sono valide solo per determinati tipi di dati. Le abbreviazioni dell'elenco seguente vengono utilizzate in tabelle di funzioni per rappresentare i tipi di dati supportati per ciascuna funzione:

  • S rappresenta un numero scalare, ad esempio 2, -5 o 50.25.

  • TS è una serie temporale (una serie di valori per una singola CloudWatch metrica nel tempo): ad esempio, la CPUUtilization metrica i-1234567890abcdef0 degli ultimi tre giorni.

  • TS [] è una gamma di serie temporali, ad esempio le serie temporali per più parametri.

  • String[] è un array di stringhe.

La funzione METRICS ()

La funzione METRICS() restituisce tutte le metriche della richiesta. Le espressioni matematiche non sono incluse.

È possibile utilizzare METRICS() all'interno di un'espressione più grande che produce una singola serie temporale o una matrice di serie temporali. Ad esempio, l'espressione SUM(METRICS()) restituisce una serie temporale (TS) che è la somma dei valori di tutte le metriche rappresentate graficamente. METRICS() /100 restituisce una matrice di serie temporali, ognuna delle quali è una serie temporale che mostra ogni punto dati di una delle metriche diviso per 100.

È possibile utilizzare la funzione METRICS() con una stringa per restituire solo le metriche grafiche che contengono quella stringa nel campo Id. Ad esempio, l'espressione SUM(METRICS(«errors»)) restituisce una serie temporale che è la somma dei valori di tutte le metriche rappresentate graficamente che hanno «errori» nel campo Id. Puoi anche usare SUM([METRICS(«4xx»), METRICS («5xx»)]) per abbinare più stringhe.

Funzioni aritmetiche di base

La tabella seguente elenca le funzioni aritmetiche di base supportate. I valori mancanti in una serie temporale vengono trattati come 0. Se il valore di un punto dati porta una funzione a tentare di dividere per zero, il punto dati viene eliminato.

Operazione Argomenti Esempi

Operatori aritmetici: + - * / ^

S, S

S, TS

TS, TS

S, TS[]

TS, TS[]

PERIOD(m1) /60

5 * m1

m1 - m2

SUM(100/ [m1, m2])

AVG(METRICS())

METRICS(*) *100

Unary subtraction -

S

TS

TS[]

-5*m1

-m1

SUM(- [m1, m2])

Confronto e operatori logici

È possibile utilizzare operatori di confronto e logici con una coppia di serie temporali o una coppia di singoli valori scalari. Quando si utilizza un operatore di confronto con una coppia di serie temporali, gli operatori restituiscono una serie temporale in cui ogni punto dati è 0 (false) o 1 (true). Se si utilizza un operatore di confronto su una coppia di valori scalari, viene restituito un singolo valore scalare, 0 o 1.

Quando gli operatori di confronto vengono utilizzati tra due serie temporali e solo una delle serie temporali ha un valore per un determinato timestamp, la funzione considera il valore mancante nell'altra serie temporale come 0.

È possibile utilizzare gli operatori logici in combinazione con gli operatori di confronto, per creare funzioni più complesse.

Nella tabella seguente sono elencati gli operatori supportati.

Tipo di operatore Operatori supportati

Operatori di confronto

==

!=

<=

>=

<

>

Operatori logici

ANDo &&

OR o ||

Per vedere come vengono utilizzati questi operatori, supponiamo di avere due serie temporali: metric1 ha valori di [30, 20, 0, 0] e metric2 ha valori di [20, -, 20, -] dove - indica che non c'è alcun valore per quella data e ora.

Expression Output

(metric1 < metric2)

0, 0, 1, 0

(metric1 >;= 30)

1, 0, 0, 0

(metrico1 > 15 AND metrico2 > 15)

1, 0, 0, 0

Funzioni supportate per la matematica dei parametri

La tabella riportata di seguito descrive le funzioni che è possibile utilizzare in espressioni matematiche. Immetti tutte le funzioni in lettere maiuscole.

Il risultato finale di qualsiasi espressione matematica deve essere una singola serie temporale o un array di serie temporali. Alcune funzioni nelle tabelle nelle seguenti sezioni producono un numero scalare. È possibile utilizzare queste funzioni all'interno di una funzione più grande che produce alla fine una serie temporale. Ad esempio, il calcolo AVGdi una singola serie temporale produce un numero scalare, quindi non può essere il risultato dell'espressione finale. Ma è possibile utilizzarlo nella funzione m1- AVG (m1) per visualizzare una serie temporale della differenza tra ogni singolo punto dati e il valore medio di quel punto dati.

Nella tabella riportata di seguito, ogni esempio nella colonna Examples (Esempi) è un'espressione che consente di ottenere una singola serie temporale o un array di serie temporali. Questo esempio mostra come le funzioni che restituiscono numeri scalari possono essere utilizzate come parte di un'espressione valida che produce una singola serie temporale.

Funzione Argomenti Tipo restituito * Descrizione Esempi Supportato per multi-account?

ABS

TS

TS[]

TS

TS[]

Restituisce il valore assoluto di ogni punto dati.

ABS(m1-m2)

MIN(ABS([m1, m2]))

ABS(METRICS())

ANOMALY_DETECTION_BAND

TS

TS, S

TS[]

Restituisce un intervallo di rilevamento delle anomalie per il parametro specificato. L'intervallo è composto da due serie temporali, una che rappresenta il limite superiore del valore previsto "normale" del parametro e l'altra che rappresenta il limite inferiore. La funzione può richiedere due argomenti. Il primo è l'ID del parametro per il quale creare l'intervallo. Il secondo argomento è il numero di deviazioni standard da usare per l'intervallo. Se non si specifica questo argomento, viene utilizzato il valore predefinito 2. Per ulteriori informazioni, consulta Utilizzo del CloudWatch rilevamento delle anomalie.

ANOMALY_ DETECTION _ BAND (m1)

ANOMALY_ DETECTION _ BAND (m 1,4)

AVG

TS

TS[]

S

TS

Il valore AVGdi una singola serie temporale restituisce uno scalare che rappresenta la media di tutti i punti dati della metrica. Il valore AVGdi una matrice di serie temporali restituisce una singola serie temporale. I valori mancanti vengono trattati come 0.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi se si desidera che la funzione restituisca uno scalare. Ad esempio AVG(m2). Ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

Per utilizzare questa funzione con gli allarmi, in particolare gli allarmi con operazioni di dimensionamento automatico, si consiglia di impostare l'allarme in modo che utilizzi M punti dati su N, dove M < N.

SUM([m1, m2])/AVG(m2)

AVG(METRICS())

CEIL

TS

TS[]

TS

TS[]

Restituisce il valore limite ogni parametro. Il valore limite è il numero intero più piccolo maggiore o uguale a ciascun valore.

CEIL(m1)

CEIL(METRICS())

SUM(CEIL(METRICS()))

DATAPOINT_COUNT

TS

TS[]

S

TS

Restituisce un conteggio dei punti dati che hanno segnalato valori. È utile per calcolare le medie di parametri sparse.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi. Ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

SUM(m1)/DATAPOINT_ COUNT (m1)

DATAPOINT_COUNT(METRICS())

DB_ _ PERF INSIGHTS

Stringa, stringa, stringa

String, String, String[]

TS (se viene fornita una singola stringa)

TS[] (se viene fornito un array di stringhe)

Restituisce i parametri del contatore di Approfondimenti sulle prestazioni per database come Amazon Relational Database Service e Amazon DocumentDB (compatibile con MongoDB). Questa funzione restituisce la stessa quantità di dati che è possibile ottenere interrogando direttamente Performance InsightsAPIs. Puoi utilizzare queste metriche CloudWatch per rappresentare graficamente e creare allarmi.

Importante

Quando usi questa funzione, devi specificare l'ID univoco della risorsa del database. È diverso dall'identificatore del database. Per trovare l'ID della risorsa del database nella RDS console Amazon, scegli l'istanza DB per visualizzarne i dettagli. Quindi seleziona la scheda Configurazione. ID risorsa è visualizzato nella sezione Configurazione.

DB_ PERF _ introduce la DBLoad metrica INSIGHTS anche a intervalli inferiori al minuto.

Le metriche di Performance Insights recuperate con questa funzione non vengono archiviate in. CloudWatch Pertanto, alcune CloudWatch funzionalità come l'osservabilità tra account, il rilevamento delle anomalie, i flussi di metriche, il metrics explorer e Metric Insights non funzionano con le metriche di Performance Insights recuperate con DB_ _. PERF INSIGHTS

Una singola richiesta che utilizza la funzione DB_ _ può recuperare il seguente numero PERF di punti dati. INSIGHTS

  • 1080 punti dati per periodi ad alta risoluzione (1 s, 10 s, 30 s)

  • 1440 punti dati per periodi di risoluzione standard (1 m, 5 m, 1 ora, 1d)

La funzione DB_ PERF _ INSIGHTS supporta solo le seguenti lunghezze di periodo:

  • 1 secondo

  • 10 secondi

  • 30 secondi

  • 1 minuto

  • 5 minuti

  • 1 ora

  • 1 giorno

Per ulteriori informazioni sui contatori di Amazon RDS Performance Insights, consulta i parametri dei contatori di Amazon Performance Insights.

Per ulteriori informazioni su Approfondimenti sulle prestazioni di Amazon DocumentDB, consulta Approfondimenti sulle prestazioni per i parametri del contatore.

Nota

Le metriche ad alta risoluzione con granularità inferiore al minuto recuperate da DB_ PERF _ INSIGHTS sono applicabili solo alla metrica o alle DBLoadmetriche del sistema operativo se hai abilitato Enhanced Monitoring a una risoluzione più elevata. Per ulteriori informazioni sul monitoraggio RDS avanzato di Amazon, consulta Monitoraggio dei parametri del sistema operativo con Enhanced Monitoring.

Puoi creare un allarme ad alta risoluzione utilizzando la INSIGHTS funzione DB_ PERF _ per un intervallo di tempo massimo di tre ore. È possibile utilizzare la CloudWatch console per rappresentare graficamente le metriche recuperate con la INSIGHTS funzione DB_ PERF _ per qualsiasi intervallo di tempo.

DB_ PERF _ INSIGHTS ('', 'db RDS - ', 'os. ABCDEFGHIJKLMNOPQRSTUVWXY1 cpuUtilization.utente.avg')

DB_ PERF _ INSIGHTS ('DOCDB, 'db-', ['os. ABCDEFGHIJKLMNOPQRSTUVWXY1 cpuUtilization.idle.avg', 'os. cpuUtilization.utente.max '])

DIFF

TS

TS[]

TS

TS[]

Restituisce la differenza tra ogni valore della serie temporale e il valore precedente di quella serie temporale.

DIFF(m1)

DIFF_TIME

TS

TS[]

TS

TS[]

Restituisce la differenza in secondi tra il timestamp di ogni valore della serie temporale e il timestamp del valore precedente di quella serie temporale.

DIFF_TIME(METRICS())

FILL

TS, [S | REPEAT |LINEAR]

TS [], [TS | S | REPEAT |LINEAR]

TS

TS[]

Riempie i valori mancanti di una serie temporale. Ci sono diverse opzioni per i valori da utilizzare come filler per i valori mancanti:

  • È possibile specificare un valore da utilizzare come valore filler.

  • È possibile specificare un parametro da utilizzare come valore filler.

  • Puoi utilizzare la REPEATparola chiave per riempire i valori mancanti con il valore effettivo più recente della metrica prima del valore mancante.

  • Puoi usare la LINEARparola chiave per riempire i valori mancanti con valori che creano un'interpolazione lineare tra i valori all'inizio e alla fine dello spazio.

Nota

Quando usi questa funzione in un avviso, puoi riscontrare un problema se i tuoi parametri vengono pubblicati con un leggero ritardo e il minuto più recente non ha mai dati. In questo caso, FILLsostituisce il punto dati mancante con il valore richiesto. Ciò fa sì che il punto dati più recente per la metrica sia sempre il FILL valore, il che può far sì che l'allarme rimanga bloccato nello stato OK o ALARM nello stato OK. Puoi aggirare questo problema usando un allarme M di N. Per ulteriori informazioni, consulta Valutazione di un allarme.

FILL(m 1,10)

FILLMETRICS(), 0)

FILL(METRICS(), m1)

FILL(m1, MIN (m1))

FILL(m1,) REPEAT

FILL(METRICS(), LINEAR)

FIRST

LAST

TS[]

TS

Restituisce la prima o l'ultima serie temporale da un array di serie temporali. Ciò è utile se utilizzato con la SORTfunzione. Può anche essere usato per ottenere le soglie massima e bassa dalla funzione ANOMALY_ DETECTION _ BAND.

IF (FIRST(SORT(METRICS()AVG,DESC)) >100, 1, 0) Esamina la metrica più alta di un array, ordinata per. AVG Restituisce quindi un 1 o uno 0 per ogni punto di dati, a seconda se il valore del punto di dati è superiore a 100.

LAST(ANOMALY_ DETECTION _ BAND (m1)) restituisce il limite superiore della banda di previsione dell'anomalia.

FLOOR

TS

TS[]

TS

TS[]

Restituisce il valore minimo di ciascun parametro. Il valore minimo è il numero intero più grande minore o uguale a ciascun valore.

FLOOR(m1)

FLOOR(METRICS())

IF

Espressione IF

TS

Utilizzare IF insieme a un operatore di confronto per filtrare i punti dati da una serie temporale o creare una serie temporale mista composta da più serie temporali raccolte. Per ulteriori informazioni, consulta Utilizzo delle espressioni IF.

Per alcuni esempi, consulta Utilizzo delle espressioni IF.

INSIGHT_RULE_METRIC

INSIGHT_RULE_METRIC(ruleName, metricName)

TS

Usa INSIGHT_ RULE _ METRIC per estrarre statistiche da una regola in Contributor Insights. Per ulteriori informazioni, consulta Rappresentazione grafica delle metriche generate dalle regole in CloudWatch.

LAMBDA

LAMBDA(LambdaFunctionName [, optional-arg] *)

TS

TS[]

Richiama una funzione Lambda per interrogare le metriche da un'origine dati che non lo è. CloudWatch Per ulteriori informazioni, consulta Come passare argomenti alla funzione Lambda.

LOG

TS

TS[]

TS

TS[]

Il valore LOGdi una serie temporale restituisce il valore logaritmico naturale di ogni valore della serie temporale.

LOG(METRICS())

LOG10

TS

TS[]

TS

TS[]

Lo LOG10 di una serie temporale restituisce il valore logaritmico in base 10 di ogni valore della serie temporale.

LOG10 (m1)

MAX

TS

TS[]

S

TS

Il valore MAXdi una singola serie temporale restituisce uno scalare che rappresenta il valore massimo di tutti i punti dati della metrica.

Se si immette una matrice di serie temporali, la MAXfunzione crea e restituisce una serie temporale costituita dal valore più alto per ogni punto dati, tra le serie temporali utilizzate come input.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi se si desidera che la funzione restituisca uno scalare. Ad esempio, MAX(m2) ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

MAX(m1) /m1

MAX(METRICS())

METRIC_COUNT

TS[]

S

Restituisce il numero di parametri nell'array di serie temporali.

m1/ _ () METRIC COUNT METRICS

METRICS

null

string

TS[]

La funzione METRICS() restituisce tutte le CloudWatch metriche nella richiesta. Le espressioni matematiche non sono incluse.

È possibile utilizzare METRICS() all'interno di un'espressione più grande che produce una singola serie temporale o una matrice di serie temporali.

È possibile utilizzare la funzione METRICS() con una stringa per restituire solo le metriche grafiche che contengono quella stringa nel campo Id. Ad esempio, l'espressione SUM(METRICS(«errors»)) restituisce una serie temporale che è la somma dei valori di tutte le metriche rappresentate graficamente che hanno «errori» nel campo Id. Puoi anche usare SUM([METRICS(«4xx»), METRICS («5xx»)]) per abbinare più stringhe.

AVG(METRICS())

SUMMETRICS(«errori»))

MIN

TS

TS[]

S

TS

Il valore MINdi una singola serie temporale restituisce uno scalare che rappresenta il valore minimo di tutti i punti dati della metrica.

Se si immette una matrice di serie temporali, la MINfunzione crea e restituisce una serie temporale costituita dal valore più basso per ogni punto dati, tra le serie temporali utilizzate come input.

Se si immette una matrice di serie temporali, la MINfunzione crea e restituisce una serie temporale costituita dal valore più basso per ogni punto dati, tra le serie temporali utilizzate come input.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi se si desidera che la funzione restituisca uno scalare. Ad esempio, MIN(m2) ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

m1- (m1) MIN

MIN(METRICS())

MINUTE

HOUR

DAY

DATE

MONTH

YEAR

EPOCH

TS

TS

Queste funzioni prendono il periodo e l'intervallo della serie temporale e restituiscono una nuova serie temporale non sparse in cui ogni valore è basato sul relativo timestamp.

  • MINUTErestituisce una serie temporale non sparsa di numeri interi compresi tra 0 e 59 che rappresentano il UTC minuto di ogni timestamp nella serie temporale originale.

  • HOURrestituisce una serie temporale non sparsa di numeri interi compresi tra 0 e 23 che rappresentano l'UTCora di ogni timestamp della serie temporale originale.

  • DAYrestituisce una serie temporale non sparsa di numeri interi compresi tra 1 e 7 che rappresentano il UTC giorno della settimana di ogni timestamp della serie temporale originale. 1 rappresenta il lunedì e 7 rappresenta la domenica.

  • DATErestituisce una serie temporale non sparsa di numeri interi compresi tra 1 e 31 che rappresentano il UTC giorno del mese di ogni timestamp della serie temporale originale.

  • MONTHrestituisce una serie temporale non sparsa di numeri interi compresi tra 1 e 12 che rappresentano il UTC mese di ogni timestamp della serie temporale originale. 1 rappresenta gennaio e 12 rappresenta dicembre.

  • YEARrestituisce una serie temporale non sparsa di numeri interi che rappresentano l'UTCanno di ogni timestamp della serie temporale originale.

  • EPOCHrestituisce una serie temporale non sparsa di numeri interi che rappresentano il UTC tempo in secondi dall'epoca di ogni timestamp della serie temporale originale. L'epoca è il 1° gennaio 1970.

MINUTE(m1)

IF (DAY(m1) <6, m1) restituisce le metriche solo nei giorni feriali, dal lunedì al venerdì.

IF (MONTH(m1) == 4, m1) restituisce solo le metriche pubblicate ad aprile.

PERIOD

TS

S

Restituisce il periodo di un parametro in secondi. L'input valido è un parametro, non i risultati di altre espressioni.

m1/ (m1) PERIOD

RATE

TS

TS[]

TS

TS[]

Restituisce la percentuale di variazione del parametro al secondo. Questo viene calcolato come la differenza tra il valore dell'ultimo punto dati e il valore precedente, diviso per la differenza temporale in secondi tra i due valori.

Importante

L'impostazione di allarmi su espressioni che utilizzano la RATE funzione su metriche con dati sparsi può comportarsi in modo imprevedibile, poiché l'intervallo di punti dati recuperato durante la valutazione dell'allarme può variare in base all'ultima pubblicazione dei punti dati.

RATE(m1)

RATE(METRICS())

REMOVE_EMPTY

TS[]

TS[]

Rimuove tutte le serie temporali che non dispongono di punti di dati da una gamma di serie temporali. Il risultato è un gamma di serie temporali in cui ogni serie temporale contiene almeno un punto di dati.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi. Ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

REMOVE_EMPTY(METRICS())

RUNNING_SUM

TS

TS[]

TS

TS[]

Restituisce una serie temporale con la somma parziale dei valori della serie temporale originale.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi. Ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

RUNNING_ SUM ([m1, m2])

SEARCH

Espressione di ricerca

Uno o più TS

Restituisce una o più serie temporali che corrispondono a un criterio di ricerca specificato. La SEARCHfunzione consente di aggiungere più serie temporali correlate a un grafico con una sola espressione. Il grafico viene aggiornato in modo dinamico per includere nuovi parametri, che vengono aggiunti successivamente e soddisfano i criteri di ricerca. Per ulteriori informazioni, consulta Utilizzo delle espressioni di ricerca nei grafici.

Non è possibile creare un allarme basato su un'SEARCHespressione. Questo perché le espressioni di ricerca restituiscono più serie temporali e un allarme basato su un'espressione matematica può osservare solo una serie temporale.

Se hai effettuato l'accesso a un account di monitoraggio in modalità osservabilità CloudWatch tra account, la SEARCHfunzione trova le metriche negli account di origine e nell'account di monitoraggio.

SERVICE_QUOTA

TS che è un parametro di utilizzo

TS

Restituisce la quota di servizio per il parametro di utilizzo specificato. Puoi utilizzare questa opzione per visualizzare il modo in cui l'utilizzo corrente si rapporta alla quota e per impostare gli allarmi che ti avvisano quando ti avvicini alla quota. Per ulteriori informazioni, consulta AWS Parametri di utilizzo.

SLICE

(TS[], S, S) or (TS[], S)

TS[]

TS

Recupera parte di un array di serie temporali. Ciò è particolarmente utile se combinato con. SORT Ad esempio, è possibile escludere il risultato principale da un array di serie temporali.

È possibile utilizzare due argomenti scalari per definire il set di serie temporali che si desidera ottenere. I due scalari definiscono l'inizio (inclusivo) e la fine (esclusivo) dell'array da ottenere. L'array è a indice zero, quindi la prima serie temporale nell'array è la serie temporale 0. In alternativa, è possibile specificare un solo valore e CloudWatch restituire tutte le serie temporali che iniziano con quel valore.

SLICE(SORT(METRICS(),SUM,DESC), 0, 10) restituisce le 10 metriche dall'array di metriche nella richiesta che hanno il valore più altoSUM.

SLICE(SORT(METRICS(),,ASC)AVG, 5) ordina l'array di metriche in base alla AVG statistica, quindi restituisce tutte le serie temporali tranne le 5 con la più bassa. AVG

SORT

(TS [], FUNCTION _) SORT ORDER

(TS []FUNCTION, SORT _ORDER, S)

TS[]

Ordina un array di serie temporali in base alla funzione specificata. La funzione che usi può essere AVGMIN, MAX, o SUM. L'ordinamento può essere ASCcrescente (prima i valori più bassi) o DESCordinare prima i valori più alti. È possibile specificare facoltativamente un numero dopo l'ordinamento che funga da limite. Ad esempio, specificando un limite di 5 vengono restituite solo le prime 5 serie temporali dall'ordinamento.

Quando questa funzione matematica viene visualizzata su un grafico, anche le etichette di ogni parametro nel grafico vengono ordinate e numerate.

SORT(METRICS(), AVGDESC, 10) calcola il valore medio di ogni serie temporale, ordina le serie temporali con i valori più alti all'inizio dell'ordinamento e restituisce solo le 10 serie temporali con le medie più alte.

SORT(METRICS(),MAX,ASC) ordina l'array di metriche in base alla MAX statistica, quindi le restituisce tutte in ordine crescente.

STDDEV

TS

TS[]

S

TS

Il valore STDDEVdi una singola serie temporale restituisce uno scalare che rappresenta la deviazione standard di tutti i punti dati della metrica. Il valore STDDEVdi una matrice di serie temporali restituisce una singola serie temporale.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi se si desidera che la funzione restituisca uno scalare. Ad esempio, STDDEV(m2) ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

m1/ (m1) STDDEV

STDDEV(METRICS())

SUM

TS

TS[]

S

TS

Il valore SUMdi una singola serie temporale restituisce uno scalare che rappresenta la somma dei valori di tutti i punti dati della metrica. Il valore SUMdi una matrice di serie temporali restituisce una singola serie temporale.

Nota

Si consiglia di non utilizzare questa funzione negli CloudWatch allarmi se si desidera che la funzione restituisca uno scalare. Ad esempio SUM(m1). Ogni volta che un allarme valuta se cambiare stato, CloudWatch tenta di recuperare un numero maggiore di punti dati rispetto al numero specificato come Periodi di valutazione. Questa funzione agisce in modo diverso quando vengono richiesti dati aggiuntivi.

SUM(METRICS())/(m1SUM)

SUM([m1, m2])

SUM(METRICS(«errori»))/SUM(METRICS(«richieste»)) *100

TIME_SERIES

S

TS

Restituisce una serie temporale non sparse in cui ogni valore è impostato su un argomento scalare.

TIME_ SERIES MAX (m1))

TIME_ SERIES (5* AVG (m1))

TIME_ SERIES (10)

*L'utilizzo solo di una funzione che restituisce solo un numero scalare non è valido, così come tutti i risultati finali di espressioni devono essere una singola serie temporale o un array di serie temporali. Al contrario, utilizzare queste funzioni come parte di un'espressione più grande che restituisce una serie temporale.

Utilizzo delle espressioni IF

Utilizzare IF insieme a un operatore di confronto per filtrare i punti dati da una serie temporale o creare una serie temporale mista composta da più serie temporali raccolte.

IF utilizza gli argomenti seguenti:

IF(condition, trueValue, falseValue)

La condizione determina FALSE se il valore del punto dati della condizione è 0 e TRUE se il valore della condizione è qualsiasi altro valore, sia esso positivo o negativo. Se la condizione è una serie temporale, viene valutata separatamente per ogni timestamp.

Di seguito sono elencate le sintassi valide. Per ciascuna di queste sintassi, l'output è una singola serie temporale.

  • SE (TS Comparison Operator S, S | TS, S | TS)

    Nota

    Se TS comparison operator S è TRUE ma metric2 non ha un punto dati corrispondente, l'output sarà 0.

  • IF(TS, TS, TS)

  • IF(TS, S, TS)

  • IF(TS, TS, S)

  • IF(TS, S, S)

  • IF(S, TS, TS)

Le sezioni seguenti forniscono ulteriori dettagli ed esempi per queste sintassi.

SE (TS) Comparison Operator S, scalare2 | metrico2, scalare3 | metrico3)

Il corrispondente valore della serie temporale di output:

  • ha il valore di scalar2 o metric2, se TS Comparison Operator S è TRUE

  • ha il valore di scalar3 o metric3, se TS Comparison Operator S è FALSE

  • ha il valore 0 se il TS Comparison Operatorè TRUE e il punto dati corrispondente in metric2 non esiste.

  • ha il valore 0 se il TS Comparison Operatorè FALSE e il punto dati corrispondente in metric3 non esiste.

  • è una serie temporale vuota, se il punto di dati corrispondente di non esiste in metric3, o se scalar3/metric3 viene omesso dall'espressione

IF(metric1, metric2, metric3)

Per ogni punto di dati di metric1, il corrispondente valore della serie temporale di output:

  • ha il valore di metric2, se il punto dati corrispondente di metric1 è. TRUE

  • ha il valore di metric3, se il punto dati corrispondente di metric1 è. FALSE

  • ha il valore 0, se il punto dati corrispondente di metric1 è TRUE e il punto dati corrispondente non esiste in metric2.

  • viene eliminato, se il punto dati corrispondente di metric1 è FALSE e il punto dati corrispondente non esiste in metric3

  • viene eliminato, se il punto dati corrispondente di metric1 è FALSE e metric3 viene omesso dall'espressione.

  • viene eliminato, se manca il punto dati corrispondente di metric1.

Nella tabella seguente viene illustrato un esempio per questa sintassi.

Parametro o funzione Valori

(metric1)

[1, 1, 0, 0, -]

(metric2)

[30, -, 0, 0, 30]

(metric3)

[0, 0, 20, -, 20]

IF(metric1, metric2, metric3)

[30, 0, 20, 0, -]

IF(metric1, scalar2, metric3)

Per ogni punto di dati di metric1, il corrispondente valore della serie temporale di output:

  • ha il valore di scalar2, se il punto dati corrispondente di metric1 è. TRUE

  • ha il valore di metric3, se il punto dati corrispondente di metric1 è. FALSE

  • viene eliminato, se il punto dati corrispondente di metric1 è FALSE e il punto dati corrispondente non esiste su metric3, o se metric3 viene omesso dall'espressione.

Parametro o funzione Valori

(metric1)

[1, 1, 0, 0, -]

scalar2

5

(metric3)

[0, 0, 20, -, 20]

IF(metric1, scalar2, metric3)

[5, 5, 20, -, -]

IF(metric1, metric2, scalar3)

Per ogni punto di dati di metric1, il corrispondente valore della serie temporale di output:

  • ha il valore di metric2, se il punto dati corrispondente di metric1 è. TRUE

  • ha il valore di scalar3, se il punto dati corrispondente di metric1 è. FALSE

  • ha il valore 0, se il punto dati corrispondente di metric1 è TRUE e il punto dati corrispondente non esiste in metric2.

  • viene eliminato se il punto dati corrispondente in metric1 non esiste.

Parametro o funzione Valori

(metric1)

[1, 1, 0, 0, -]

(metric2)

[30, -, 0, 0, 30]

scalar3

5

IF(metric1, metric2, scalar3)

[30, 0, 5, 5, -]

IF(scalar1, metric2, metric3)

Il corrispondente valore della serie temporale di output:

  • ha il valore di metric2, se scalar1 è. TRUE

  • ha il valore di metric3, se scalar1 è. FALSE

  • è una serie temporale vuota, se metric3 viene omesso dall'espressione.

Esempi di casi d'uso per le espressioni IF

Gli esempi seguenti illustrano i possibili usi della funzione IF .

  • Per visualizzare solo i valori inferiori di un parametro:

    IF(metric1<400, metric1)

  • Per modificare ogni punto di dati in un parametro in uno dei due valori, per mostrare valori massimi e minimi relativi del parametro originale:

    IF(metric1<400, 10, 2)

  • Per visualizzare un 1 per ogni timestamp in cui la latenza supera la soglia e visualizzare uno 0 per tutti gli altri punti di dati:

    IF(latency>threshold, 1, 0)

Usa la matematica metrica con l'operazione GetMetricData API

È possibile utilizzarla GetMetricData per eseguire calcoli utilizzando espressioni matematiche e anche per recuperare grandi quantità di dati metrici in un'unica chiamata. API Per ulteriori informazioni, vedere. GetMetricData

Rilevamento di anomalie sulla matematica del parametro

Il rilevamento di anomalie sulla matematica del parametro è una funzione che è possibile utilizzare per creare allarmi di rilevamento anomalie su singole metriche e output di espressioni matematiche del parametro. È possibile utilizzare queste espressioni per creare grafici che visualizzano le bande di rilevamento delle anomalie. La funzione supporta funzioni aritmetiche di base, operatori logici e confronto e la maggior parte delle altre funzioni.

Il rilevamento di anomalie sulla matematica del parametro non supporta le seguenti funzioni:

  • Espressioni che contengono più di un ANOMALYDETECTION_ _ BAND nella stessa riga.

  • Espressioni che contengono più di 10 metriche o espressioni matematiche.

  • Espressioni che contengono l'METRICSespressione.

  • Espressioni che contengono la SEARCHfunzione.

  • Espressioni che utilizzano la funzione DP_ PERF _ INSIGHTS.

  • Espressioni che utilizzano metriche con periodi diversi.

  • Rilevatori di anomalie matematiche metriche che utilizzano metriche ad alta risoluzione come input.

Per ulteriori informazioni su questa funzionalità, consulta Using CloudWatch anomaly detection nella Amazon CloudWatch User Guide.