mon-describe-alarm-history - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

mon-describe-alarm-history

描述

检索指定警报的历史记录。您可以按日期范围或项目类型筛选警报。如果不指定告警名称,Amazon CloudWatch 会返回所有告警的历史记录。

注意

Amazon CloudWatch 将活动告警和已删除告警的历史记录保留两个星期。

语法

mon-describe-alarm-history [AlarmNames [AlarmNames ...]] [--end-date value] [--history-item-type value] [--start-date value] [Common Options]

Options

名称 描述

AlarmName AlarmNames

警报的名称,用空格分隔。如果不指定警报名称,此命令会返回所有警报的历史记录。还可以使用 --alarm-name 设置此值。

类型:参数

有效值:长度介于 1 到 255 个字符之间的任何字符串。

默认值:不适用

必需:否

--end-date VALUE

历史记录的日期范围的结束日期。

类型:日期

有效值:YYYY-MM-DD 格式的日期。

默认值:当前日期。

必需:否

--history-item-type VALUE

要检索的历史记录项的类型。默认情况下,返回所有类型。

类型:枚举

有效值:ConfigurationUpdate、StateUpdate 或 Action

默认值:返回所有类型。

必需:否

--start-date VALUE

历史记录的日期范围的开始日期。默认情况下,它会延伸到所有可用历史记录。

类型:日期

有效值:YYYY-MM-DD 格式的日期。

默认值:所有可用历史记录。

必需:否

常用选项

名称 描述

--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 - 警报名称。

  • TIMESTAMP - 时间戳。

  • TYPE - 事件类型,ConfigurationUpdate、StateUpdate 和 Action 之一。

  • SUMMARY - 历史记录事件的人可读汇总。

  • DATA - 有关事件的机器可读 JSON 格式的详细数据。该列仅在 --show-long 视图中显示。

Amazon CloudWatch CLI 在 stderr 上显示错误。

示例

示例请求

此示例描述 my-alarm 警报的所有历史记录项。

mon-describe-alarm-history--alarm-name my-alarm --headers

以下是该命令的示例输出。

ALARM TIMESTAMP TYPE SUMMARY my-alarm 2013-05-07T18:46:16.121Z Action Published a notification to arn:aws:sns:... my-alarm 2013-05-07T18:46:16.118Z StateUpdate Alarm updated from INSUFFICIENT_DATA to OK my-alarm 2013-05-07T18:46:07.362Z ConfigurationUpdate Alarm "my-alarm" created

相关 主题

下载

相关操作

相关命令