mon-describe-alarms-for-metric - Amazon CloudWatch
描述语法选项常用选项输出示例相关主题
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

mon-describe-alarms-for-metric

描述

获取有关与指定指标关联的警报的信息。

语法

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]

选项

名称 描述

--dimensions - "key1=value1,key2=value2...

与指标关联的维度。可以两种方式指定维度，且格式可结合使用或互换使用：

  • 每个维度一个选项：--dimensions "key1=value1" --dimensions "key2=value2"

  • 所有维度都在一个选项中: --dimensions "key1=value1,key2=value2"

类型：映射

有效值：格式为 name=value 的字符串，其中，键是维度的名称，值是维度的值。维度名称和值必须是长度介于 1 到 250 个字符之间的 ANSI 字符串。最多允许 10 个维度。

默认值：不适用

必需：否

--metric-name VALUE

要搜索其关联警报的指标的名称。

类型：参数

有效值：长度介于 1 到 255 个字符之间的有效指标名称。

默认值：不适用

必需：是

--namespace VALUE

与警报关联的指标的命名空间。有关命名空间的更多信息，请参阅 Amazon 命名空间。

类型：字符串

有效值：长度介于 1 到 250 个字符之间的有效命名空间。

默认值：不适用

必需：是

--period VALUE

用于筛选告警的时间段。结果中仅包含评估此周期的指标的告警。如果未指定，则会包含所有周期的警报。

类型：参数

有效值：以秒为单位的数字，是 60 秒的倍数。

默认值：不适用

必需：否

--statistic VALUE

用于筛选告警的统计数据。仅包含指定统计数据的告警。如果未指定此参数，则会包含所有统计数据的告警。

类型：枚举

有效值：SampleCount、Average、Sum、Minimum 或 Maximum

默认值：不适用

必需：否

--extendedstatistic VALUE

用于筛选告警的百分位数。仅包含指定统计数据的告警。如果未指定此参数，则会包含所有统计数据的告警。

类型：字符串

有效值：最多两个小数位的任何百分位数（例如 p95.45）。

默认值：不适用

必需：否

--unit VALUE

按其筛选警报的单位。仅包含指定统计数据的警报。如果未指定，则会包含所有单位的警报。如果没有为警报指定单位，则搜索警报的唯一方式是忽略此选项。

类型：枚举

有效值：下列值之一：

  • 秒

  • 微秒

  • 毫秒

  • 字节

  • 千字节

  • 兆字节

  • 千兆字节

  • 千吉字节

  • Bits

  • 千位

  • 兆位

  • 千兆位

  • 太位

  • 百分比

  • 计数

  • Bytes/Second

  • 千字节/秒

  • 兆字节/秒

  • 千兆字节/秒

  • 千吉字节/秒

  • Bits/Second

  • 千位/秒

  • 兆位/秒

  • 千兆位/秒

  • 太位/秒

  • 计数/秒

  • 无

默认值：不适用

必需：否

常用选项

名称 描述

--aws-credential-file VALUE

带有 Amazon 凭证的文件的位置。您可以使用环境变量 AWS_CREDENTIAL_FILE 设置此值。如果您定义了环境变量或提供了凭证文件的路径，则该文件必须存在，否则请求将失败。必须使用访问密钥 ID 和秘密访问密钥签署所有 CloudWatch 请求。

类型：字符串

有效值：包含访问密钥 ID 和秘密访问密钥的文件的有效路径。

默认值：使用环境变量 AWS_CREDENTIAL_FILE（如果已设置）。

-C, --ec2-cert-file-path VALUE

用于签署请求的 EC2 证书文件的位置。您可以使用环境变量 EC2_CERT 指定此值。

类型：字符串

有效值：由 Amazon EC2 或 Amazon Identity and Access Management 提供的 PEM 文件的有效路径。

默认值：使用环境变量 EC2_CERT（如果已设置）。

