Uso de expressões matemáticas com as métricas do CloudWatch

Operadores aritméticos: + - * / ^

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

Subtração unária -

S

TS

TS[]

-5*m1

-m1

SUM(-[m1, m2])

ABS

TS

TS[]

TS

TS[]

Retorna o valor absoluto de cada ponto de dados.

ABS(m1-m2)

MIN(ABS([m1, m2]))

ABS(METRICS())

ANOMALY_DETECTION_BAND

TS

TS, S

TS[]

Retorna um segmento de detecção de anomalias para a métrica especificada. O segmento consiste em duas séries temporais, um que representa o limite superior do valor "normal" esperado da métrica e o outro que representa o limite inferior. A função pode levar dois argumentos. O primeiro é o ID da métrica para o qual o segmento vai ser criado. O segundo argumento é o número de desvios-padrão a ser usado para o segmento. Se você não especificar esse argumento, é usado o padrão de 2. Para ter mais informações, consulte Usar a detecção de anomalias do CloudWatch.

ANOMALY_DETECTION_BAND(m1)

ANOMALY_DETECTION_BAND(m1,4)

AVG

TS

TS[]

S

TS

A AVG de uma única série temporal retorna um escalar que representa a média de todos os pontos de dados na métrica. O AVG de uma matriz de séries temporais retorna uma única série temporal. Valores ausentes são tratados como 0.

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

AVG(METRICS())

CEIL

TS

TS[]

TS

TS[]

Retorna o teto de cada métrica. O teto é o menor valor inteiro maior ou igual a cada valor.

CEIL(m1)

CEIL(METRICS())

SUM(CEIL(METRICS()))

DATAPOINT_COUNT

TS

TS[]

S

TS

Retorna uma contagem dos pontos de dados que informaram valores. Isso é útil para calcular médias de métricas esparsas.

SUM(m1) / DATAPOINT_COUNT(m1)

DATAPOINT_COUNT(METRICS())

DB_PERF_INSIGHTS

String, string, string

String, String, String[]

TS (caso seja fornecida uma única string)

TS[] (caso seja fornecida uma matriz de strings)

Retorna métricas do Contador do Insights de Performance para bancos de dados como Amazon Relational Database Service e Amazon DocumentDB (compatível com MongoDB). Essa função retorna a mesma quantidade de dados que poderiam ser obtidos consultando diretamente as APIs do Insights de Performance. É possível usar essas métricas no CloudWatch para fazer representações gráficas e criar alarmes.

DB_PERF_INSIGHTS também traz a métrica DBLoad em intervalos inferiores a um minuto.

As métricas do Performance Insights recuperadas com essa função não são armazenadas no CloudWatch. Portanto, alguns recursos do CloudWatch, como observabilidade entre contas, detecção de anomalias, fluxos de métricas, explorador de métricas e Metric Insights, não funcionarão com as métricas do Insights de Performance que você recuperar com DB_PERF_INSIGHTS.

Uma única solicitação usando a função DB_PERF_INSIGHTS pode recuperar os seguintes números de pontos de dados.

A função DB_PERF_INSIGHTS oferece suporte somente para os períodos a seguir:

Para obter mais informações sobre as métricas de contador do Insights de Performance do Amazon RDS, consulte Métricas de contador do Insights de Performance.

Para obter mais informações sobre as métricas de contador do Insights de Performance do Amazon DocumentDB, consulte Métricas de contador do Insights de Performance.

DB_PERF_INSIGHTS(‘RDS’, ‘db-ABCDEFGHIJKLMNOPQRSTUVWXY1’, ‘os.cpuUtilization.user.avg’)

DB_PERF_INSIGHTS(‘DOCDB, ‘db-ABCDEFGHIJKLMNOPQRSTUVWXY1’, [‘os.cpuUtilization.idle.avg’, ‘os.cpuUtilization.user.max’])

DIFF

TS

TS[]

TS

TS[]

Retorna a diferença entre cada valor na série temporal e o valor anterior dessa série temporal.

DIFF(m1)

DIFF_TIME

TS

TS[]

TS

TS[]

Retorna a diferença, em segundos, entre o carimbo de data/hora de cada valor da série temporal e o carimbo de data/hora do valor anterior dessa série temporal.

DIFF_TIME(METRICS())

FILL

TS, [S | REPEAT | LINEAR]

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

TS

TS[]

Preenche os valores ausentes de uma série temporal. Há várias opções para os valores a serem usados para preencher os valores ausentes:

FILL(m1,10)

FILL(METRICS(), 0)

FILL(METRICS(), m1)

FILL(m1, MIN(m1))

FILL(m1, REPEAT)

FILL(METRICS(), LINEAR)

FIRST

LAST

TS[]

TS

