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

## Descripción
<a name="w2aab9c39b3"></a>

Obtiene datos de serie temporal para las estadísticas especificadas.

**nota**  
Cuando se crea una nueva métrica con el comando `mon-put-data`, puede tardar hasta dos minutos antes de poder recuperar las estadísticas en la nueva métrica mediante el comando `mon-get-stats`. Sin embargo, puede tardar hasta 15 minutos antes de que la nueva métrica aparezca en la lista de métricas recuperadas mediante el comando `mon-list-metrics`.

## Sintaxis
<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] ** 

## Opciones
<a name="w2aab9c39b7"></a>


| Nombre | Descripción | 
| --- | --- | 
| `MetricName` | El nombre de la métrica. Puede establecer también este valor mediante : `--metric-name`.<br />Tipo: argumento<br />Valores válidos: cualquier nombre de métrica válido entre 1 y 255 caracteres.<br />Valor predeterminado: n/a<br />Obligatorio: sí | 
| `--dimensions` `"key1=value1,key2=value2..." `  | Las dimensiones de la métrica. Puede especificar dimensiones dos formas y los formatos se pueden combinar o utilizar indistintamente:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html)<br />Tipo: Map<br />Valores válidos: una cadena con el formato nombre=valor, donde la clave es el nombre de la dimensión y el valor es el valor de la dimensión. Los nombres de dimensión y los valores deben ser una cadena ANSI de entre 1 y 250 caracteres. Se permite un máximo de 10 dimensiones.<br />Valor predeterminado: n/a<br />Obligatorio: no | 
| `--end-time` `VALUE`  | La última marca temporal permitida para devolver puntos de datos. La hora de finalización es exclusiva. Las marcas temporales se especifican mediante el formato combinado ISO8601. Por ejemplo la fecha y la hora del 30 de julio de 2013 a las 12:30:00 PST se representa como 2013-07-30T12:30:00 -07:00 o en UTC: 2013-07-30T19:30:00Z. La resolución máxima que se puede devolver por CloudWatch es 1 minuto, por lo tanto, todas las marcas temporales se redondean hacia abajo al minuto más cercano.<br />Tipo: argumento<br />Valores válidos: una marca temporal válida representada en formato ISO8601 con ajuste numérico de zona horaria o indicador UTC. <br />Valor predeterminado: la fecha/hora actual.<br />Obligatorio: no | 
| `-n, --namespace` `VALUE`  | El nombre del espacio de la métrica. Para obtener más información acerca de los espacios de nombres, consulte [Espacios de nombres de AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html).<br />Tipo: cadena<br />Valores válidos: un espacio de nombres válido de entre 1 y 250 caracteres de longitud.<br />Valor predeterminado: n/a<br />Obligatorio: sí | 
| `--period` `VALUE`  | El grado de detalle, en segundos, para recuperar las estadísticas. El periodo debe ser de al menos 60 segundos y debe ser un múltiplo de 60. <br />Tipo: argumento<br />Valores válidos: un número, en segundos que es un múltiplo de 60 segundos.<br />Valor predeterminado: 60 segundos.<br />Obligatorio: no | 
|  `-s, --statistics` `VALUE1,VALUE2,VALUE3...`  | Las estadísticas que se van a devolver para la métrica especificada.<br />Tipo: enumeración<br />Valores válidos: Average, Sum, Maximum o Minimum<br />Valor predeterminado: n/a<br />Obligatorio: sí | 
| `--start-time` `VALUE`  | La primera marca temporal permitida para devolver puntos de datos. La hora de inicio está incluida. Las marcas temporales se especifican mediante el formato combinado ISO8601. Por ejemplo la fecha y la hora del 30 de julio de 2013 a las 12:30:00 PST se representa como 2013-07-30T12:30:00 -07:00 o en UTC: 2013-07-30T19:30:00Z. La resolución máxima que se puede devolver por CloudWatch es 1 minuto, por lo tanto, todas las marcas temporales se redondean hacia abajo al minuto más cercano. <br />Tipo: argumento<br />Valores válidos: una marca temporal válida representada en formato ISO8601 con ajuste numérico de zona horaria o indicador UTC.<br />Valor predeterminado: una hora antes de la hora actual.<br />Obligatorio: no | 
| `--unit` `VALUE`  | La unidad para la que recuperar las métricas. Las métricas puede notificarse en varias unidades, esta recupera una unidad específica para una métrica concreta. Si no se solicita una unida, se devolverán todas las unidades. Si la métrica solo se notifica con una unidad, no tendrá ningún efecto.<br />Tipo: enumeración<br />Valores válidos: uno de los siguientes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html)<br />Valor predeterminado: n/a<br />Obligatorio: no | 