--connection-timeout VALUE

连接超时值（以秒为单位）。

类型：整数

有效值：任何正数。

默认值：30

--delimiter VALUE

显示经分隔（长）结果时使用的分隔符。

类型：字符串

有效值：任意字符串。

默认值：逗号 (,)

--headers

如果要显示表格结果或分隔结果，请包括列标题。如果要显示 XML 结果，请从服务请求返回 HTTP 标头（如果适用）。

类型：标志

有效值：如果存在，则显示标头。

默认值：默认情况下，--headers 选项为关闭状态。

-I, --access-key-id VALUE

访问密钥 ID 将与私有密钥共同用于签署请求。其必须与私有密钥结合使用，否则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。

类型：字符串

有效值：有效访问密钥 ID。

默认值：无

-K, --ec2-private-key-file-path VALUE

将用于签署请求的私有密钥。使用公有/私有密钥会导致 CLI 使用 SOAP。此请求通过公有证书和私有密钥签署。此参数必须与 EC2_CERT 结合使用，否则此值将被忽略。环境变量 EC2_PRIVATE_KEY 的值将在设置时使用，并且未指定此选项。如果环境变量 AWS_CREDENTIAL_FILE 已设置，或 --aws-credentials-file 已使用，则此选项将被忽略。对 CloudWatch 的所有请求都必须签署，否则请求将被拒绝。

类型：字符串

有效值：有效 ASN.1 私有密钥的路径。

默认值：无

--region VALUE

定向到区域请求。您可以使用环境变量 EC2_REGION 指定该值。该区域用于创建用于调用 CloudWatch 的 URL，并且必须是有效的亚马逊云科技 (Amazon）区域。

类型：字符串

有效值：任意 Amazon 区域，例如 us-east-1。

默认值：除非 EC2_REGION 环境变量已设置，否则为 us-east-1。

S, --secret-key VALUE

将与访问密钥 ID 共同用于签署请求的秘密访问密钥。此参数必须与 --access-key-id 结合使用，否则此选项将被忽略。

类型：字符串

有效值：您的访问密钥 ID。

默认值：无

--show-empty-fields

使用 (nil) 作为占位符显示空字段，以指示未请求此数据。

类型：标志

有效值：无

默认值：默认情况下不显示空字段。

--show-request

显示 CLI 用于调用 Amazon 的 URL。

类型：标志

有效值：无

默认值：false

--show-table, --show-long, --show-xml, --quiet

指定结果的显示方式：表格、分隔（长）、XML 或无输出（无提示）。--show-table 显示以固定列宽形式显示数据的子集；--show-long 显示以字符分隔的所有返回值；--show-xml 是服务的原始返回值；--quiet 将抑制所有标准输出。所有选项是互斥的，优先级：--show-table、--show-long、--show-xml 和 --quiet。

类型：标志

有效值：无

默认值：--show-table

-U, --url VALUE

用于联系 CloudWatch 的 URL。您可以使用环境变量 AWS_CLOUDWATCH_URL 设置此值。此值与 --region 共同用于创建预期的 URL。此选项将覆盖用于服务调用的 URL。

类型：字符串

有效值：有效 HTTP 或 HTTPS URL。

默认值：使用 AWS_CLOUDWATCH_URL（如果已设置）中指定的值。

输出

此命令将返回包含以下内容的表格：

  • 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 - 统计数据（平均值、最小值、最大值、总数和样本数）。

  • EXTENDEDSTATISTIC - 百分位数统计数据。

  • UNIT - 单位。该列仅在 --show-long 视图中显示。

  • EVAL_PERIODS - 用于评估指标的时间段数。

  • COMPARISON - 比较运算符。

  • THRESHOLD - 阈值。

Amazon CloudWatch CLI 在 stderr 上显示错误。

示例

示例请求

此示例描述给定指标的警报。

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

相关主题

下载

相关操作

相关命令