Retorna a primeira ou a última série temporal de uma matriz de séries temporais. Isso é útil quando usado com a função SORT. Ele também pode ser usado para obter os limites superior e inferior da função ANOMALY_DETECTION_BAND.

IF(FIRST(SORT(METRICS(), AVG, DESC))>100, 1, 0) examina a métrica superior de uma matriz, que é classificada por AVG. Depois, ele retorna 1 ou 0 para cada ponto de dados, dependendo se esse valor de ponto de dados é superior a 100.

LAST(ANOMALY_DETECTION_BAND(m1)) retorna o limite superior da faixa de previsão de anomalia.

FLOOR

TS

TS[]

TS

TS[]

Retorna o piso de cada métrica. O piso é o maior valor inteiro menor ou igual a cada valor.

FLOOR(m1)

FLOOR(METRICS())

IF

Expressão IF

TS

Use IF junto com um operador de comparação para filtrar pontos de dados de uma série temporal ou criar uma série temporal mista composta por várias séries temporais agrupadas. Para ter mais informações, consulte Usar expressões IF.

Para ver exemplos, consulte Usar expressões IF.

INSIGHT_RULE_METRIC

INSIGHT_RULE_METRIC(ruleName, metricName)

TS

Use INSIGHT_RULE_METRIC para extrair estatísticas de uma regra no Contributor Insights. Para ter mais informações, consulte Métricas em representações gráficas geradas por regras no CloudWatch.

LAMBDA

LAMBDA(LambdaFunctionName [, optional-arg]*)

TS

TS[]

Chama uma função do Lambda para consultar métricas de uma fonte de dados que não seja o CloudWatch. Para ter mais informações, consulte Como passar argumentos para sua função do Lambda.

LOG

TS

TS[]

TS

TS[]

O LOG de uma série temporal retorna o valor logaritmo natural de cada valor na série temporal.

LOG(METRICS())

LOG10

TS

TS[]

TS

TS[]

O LOG10 de uma série temporal retorna o valor logaritmo de base 10 de cada valor na série temporal.

LOG10(m1)

MAX

TS

TS[]

S

TS

O MAX de uma única série temporal retorna um escalar que representa o valor máximo de todos os pontos de dados na métrica.

Se você inserir uma matriz de séries temporais, a função MAX criará e retornará uma série temporal que consiste no valor mais alto para cada ponto de dados em comparação com as séries temporais que foram usadas como entrada.

MAX(m1)/m1

MAX(METRICS())

METRIC_COUNT

TS[]

S

Retorna o número de métricas na matriz de séries temporais.

m1/METRIC_COUNT(METRICS())

METRICS

nulo

string

TS[]

A função METRICS() retorna todas as métricas do CloudWatch na solicitação. As expressões matemáticas não são incluídas.

Você pode usar METRICS() dentro de uma expressão maior que produz apenas uma série de tempo ou um array de séries de tempo.

Você pode usar a função METRICS() com uma sequência para retornar apenas as métricas incluídas em gráfico que contêm essa sequência no campo Id. Por exemplo, a expressão SUM(METRICS("errors")) retorna uma série temporal que é a soma dos valores de todas as métricas incluídas em gráfico que contêm 'erros' no campo Id. Você também pode usar SUM([METRICS(“4xx”), METRICS(“5xx”)]) para correspondência a várias sequências.

AVG(METRICS())

SUM(METRICS("errors"))

MIN

TS

TS[]

S

TS

O MIN de uma única série temporal retorna um escalar que representa o valor mínimo de todos os pontos de dados na métrica.

Se você inserir uma matriz de séries temporais, a função MIN criará e retornará uma série temporal que consiste no valor mais baixo para cada ponto de dados em comparação com as séries temporais que foram usadas como entrada.

Se você inserir uma matriz de séries temporais, a função MIN criará e retornará uma série temporal que consiste no valor mais baixo para cada ponto de dados em comparação com as séries temporais que foram usadas como entrada.

m1-MIN(m1)

MIN(METRICS())

MINUTE

HOUR

DAY

DATE

MONTH

YEAR

EPOCH

TS

TS

Essas funções obtêm o período e o intervalo da série temporal e retornam uma nova série temporal não esparsa onde cada valor é baseado em seu carimbo de data/hora.

MINUTE(m1)

IF(DAY(m1)<6,m1) retorna métricas somente de dias úteis, de segunda a sexta-feira.

IF(MONTH(m1) == 4,m1) retorna somente métricas publicadas em abril.

PERIOD

TS

S

Retorna o período da métrica em segundos. Entrada válida são métricas, não os resultados de outras expressões.

m1/PERIOD(m1)

RATE

TS

TS[]

TS

TS[]

Retorna a taxa de alteração da métrica por segundo. Isso é calculado como a diferença entre o último ponto de dados e o valor anterior, dividido pelo valor do ponto de dados a diferença de tempo em segundos entre os dois valores.

