将数学表达式与 CloudWatch 指标结合使用

算术运算符: + - * / ^

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

一元减法 -

S

TS

TS[]

-5*m1

-m1

SUM(-[m1, m2])

ABS

TS

TS[]

TS

TS[]

返回每个数据点的绝对值。

ABS(m1-m2)

MIN(ABS([m1, m2]))

ABS(METRICS())

ANOMALY_DETECTION_BAND

TS

TS、S

TS[]

返回指定指标的异常检测范围。该范围由两个时间序列组成，一个表示指标的“正常”预期值的上限，另一个表示下限。该函数可接受两个参数。第一个参数是要为其创建范围的指标的 ID。第二个参数是要用于范围的标准差的数目。如果您不指定此参数，则使用默认值 2。有关更多信息，请参阅 使用 CloudWatch 异常检测。

ANOMALY_DETECTION_BAND(m1)

ANOMALY_DETECTION_BAND(m1,4)

AVG

TS

TS[]

S

TS

单个时间序列的 AVG 将返回一个标量，表示指标中所有数据点的平均值。一组时间序列的 AVG 将返回单个时间序列。缺少的值被视为 0。

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

AVG(METRICS())

CEIL

TS

TS[]

TS

TS[]

返回每个指标的上限。上限是大于或等于每个值的最小整数。

CEIL(m1)

CEIL(METRICS())

SUM(CEIL(METRICS()))

DATAPOINT_COUNT

TS

TS[]

S

TS

返回报告了值的数据点的计数。这对于计算稀疏指标的平均值非常有用。

SUM(m1)/DATAPOINT_COUNT(m1)

DATAPOINT_COUNT(METRICS())

DB_PERF_INSIGHTS

字符串, 字符串, 字符串

String, String, String[]

TS（如果给定单个字符串）

TS[]（如果给定字符串数组）

返回 Amazon Relational Database Service 和 Amazon DocumentDB（与 MongoDB 兼容）等数据库的性能详情计数器指标。此函数返回的数据量与您直接查询性能详情 API 所获得的数据量相同。您可以在 CloudWatch 中使用这些指标来绘制图表和创建警报。

DB_PERF_INSIGHTS 还以亚分钟为间隔引入 DBLoad 指标。

使用此函数检索的性能详情指标不会存储在 CloudWatch 中。因此，某些 CloudWatch 功能（例如跨账户可观测性、异常检测、指标流、Metrics Explorer 和 Metric Insights）不适用于您通过 DB_PERF_INSIGHTS 检索的性能详情指标。

使用 DB_PERF_INSIGHTS 函数的单个请求可以检索以下数量的数据点。

DB_PERF_INSIGHTS 函数仅支持以下周期长度：

有关 Amazon RDS 性能详情计数器指标的更多信息，请参阅性能详情计数器指标。

有关 Amazon DocumentDB 性能详情计数器指标的更多信息，请参阅性能详情计数器指标。

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[]

返回时间序列中各值与该时间序列中的先前值之间的差值。

DIFF(m1)

DIFF_TIME

TS

TS[]

TS

TS[]

返回时间序列中各值的时间戳与该时间序列中的先前值的时间戳之间的差值（以秒为单位）。

DIFF_TIME(METRICS())

FILL

TS, [S | REPEAT | LINEAR]

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

TS

TS[]

填充时间序列的缺失值。有几个选择可用作缺失值的填充内容：

FILL(m1,10)

FILL(METRICS(), 0)

FILL(METRICS(), m1)

FILL(m1, MIN(m1))

FILL(m1, REPEAT)

FILL(METRICS(), LINEAR)

FIRST

LAST

TS[]

TS

返回时间序列数组中的第一个或最后一个时间序列。这在与 SORT 函数结合使用时非常有用。它还可用于从 ANOMALY_DETECTION_BAND 函数中获取高阈值和低阈值。

IF(FIRST(SORT(METRICS(), AVG, DESC))>100, 1, 0) 查看数组中的最高指标，该指标通过 AVG 进行排序。然后，它为每个数据点返回 1 或 0，具体取决于相应数据点的值是否大于 100。

