mon-describe-alarm-history - Amazon CloudWatch
DescriçãoSintaxeOpçõesOpções comunsSaídaExemplosTópicos relacionados da

mon-describe-alarm-history

Descrição

Recupera o histórico do alarme especificado. Filtre alarmes por intervalo de datas ou tipo de item. Se você não especificar um nome do alarme, o Amazon CloudWatch retornará históricos de todos os alarmes.

nota

O Amazon CloudWatch retém o histórico de alarmes ativos e excluídos por duas semanas.

Sintaxe

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

Opções

Nome Descrição

AlarmName AlarmNames

Os nomes dos alarmes, separados por espaços. Se você não especificar um nome do alarme, esse comando retornará os históricos de todos os alarmes. Também defina esse valor usando --alarm-name.

Tipo: argumento

Valores válidos: qualquer string entre 1 e 255 caracteres de comprimento.

Padrão: n/d

Obrigatório: Não

--end-date VALUE

O final do intervalo de datas do histórico.

Tipo: data

Valores válidos: data no formato AAAA-MM-DD.

Padrão: a data atual.

Obrigatório: Não

--history-item-type VALUE

O tipo de itens do histórico a ser recuperado. Por padrão, todos os tipos são retornados.

Tipo: enumeração

Valores válidos: ConfigurationUpdate, StateUpdate ou Action

Padrão: todos os tipos são retornados.

Obrigatório: Não

--start-date VALUE

O início do intervalo de datas do histórico. Por padrão, ele se estende a todo o histórico disponível.

Tipo: data

Valores válidos: data no formato AAAA-MM-DD.

Padrão: todo o histórico disponível.

Obrigatório: Não

Opções comuns

Nome Descrição

--aws-credential-file VALUE

O local do arquivo com suas credenciais da AWS. É possível definir esse valor usando a variável de ambiente AWS_CREDENTIAL_FILE. Se você definir a variável de ambiente ou fornecer o caminho para o arquivo de credenciais, a solicitação falhará caso o arquivo não exista. Todas as solicitações do CloudWatch deverão ser assinadas usando seu ID da chave de acesso e sua chave de acesso secreta.

Tipo: string

Valores válidos: um caminho válido para um arquivo contendo seu ID da chave de acesso e sua chave de acesso secreta.

Padrão: usa a variável de ambiente AWS_CREDENTIAL_FILE, se estiver definida.

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

O local do arquivo de certificado do EC2 para solicitações de assinatura. É possível usar a variável de ambiente EC2_CERT para especificar esse valor.

Tipo: string

Valores válidos: um caminho de arquivo válido para o arquivo PEM fornecido pelo Amazon EC2 ou pelo AWS Identity and Access Management.

Padrão: usa a variável de ambiente EC2_CERT, se estiver definida.

--connection-timeout VALUE

O valor de tempo limite de conexão, em segundos.

Tipo: número inteiro

Valores válidos: qualquer número positivo.

Padrão: 30

--delimiter VALUE

O delimitador a ser usado quando são exibidos resultados delimitados (longos).

Tipo: string

Valores válidos: qualquer string.

Padrão: vírgula (,)

--headers

Se estiver exibindo resultados tabulares ou delimitados, inclua os cabeçalhos de coluna. Se estiver exibindo resultados em XML, retorne os cabeçalhos HTTP da solicitação de serviço, quando aplicável.

Tipo: sinalizador

Valores válidos: quando presente, exibe cabeçalhos.

Padrão: a opção --headers fica desativada por padrão.

-I, --access-key-id VALUE

O ID da chave de acesso que será usada, em conjunto com a chave secreta, para assinar a solicitação. Esse parâmetro deverá ser usado em conjunto com --secret-key, ou a opção será ignorada. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada.

Tipo: string

Valores válidos: um ID da chave de acesso válido.

Padrão: nenhum

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

A chave privada que será usada para assinar a solicitação. Utilizar chaves públicas/privadas faz com que a CLI use SOAP. A solicitação é assinada com um certificado público e uma chave privada. Esse parâmetro deverá ser usado em conjunto com EC2_CERT, ou o valor será ignorado. O valor da variável de ambiente EC2_PRIVATE_KEY será usado se estiver definido e se essa opção não estiver especificada. Essa opção será ignorada se a variável de ambiente AWS_CREDENTIAL_FILE estiver definida ou quando se utilizar --aws-credentials-file. Todas as solicitações para o CloudWatch deverão ser assinadas, ou a solicitação será rejeitada.

Tipo: string

Valores válidos: o caminho para uma chave privada ASN.1 válida.

Padrão: nenhum

--region VALUE

A região para onde as solicitações são direcionadas. É possível usar a variável de ambiente EC2_REGION para especificar o valor. Utiliza-se a região para criar a URL usada para chamar o CloudWatch e deve ser uma região da Amazon Web Services válida (AWS).

Tipo: string

Valores válidos: qualquer região da AWS, por exemplo, us-east-1.

Padrão: us-east-1, a menos que a variável de ambiente EC2_REGION esteja definida.

S, --secret-key VALUE

A chave de acesso secreta que será usada para assinar a solicitação, em conjunto com a ID da chave de acesso. Esse parâmetro deverá ser usado em conjunto com --access-key-id, ou essa opção será ignorada.

Tipo: string

Valores válidos: seu ID da chave de acesso.

Padrão: nenhum

--show-empty-fields

Exibe campos vazios usando (nil) como espaço reservado para indicar que esses dados não foram solicitados.

Tipo: sinalizador

Valores válidos: nenhum

Padrão: campos vazios não são exibidos por padrão.

--show-request

Exibe a URL que a CLI usa para chamar a AWS.

Tipo: sinalizador

Valores válidos: nenhum

Padrão: False

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

Especifica como os resultados são exibidos: em uma tabela, delimitados (longos), XML ou nenhuma saída (silenciosos). A exibição --show-table mostra um subconjunto dos dados em forma fixa de largura de coluna; --show-long exibe todos os valores retornados delimitados por um caractere; --show-xml é o retorno bruto do serviço; e --quiet suprime todas as saídas padrão. Todas as opções são mutuamente exclusivas, tendo prioridade --show-table, --show-long, --show-xml e --quiet.

Tipo: sinalizador

Valores válidos: nenhum

Padrão: --show-table

-U, --url VALUE

A URL usada para entrar em contato com o CloudWatch. É possível definir esse valor usando a variável de ambiente AWS_CLOUDWATCH_URL. Esse valor é usado em conjunto com --region para criar a URL esperada. Essa opção substitui a URL da chamada de serviço.

Tipo: string

Valores válidos: uma URL HTTP ou HTTPS válida.

Padrão: usa o valor especificado em AWS_CLOUDWATCH_URL, se estiver definido.

Saída

Esse comando retorna uma tabela que contém o seguinte:

  • ALARM – O nome do alarme.

  • TIMESTAMP – O time stamp.

  • TYPE – O tipo de evento, ConfigurationUpdate, StateUpdate e Action.

  • SUMMARY – Um resumo legível por humano do evento do histórico.

  • DATA – Dados detalhados sobre o evento no formato JSON legível por máquina. Essa coluna só é mostrada na exibição --show-long.

A CLI do Amazon CloudWatch exibe erros em stderr.

Exemplos

Exemplo de solicitação

Esse exemplo descreve todos os itens de histórico para o alarme my-alarm.

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

Essa é uma saída de exemplo desse comando.

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

Tópicos relacionados da

Baixar

Ação relacionada

Comandos relacionados