# mon-get-stats
<a name="cli-mon-get-stats"></a>

## Descrição
<a name="w2aab9c39b3"></a>

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
<a name="w2aab9c39b5"></a>

 ****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
<a name="w2aab9c39b7"></a>


| 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html). Tipo: string 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html) Padrão: n/d Obrigatório: não  | 

## Opções comuns
<a name="w2aab9c39b9"></a>


| 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: 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: 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: string Valores válidos: uma URL HTTP ou HTTPS válida. Padrão: usa o valor especificado em `AWS_CLOUDWATCH_URL`, se estiver definido.  | 

## Output
<a name="w2aab9c39c11"></a>

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
<a name="w2aab9c39c13"></a>

### Exemplo de solicitação
<a name="w2aab9c39c13b2"></a>

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
<a name="w2aab9c39c13b4"></a>

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
<a name="w2aab9c39c13b6"></a>

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
<a name="w2aab9c39c13b8"></a>

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
<a name="w2aab9c39c15"></a>

### Baixar
<a name="w2aab9c39c15b2"></a>
+ [Configurar a interface de linha de comando](SetupCLI.md)

### Ação relacionada
<a name="w2aab9c39c15b4"></a>
+ [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)

### Comandos relacionados
<a name="w2aab9c39c15b6"></a>
+  [mon-list-metrics](cli-mon-list-metrics.md) 
+  [mon-describe-alarms](cli-mon-describe-alarms.md)