LAST(ANOMALY_DETECTION_BAND(m1)) 将返回异常预测带的上限。

FLOOR

TS

TS[]

TS

TS[]

返回每个指标的下限。下限是小于或等于每个值的最大整数。

FLOOR(m1)

FLOOR(METRICS())

IF

IF 表达式

TS

通过将 IF 与比较运算符结合使用，可以从时间序列中筛选出数据点或创建由多个已整理的时间序列组成的混合时间序列。有关更多信息，请参阅 使用 IF 表达式。

有关示例，请参阅使用 IF 表达式。

INSIGHT_RULE_METRIC

INSIGHT_RULE_METRIC(ruleName, metricName)

TS

使用 INSIGHT_RULE_METRIC 可在 Contributor Insights 中从规则提取统计数据。有关更多信息，请参阅 绘制 CloudWatch 中规则生成的指标的图表。

LAMBDA

LAMBDA(LambdaFunctionName [, optional-arg]*)

TS

TS[]

调用 Lambda 函数以查询源自非 CloudWatch 数据来源的指标。有关更多信息，请参阅 如何将参数传递给您的 Lambda 函数。

LOG

TS

TS[]

TS

TS[]

时间序列的 LOG 返回的是该时间序列中每个值的自然对数值。

LOG(METRICS())

LOG10

TS

TS[]

TS

TS[]

时间序列的 LOG10 返回的是该时间序列中每个值的以 10 为底的对数值。

LOG10(m1)

MAX

TS

TS[]

S

TS

单个时间序列的 MAX 将返回一个标量，表示指标中所有数据点的最大值。

如果输入时间序列数组，则 MAX 函数会创建并返回一个时间序列，其中包含用作输入的时间序列中每个数据点的最大值。

MAX(m1)/m1

MAX(METRICS())

METRIC_COUNT

TS[]

S

返回时间序列数组中的指标数量。

m1/METRIC_COUNT(METRICS())

METRICS

null

字符串

TS[]

METRICS() 函数返回的是请求中的所有 CloudWatch 指标。数学表达式不包括在内。

您可以在一个更大的表达式中使用 METRICS()，从而最终生成单个时间序列或一组时间序列。

您可以将 METRICS() 函数与一个字符串一起使用，仅返回在其 Id 字段中包含该字符串的绘成图表的指标。例如，表达式 SUM(METRICS("errors")) 一个是所有在其 Id 字段中具有“errors”的绘成图表的指标值的总和的时间序列。您还可以使用 SUM([METRICS(“4xx”), METRICS(“5xx”)]) 来匹配多个字符串。

AVG(METRICS())

SUM(METRICS("errors"))

MIN

TS

TS[]

S

TS

单个时间序列的 MIN 将返回一个标量，表示指标中所有数据点的最小值。

如果输入时间序列数组，则 MIN 函数会创建并返回一个时间序列，其中包含用作输入的时间序列中每个数据点的最小值。

如果输入时间序列数组，则 MIN 函数会创建并返回一个时间序列，其中包含用作输入的时间序列中每个数据点的最小值。

m1-MIN(m1)

MIN(METRICS())

MINUTE

HOUR

DAY

DATE

MONTH

YEAR

EPOCH

TS

TS

这些函数采用时间序列的周期和范围，并返回一个新的非稀疏时间序列，其中每个值都基于其时间戳。

MINUTE(m1)

IF(DAY(m1)<6,m1) 仅返回工作日（即星期一到星期五）的指标。

IF(MONTH(m1) == 4,m1) 仅返回 4 月发布的指标。

PERIOD

TS

S

以秒为单位返回度量的时间段。有效输入是指标，而不是其他表达式的结果。

m1/PERIOD(m1)

RATE

TS

TS[]

TS

TS[]

返回指标每秒的变化率。此项的计算结果是最新数据点值和上一个数据点值之差除以两个值的秒数之差。