RATE(m1)

RATE(METRICS())

REMOVE_EMPTY

TS[]

TS[]

Remove todas as séries temporais que não tenham pontos de dados de uma matriz de séries temporais. O resultado é uma matriz de séries temporais em que cada série temporal contém pelo menos um ponto de dados.

REMOVE_EMPTY(METRICS())

RUNNING_SUM

TS

TS[]

TS

TS[]

Retorna uma série temporal com a soma dos valores na série temporal original.

RUNNING_SUM([m1,m2])

SEARCH

Expressão de pesquisa

Uma ou mais TS

Retorna uma ou mais séries temporais que correspondem aos critérios de pesquisa que você especificar. A função SEARCH permite que você adicione várias séries temporais relacionadas a um gráfico com uma expressão. O gráfico é atualizado dinamicamente para incluir novas métricas que serão adicionadas posteriormente e correspondem aos critérios de pesquisa. Para ter mais informações, consulte Usar expressões de pesquisa em gráficos.

Não é possível criar um alarme com base em uma expressão SEARCH. Isso ocorre porque as expressões de pesquisa retornam várias séries temporais, e um alarme baseado em uma expressão matemática pode observar apenas uma série temporal.

Se você fez login em uma conta de monitoramento na observabilidade entre contas do CloudWatch, a função SEARCH encontrará métricas nas contas de origem e na conta de monitoramento.

SERVICE_QUOTA

TS que é uma métrica de uso

TS

Retorna a cota de serviço da métrica de uso determinada. É possível usar isso para visualizar como seu uso atual se compara à cota e para definir alarmes que avisam quando você se aproxima da cota. Para ter mais informações, consulte Métricas de uso do AWS.

SLICE

(TS[], S, S) ou (TS[], S)

TS[]

TS

Recupera parte de uma matriz de séries temporais. Isso é especialmente útil quando combinado com SORT. Por exemplo, você pode excluir o resultado superior de uma matriz de séries temporais.

Você pode usar dois argumentos escalares para definir o conjunto de séries temporais a serem retornados. Os dois escalares definem o início (inclusive) e o fim (exclusivo) da matriz a serem retornados. A matriz é indexada por zero, portanto, a primeira série temporal na matriz é a série temporal 0. Como alternativa, você pode especificar apenas um valor, e o CloudWatch retornará todas as séries temporais começando com esse valor.

SLICE(SORT(METRICS(), SUM, DESC), 0, 10) retorna as 10 métricas da matriz na solicitação que têm o valor SUM mais alto.

SLICE(SORT(METRICS(), AVG, ASC), 5) classifica a matriz de métricas pela estatística AVG e retorna todas as séries temporais, exceto as 5 com o menor AVG.

SORT

(TS[], FUNCTION, SORT_ORDER)

(TS[], FUNCTION, SORT_ORDER, S)

TS[]

Classifica uma matriz de séries temporais de acordo com a função especificada. A função que você usa pode ser AVG, MIN, MAX ou SUM. A ordem de classificação pode ser ASC para ordem crescente (valores mais baixos primeiro) ou DESC para classificar os valores mais altos primeiro. Você também pode especificar um número após a ordem de classificação que atua como um limite. Por exemplo, especificar um limite de 5 retorna apenas as 5 principais séries temporais da classificação.

Quando essa função matemática for exibida em um gráfico, os rótulos para cada métrica no gráfico também serão classificados e numerados.

SORT(METRICS(), AVG, DESC, 10) calcula o valor médio de cada série temporal, classifica as séries temporais com os valores mais altos no início da classificação e retorna apenas as 10 séries temporais com as médias mais altas.

SORT(METRICS(), MAX, ASC) classifica a matriz de métricas pela estatística MAX e retorna todas elas em ordem crescente.

STDDEV

TS

TS[]

S

TS

O STDDEV de uma única série temporal retorna um escalar que representa o desvio padrão de todos os pontos de dados na métrica. O STDDEV de uma matriz de séries temporais retorna uma única série temporal.

m1/STDDEV(m1)

STDDEV(METRICS())

SUM

TS

TS[]

S

TS

A SUM de uma única série temporal retorna um escalar que representa a soma dos valores de todos os pontos de dados na métrica. O SUM de uma matriz de séries temporais retorna uma única série temporal.

SUM(METRICS())/SUM(m1)

SUM([m1,m2])

SUM(METRICS("errors"))/SUM(METRICS("requests"))*100

TIME_SERIES

S

TS

Retorna uma série temporal não esparsa na qual cada valor é definido como um argumento escalar.

TIME_SERIES(MAX(m1))

TIME_SERIES(5*AVG(m1))

TIME_SERIES(10)