mon-get-stats - Amazon CloudWatch
DescriçãoSintaxeOpçõesOpções comunsResultadoExemplosTópicos relacionados

mon-get-stats

Descrição

Obtém dados de série temporal para as estatísticas especificadas.

nota

Quando você cria uma nova métrica usando o comando mon-put-data, pode levar até dois minutos para recuperar estatísticas na nova métrica usando o comando mon-get-stats. No entanto, pode levar até 15 minutos para que a nova métrica seja exibida na lista de métricas recuperadas com o comando mon-list-metrics.

Sintaxe

mon-get-stats MetricName --namespace value --statistics value[,value...] [--dimensions "key1=value1,key2=value2..." ] [--end-time value] [--period value] [--start-time value] [--unit value] [Common Options]

Opções

Name (Nome) Descrição

MetricName

O nome da métrica. Também defina esse valor usando --metric-name.

Tipo: argumento

Valores válidos: qualquer nome da métrica válido entre 1 e 255 caracteres.

Padrão: n/d

Obrigatório: Sim

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

As dimensões da métrica. Especifique dimensões de duas maneiras, e os formatos podem ser combinados ou usados de maneira intercambiável:

  • Uma opção por dimensão: --dimensions "key1=value1" --dimensions "key2=value2"

  • Opção multifuncional: --dimensions "key1=value1,key2=value2"

Tipo: mapa

Valores válidos: uma string do formato nome = valor, em que a chave é o nome da dimensão e o valor é o valor da dimensão. Os nomes de dimensão e os valores devem ser uma string ANSI entre 1 e 250 caracteres. Um máximo de 10 dimensões é permitido.

Padrão: n/d

Obrigatório: não

--end-time VALUE

O time stamp permitido mais recente para pontos de dados retornados. A hora de término é exclusiva. Os time stamps são especificados usando-se o formato combinado ISO8601. Por exemplo, a data e a hora em 30 de julho de 2013, 12:30:00 PST, seriam representadas como 2013-07-30T12:30:00-07:00 ou em UTC: 2013-07-30T19:30:00Z. A resolução máxima que pode ser retornada pelo CloudWatch é 1 minuto, porque todos os carimbos de data/hora são arredondados para baixo até o minuto mais próximo.

Tipo: argumento

Valores válidos: um time stamp válido representado no formato ISO8601 com diferença de fuso horário ou indicador UTC.

Padrão: a data/hora atual.

Obrigatório: não

-n, --namespace VALUE

O namespace da métrica. Para obter mais informações sobre namespaces, consulte Namespaces do AWS.

Tipo: sequência

Valores válidos: um namespace válido entre 1 e 250 caracteres de comprimento.

Padrão: n/d

Obrigatório: Sim

--period VALUE

A granularidade, em segundos, para recuperar estatísticas. O período deve ter pelo menos 60 segundos e ser um múltiplo de 60.

Tipo: argumento

Valores válidos: um número, em segundos, que seja um múltiplo de 60 segundos.

Padrão: 60 segundos.

Obrigatório: não

-s, --statistics VALUE1,VALUE2,VALUE3...

As estatísticas a serem retornadas para a métrica especificada.

Tipo: enumeração

Valores válidos: Average, Sum, Maximum ou Minimum

Padrão: n/d

Obrigatório: Sim

--start-time VALUE

O primeiro time stamp permitido para pontos de dados retornados. A hora de início é inclusiva. Os time stamps são especificados usando-se o formato combinado ISO8601. Por exemplo, a data e a hora em 30 de julho de 2013, 12:30:00 PST, seriam representadas como 2013-07-30T12:30:00-07:00 ou em UTC: 2013-07-30T19:30:00Z. A resolução máxima que pode ser retornada pelo CloudWatch é 1 minuto, porque todos os carimbos de data/hora são arredondados para baixo até o minuto mais próximo.

Tipo: argumento

Valores válidos: um time stamp válido representado no formato ISO8601 com diferença de fuso horário ou indicador UTC.

Padrão: uma hora antes da hora atual.

Obrigatório: não

--unit VALUE

A unidade para recuperar as métricas. As métricas podem ser relatadas em várias unidades, e esse comando recupera uma unidade específica para determinada métrica. Não solicitar uma unidade fará todas as unidades serem retornadas. Se a métrica sempre for relatada com uma unidade, isso não terá efeito.

Tipo: enumeração

Valores válidos: um dos seguintes:

  • Segundos

  • Microssegundos

  • Milissegundos

  • Bytes

  • Kilobytes

  • Megabytes

  • Gigabytes

  • Terabytes

  • Bits

  • Kilobits

  • Megabits

  • Gigabits

  • Terabits

  • Percentual

  • Contagem

  • Bytes/segundo

  • Kilobytes/segundo

  • Megabytes/segundo

  • Gigabytes/segundo

  • Terabytes/segundo

  • Bits/segundo

  • Kilobits/segundo

  • Megabits/segundo

  • Gigabits/segundo

  • Terabits/segundo

  • Contagem/segundo

  • Nenhum

Padrão: n/d

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: sequência

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: sequência

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: 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: sequência

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: sequência

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: sequência

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: sequência

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: sequência

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: falso

--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: sequência

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

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

Resultado

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

  • Time – A hora em que as métricas foram obtidas.

  • SampleCount – Nenhuma descrição disponível para essa coluna.

  • Average – O valor médio.

  • Sum – A soma dos valores.

  • Minimum – O valor mínimo observado.

  • Maximum – O valor máximo observado.

  • Unit – A unidade da métrica.

A CLI do Amazon CloudWatch exibe erros em stderr.

Exemplos

Exemplo de solicitação

Esse exemplo retorna a utilização média, mínima e máxima da CPU por instância do EC2 i-c07704a9, na resolução de 1 hora.

mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"

Este é um exemplo de uma saída das métricas Samples e Average em resolução de um minuto.

Time                 Samples  Average  Unit   
2013-05-19 00:03:00  2.0      0.19     Percent
2013-05-19 00:04:00  2.0      0        Percent
2013-05-19 00:05:00  2.0      0        Percent
2013-05-19 00:06:00  2.0      0        Percent
2013-05-19 00:07:00  2.0      0        Percent
2013-05-19 00:08:00  2.0      0        Percent
2013-05-19 00:09:00  2.0      0        Percent
2013-05-19 00:10:00  2.0      0        Percent
2013-05-19 00:11:00  2.0      0        Percent
2013-05-19 00:12:00  2.0      0.195    Percent
2013-05-19 00:13:00  2.0      0.215    Percent
...

Exemplo de solicitação

Esse exemplo retorna a utilização da CPU em toda a frota do EC2.

mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"

Exemplo de solicitação

Esse exemplo retorna a contagem de solicitações média, mínima e máxima de solicitações feitas para a pilha de teste de MyService para um determinado usuário, em resolução de 1 hora.

mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"

Exemplo de solicitação

Esse exemplo mostra estatísticas RequestCount em todo "MyService".

mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"

Tópicos relacionados

Baixar

Ação relacionada

Comandos relacionados