RATE(m1)

RATE(METRICS())

REMOVE_EMPTY

TS[]

TS[]

从时间序列数组中删除所有不带数据点的时间序列。最终将获得一个时间序列数组，其中每个时间序列包含至少一个数据点。

REMOVE_EMPTY(METRICS())

RUNNING_SUM

TS

TS[]

TS

TS[]

返回一个时间序列，其中包含原始时间序列中值的运行总和。

RUNNING_SUM([m1,m2])

SEARCH

搜索表达式

一个或多个 TS

返回一个或多个与您指定的搜索条件匹配的时间系列。SEARCH 函数使您能够使用一个表达式将多个相关时间序列添加到图表中。该图表会动态更新，以包含稍后添加并与搜索条件匹配的新指标。有关更多信息，请参阅 在图表中使用搜索表达式。

您无法根据 SEARCH 表达式创建告警。原因在于搜索表达式会返回多个时间序列，而基于数学表达式的告警只能监视一个时间序列。

如果您登录 CloudWatch 跨账户可观测性中的监控账户，则 SEARCH（搜索）函数将在源账户和该监控账户中查找指标。

SERVICE_QUOTA

作为使用指标的 TS

TS

返回给定使用指标的服务配额。您可以使用此选项来可视化当前用量与配额的比较情况，并设置在接近配额时向您发送警告的警报。有关更多信息，请参阅 AWS 使用情况指标。

SLICE

(TS[], S, S) 或 (TS[], S)

TS[]

TS

检索时间序列数组的一部分。这在与 SORT 结合使用时特别有用。例如，可以从时间序列数组中排除顶部结果。

可以使用两个标量参数来定义要返回的时间序列集。这两个标量将定义要返回的数组的开始（包含）和结束（不包含）。该数组从零开始建立索引，因此，数组中的第一个时间序列是时间序列 0。或者，可以仅指定一个值，CloudWatch 将返回以该值开头的所有时间序列。

SLICE(SORT(METRICS(), SUM, DESC), 0, 10) 从请求中的指标数组返回具有最高 SUM 值的 10 个指标。

SLICE(SORT(METRICS(), AVG, ASC), 5) 按 AVG 统计数据对指标数组进行排序，然后返回所有时间序列（具有最低 AVG 的 5 个时间序列除外）。

SORT

(TS[], FUNCTION, SORT_ORDER)

(TS[], FUNCTION, SORT_ORDER, S)

TS[]

根据您指定的函数，对时间序列数组进行排序。您使用的函数可以是 AVG、MIN、MAX 或 SUM。排序顺序可以是 ASC（升序，最低值排第一位）或 DESC（降序，最高值排第一位）。您可以选择在排序顺序后指定一个数字来充当限制。例如，如果指定的限制为 5，则仅返回排序中的前 5 个时间序列。

当图表上显示此数学函数时，图表中每个指标的标签也将进行排序和编号。

SORT(METRICS(), AVG, DESC, 10) 计算每个时间序列的平均值，对时间序列进行排序（开头为最高值），并仅返回具有最高平均值的 10 个时间序列。

SORT(METRICS(), MAX, ASC) 根据 MAX 统计数据对指标数组进行排序，然后以升序顺序返回所有指标。

STDDEV

TS

TS[]

S

TS

单个时间序列的 STDDEV 将返回一个标量，表示指标中所有数据点的标准偏差。一组时间序列的 STDDEV 将返回单个时间序列。

m1/STDDEV(m1)

STDDEV(METRICS())

SUM

TS

TS[]

S

TS

单个时间序列的 SUM 将返回一个标量，表示指标中所有数据点的值的总和。一组时间序列的 SUM 将返回单个时间序列。

SUM(METRICS())/SUM(m1)

SUM([m1,m2])

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

TIME_SERIES

S

TS

返回一个非稀疏时间序列，其中每个值都设置为标量参数。

TIME_SERIES(MAX(m1))

TIME_SERIES(5*AVG(m1))

TIME_SERIES(10)