## Opciones comunes
<a name="w2aab9c39b9"></a>


| Nombre | Descripción | 
| --- | --- | 
| `--aws-credential-file` `VALUE`  | La ubicación del archivo de credenciales de AWS. Puede establecer este valor mediante la variable de entorno `AWS_CREDENTIAL_FILE`. Si define la variable de entorno o proporciona la ruta de acceso al archivo de credenciales, el archivo debe existir o, de lo contrario, se produce un error en la solicitud. Las solicitudes de CloudWatch deben firmarse con un ID de clave de acceso y una clave de acceso secreta.<br />Tipo: cadena<br />Valores válidos: Ruta de acceso válida de un archivo que contenga el ID de clave de acceso y la clave de acceso secreta.<br />Valor predeterminado: Utiliza la variable de entorno `AWS_CREDENTIAL_FILE`, si se establece. | 
| `-C, --ec2-cert-file-path` `VALUE`  | La ubicación del archivo del certificado EC2 para las solicitudes de firma. Puede utilizar la variable de entorno `EC2_CERT` para especificar este valor.<br />Tipo: cadena<br />Valores válidos: una ruta de archivo válida al archivo PEM que Amazon EC2 o proporcionan AWS Identity and Access Management.<br />Valor predeterminado: Utiliza la variable de entorno `EC2_CERT`, si se establece. | 
|  `--connection-timeout` `VALUE`  | El valor del tiempo de espera de la conexión en segundos.<br />Tipo: número entero<br />Valores válidos: Cualquier número positivo.<br />Valor predeterminado: 30 | 
|  `--delimiter` `VALUE`  | El delimitador que se va a utilizar al mostrar resultados delimitados (largos).<br />Tipo: cadena<br />Valores válidos: Cualquier cadena.<br />Valor predeterminado: Coma (,) | 
|  `--headers` ``  | Si muestra resultados tabulares o delimitados, incluya las cabeceras de columna. Si muestra resultados XML, devuelva las cabeceras HTTP de la solicitud de servicio, si corresponde.<br />Tipo: marca<br />Valores válidos: Cuando hay, muestra cabeceras.<br />Valor predeterminado: La opción `--headers` está deshabilitada de forma predeterminada. | 
|  `-I, --access-key-id` `VALUE`  | El ID de clave de acceso que se utilizará, en combinación con la clave secreta, para firmar la solicitud. Esto se debe utilizar en combinación con la clave secreta, de lo contrario, se ignora la opción. Todas las solicitudes a CloudWatch deben estar firmadas; de lo contrario, la solicitud se rechaza.<br />Tipo: cadena<br />Valores válidos: Un ID de clave de acceso válido.<br />Valor predeterminado: none | 
|  `-K, --ec2-private-key-file-path` `VALUE`  | La clave privada que se va a utilizar para firmar la solicitud. El uso de claves públicas o privadas hace que la CLI utilice SOAP. La solicitud se firma con un certificado público y una clave privada. Este parámetro se debe usar junto con `EC2_CERT`, de lo contrario, el valor no se tiene en cuenta. El valor de la variable de entorno `EC2_PRIVATE_KEY` se usará si está configurado, y esta opción no está especificada. Esta opción se pasa por alto si la variable de entorno `AWS_CREDENTIAL_FILE` está establecida, o se utiliza `--aws-credentials-file`. Todas las solicitudes a CloudWatch deben estar firmadas; de lo contrario, la solicitud se rechaza.<br />Tipo: cadena<br />Valores válidos: Ruta de acceso a una clave privada ASN.1 válida.<br />Valor predeterminado: none | 
|  `--region` `VALUE`  | Las solicitudes de región se dirigen a. Puede utilizar la variable de entorno `EC2_REGION` para especificar el valor. La región se utiliza para crear la URL que se utiliza para llamar a CloudWatch, y debe ser una Región (de AWS) válida de Amazon Web Services.<br />Tipo: cadena<br />Valores válidos: Cualquier Región de AWS, por ejemplo, us-east-1.<br />Valor predeterminado: us-east-1, a menos que la variable de entorno `EC2_REGION` esté establecida. | 
|  `S, --secret-key` `VALUE`  | La clave de acceso secreta que se utilizará para firmar la solicitud, junto con un ID de clave de acceso. Este parámetro se debe usar junto con `--access-key-id`, de lo contrario, la opción no en tiene en cuenta.<br />Tipo: cadena<br />Valores válidos: ID de clave de acceso.<br />Valor predeterminado: none | 
|  `--show-empty-fields` ``  | Muestra campos vacíos al utilizar (nulo) como espacio disponible para indicar que no se solicitaron estos datos.<br />Tipo: marca<br />Valores válidos: Ninguno<br />Valor predeterminado: Los campos vacíos no se muestran de forma predeterminada. | 
|  `--show-request` ``  | Muestra la URL que utiliza la CLI para llamar a AWS.<br />Tipo: marca<br />Valores válidos: Ninguno<br />Predeterminado: false | 
|  `--show-table, --show-long, --show-xml, --quiet` ``  | Especifica cómo se muestran los resultados: en una tabla, delimitados (largos), XML o sin salida (silenciosos). La pantalla `--show-table` muestra un subconjunto de los datos en forma de ancho de columna fija; `--show-long` muestra todos los valores devueltos delimitados por un carácter; `--show-xml` es el retorno sin procesar del servicio; y `--quiet` suprime toda la salida estándar. Todas las opciones son mutuamente excluyentes, con la prioridad `--show-table`, `--show-long`, `--show-xml` y `--quiet`.<br />Tipo: marca<br />Valores válidos: Ninguno<br />Valor predeterminado: `--show-table` | 
|  `-U, --url` `VALUE`  | La dirección URL que se utiliza para contactarse con CloudWatch. Puede establecer este valor mediante la variable de entorno `AWS_CLOUDWATCH_URL`. Este valor se usa en combinación con `--region` para crear la URL esperada. Esta opción anula la dirección URL de la llamada de servicio.<br />Tipo: cadena<br />Valores válidos: Una dirección HTTP o HTTPS válida.<br />Valor predeterminado: utiliza el valor que se especifica en `AWS_CLOUDWATCH_URL`, si se establece. | 

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

