本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
mon-describe-alarms-for-metric
Description
获取有关与指定指标关联的警报的信息。
Syntax
mon-describe-alarms-for-metric
--metric-name
value
--namespace
value
[--dimensions
"key1=value1
,key2=value2
..."]
[--period value
] [--statistic value
]
[--extendedstatistic value
]
[--unit value
] [Common Options]
Options
名称 | 描述 |
---|---|
|
与指标关联的维度。可以两种方式指定维度,且格式可结合使用或互换使用:
类型: 映射 有效值:格式 name=value 的字符串,其中键是维度的名称,值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。 默认值:不适用 必需:否 |
|
要搜索其关联警报的指标的名称。 类型: 参数 有效值:有效指标名称,长度在 1 到 255 个字符之间。 默认值:不适用 必需:是 |
|
与警报关联的指标的命名空间。有关命名空间的更多信息,请参阅 AWS 命名空间。 类型: 字符串 有效值:有效命名空间,长度在 1 到 250 个字符之间。 默认值:不适用 必需:是 |
|
按其筛选警报的时间段。仅评估此时间段的指标的警报将包含在结果中。如果未指定,则会包含所有周期的警报。 类型: 参数 有效值:一个数字,以秒为单位,是 60 秒的倍数。 默认值:不适用 必需:否 |
|
用于筛选警报的统计数据。仅包含指定统计数据的警报。如果未指定此参数,则包含任何统计数据的警报。 类型: 枚举 有效值:SampleCount、Average、Sum、Minimum 或 Maximum 默认值:不适用 必需:否 |
|
用于筛选警报的百分位数统计数据。仅包含指定统计数据的警报。如果未指定此参数,则包含任何统计数据的警报。 类型: 字符串 有效值:任何百分位数,最多两个小数位(例如 p95.45)。 默认值:不适用 必需:否 |
|
按其筛选警报的单位。仅包含指定统计数据的警报。如果未指定,则会包含所有单位的警报。如果没有为警报指定单位,则搜索警报的唯一方式是忽略此选项。 类型: 枚举 有效值:下列情况之一:
默认值:不适用 必需:否 |
常用选项
名称 | 说明 |
---|---|
|
带有 AWS 凭证的文件位置。您可以使用 类型:字符串 有效值:包含访问密钥 ID 和秘密访问密钥的文件的有效路径。 默认:使用 |
|
用于对请求进行签名的 EC2 证书文件的位置。您可以使用环境变量 类型:字符串 有效值:Amazon EC2 或 AWS Identity and Access Management 提供的 PEM 文件的有效文件路径。 默认:使用 |
|
连接超时值(按秒计)。 类型:整数 有效值:任意正数。 默认值:30 |
|
显示带分隔符(长整型)结果时使用的分隔符。 类型:字符串 有效值:任意字符串。 默认值:逗号 (,) |
|
如果您正在显示表格式或带分隔符的结果,则包括列标题。如果您正在显示 XML 结果,则通过服务请求返回 HTTP 标头(如适用)。 类型:标志 有效值:存在时显示标头。 默认值: |
|
将与秘密密钥结合使用对请求进行签名的访问密钥 ID。它必须与 --secret-key 结合使用,否则将忽略该选项。必须对所有 CloudWatch 请求进行签名,否则请求将被拒绝。 类型:字符串 有效值:有效的访问密钥 ID。 默认值:无 |
|
将用于对请求进行签名的私钥。使用公钥/私钥会导致 CLI 使用 SOAP。使用公共证书和私钥对请求进行签名。此参数必须与 类型:字符串 有效值:有效 ASN.1 私钥的路径。 默认值:无 |
|
请求被定向到的区域。您可以使用环境变量 类型:字符串 有效值:任何 AWS 区域,例如 us-east-1。 默认:us-east-1,除非已设置 |
|
将与访问密钥 ID 结合使用来对请求进行签名的秘密访问密钥。此参数必须与 类型:字符串 有效值:访问密钥 ID。 默认值:无 |
|
使用 (nil) 作为占位符显示空字段,以指示未请求此数据。 类型:标志 有效值:无 默认值:默认情况下不显示空字段。 |
|
显示 CLI 用于调用 AWS 的 URL。 类型:标志 有效值:无 默认值:false |
|
指定显示结果的方式:表格、带分隔符(长整型)、XML 或无输出(秘密型)。 类型:标志 有效值:无 默认值: |
|
用于联系 CloudWatch 的 URL。您可以使用 类型:字符串 有效值:有效的 HTTP 或 HTTPS URL。 默认值:使用 |
Output
此命令将返回包含以下内容的表格:
-
ALARM - 警报名称。
-
DESCRIPTION - 警报说明。该列仅在 --show-long 视图中显示。
-
STATE - 警报状态。
-
STATE_REASON - 人可读的状态原因。该列仅在 --show-long 视图中显示。
-
STATE_REASON_DATA - 机器可读的状态原因(JSON 格式)。该列仅在 --show-long 视图中显示。
-
ENABLED - 启用或禁用操作。该列仅在 --show-long 视图中显示。
-
OK_ACTIONS - 要对 OK 状态执行的操作。该列仅在 --show-long 视图中显示。
-
ALARM_ACTIONS - 要对 ALARM 状态执行的操作。
-
INSUFFICIENT_DATA_ACTIONS - 要对 INSUFFICIENT_DATA 状态执行的操作。该列仅在 --show-long 视图中显示。
-
NAMESPACE - 指标的命名空间。
-
METRIC_NAME - 指标的名称。
-
DIMENSIONS - 指标维度。该列仅在 --show-long 视图中显示。
-
PERIOD - 期间。
-
STATISTIC - 统计数据(Average、Minimum、Maximum、Sum 和 SampleCount)。
-
EXTENDEDSTATISTIC - 百分位统计数据。
-
UNIT - 单位。该列仅在 --show-long 视图中显示。
-
EVAL_PERIODS - 要评估指标的期间数。
-
COMPARISON - 比较运算符。
-
THRESHOLD - 阈值。
Amazon CloudWatch CLI 在 stderr 上显示错误。
Examples
示例请求
此示例描述给定指标的警报。
mon-describe-alarms-for-metric--metric-name CPUUtilization --namespace AWS/EC2 --dimensions InstanceId=i-abcdef
以下是该命令的示例输出。
ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80.0