# 使用动态标签
<a name="graph-dynamic-labels"></a>

您可以在图表中使用动态标签。动态标签在选定指标的标签中添加动态更新的值。您可以向标签添加多种值，如下表所示。

在标签中显示的动态值来自于当前在图表上显示的时间范围。在刷新控制面板或图表时，将自动更新标签的动态部分。

如果将动态标签与搜索表达式一起使用，则动态标签适用于搜索返回的每个指标。

您可以使用 CloudWatch 控制台向标签添加动态值、编辑标签、更改动态值在标签列中的位置以及自定义其他内容。

## 动态标签
<a name="dynamic-label-syntax"></a>

在动态标签中，您可以使用与指标属性相关的以下值：


| 动态标签实时值 | 说明 | 
| --- | --- | 
| ${AVG} | 当前在图表中显示的时间范围内的值的平均值。 | 
| ${DATAPOINT\_COUNT} | 图表中当前所示时间范围内的数据点的数量。 | 
| ${FIRST} | 图表中当前所示时间范围内的最早指标值。 | 
| ${FIRST\_LAST\_RANGE} | 图表中当前所示最早数据点和最新数据点的指标值之间的差值。 | 
| ${FIRST\_LAST\_TIME\_RANGE} | 图表中当前所示最早数据点和最新数据点之间的绝对时间范围。 | 
| ${FIRST\_TIME} | 图表中当前所示时间范围内的最早数据点的时间戳。 | 
| ${FIRST\_TIME\_RELATIVE} | 此刻与图表中当前所示时间范围内的最早数据点的时间戳之间的绝对时间差。 | 
| ${LABEL} | 指标的默认标签的表示形式。 | 
| ${LAST} | 图表中当前所示时间范围内的指标值的最新值。 | 
| ${LAST\_TIME} | 图表中当前所示时间范围内的最新数据点的时间戳。 | 
| ${LAST\_TIME\_RELATIVE} | 此刻与图表中当前所示时间范围内的最新数据点的时间戳之间的绝对时间差。 | 
| ${MAX} | 当前在图表中显示的时间范围内的值的最大值。 | 
| ${MAX\_TIME} | 图表中当前所示数据点中具有最高指标值的数据点的时间戳。 | 
| ${MAX\_TIME\_RELATIVE} | 此刻与图表中当前所示数据点中具有最高值的数据点的时间戳之间的绝对时间差。 | 
| ${MIN} | 当前在图表中显示的时间范围内的值的最小值。 | 
| ${MIN\_MAX\_RANGE} | 图表中当前所示数据点中具有最高指标值和最低指标值的数据点之间的指标值之差。 | 
| ${MIN\_MAX\_TIME\_RANGE} | 图表中当前所示数据点中具有最高指标值和最低指标值的数据点之间的绝对时间范围。 | 
| ${MIN\_TIME} | 图表中当前所示数据点中具有最低指标值的数据点的时间戳。 | 
| ${MIN\_TIME\_RELATIVE} | 此刻与图表中当前所示数据点中具有最低值的数据点的时间戳之间的绝对时间差。 | 
| ${PROP('AccountId')} | 指标的 AWS 账户 ID。 | 
| ${PROP('AccountLabel')} | 在 CloudWatch 跨账户可观测性中,为拥有该指标的源账户指定的标签。 | 
| ${PROP('Dim.{{dimension\_name}}')} | 指定维度的值。将 {{dimension\_name}} 替换为您的维度名称（区分大小写。 | 
| ${PROP('MetricName')} | 指标的名称。 | 
| ${PROP('Namespace')} | 指标的命名空间。 | 
| ${PROP('Period')} | 指标的时间段（以秒为单位）。 | 
| ${PROP('Region')} | 发布指标的 AWS 区域。 | 
| ${PROP('Stat')} | 正在用于绘制图表的指标统计数据。 | 
| ${SUM} | 当前在图表中显示的时间范围内的值的总和。 | 

例如，假设您使用 **SEARCH(' {AWS/Lambda, FunctionName} Errors ', 'Sum')** 搜索表达式，它查找每个 Lambda 函数的 `Errors`。如果将标签设置为 `[max: ${MAX} Errors for Function Name ${LABEL}]`，则每个指标的标签为 **[max: {{number}} Errors for Function Name {{Name}}]**。

您最多可以在标签中添加 6 个动态值。您只能在每个标签中使用一次 `${LABEL}` 占位符。