Este comando devuelve una tabla que contiene lo siguiente:
+ Time: la hora a la que se tomó la métrica.
+ SampleCount: sin descripción disponible para esta columna.
+ Average: el valor medio.
+ Sum: la suma de valores.
+ Minimum: el valor mínimo observado.
+ Maximum: el valor máximo observado.
+ Unit: la unidad de la métrica.

La CLI de Amazon CloudWatch muestra errores en stderr.

## Ejemplos
<a name="w2aab9c39c13"></a>

### Ejemplo de solicitud
<a name="w2aab9c39c13b2"></a>

En este ejemplo, se devuelve la utilización media, mínima y máxima de la CPU para la instancia EC2 i-c07704a9, con una resolución 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 es un ejemplo de una salida de las métricas Samples y Average con una resolución de un 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
...
```

### Ejemplo de solicitud
<a name="w2aab9c39c13b4"></a>

Este ejemplo devuelve la utilización de la CPU en su flota de 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"
```

### Ejemplo de solicitud
<a name="w2aab9c39c13b6"></a>

En este ejemplo, se devuelve el número medio, mínimo y máximo de solicitudes realizadas en la pila de prueba de MyService para un usuario determinado, con una resolución 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"
```

### Ejemplo de solicitud
<a name="w2aab9c39c13b8"></a>

En este ejemplo se muestran estadísticas RequestCount en todos los "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" 
```

## Temas relacionados
<a name="w2aab9c39c15"></a>

### Descargar
<a name="w2aab9c39c15b2"></a>
+ [Configurar la interfaz de línea de comandos](SetupCLI.md)

### Acción 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)