# Situación: Publicación de métricas en CloudWatch
En esta situación, utiliza AWS Command Line Interface (AWS CLI) para publicar una métrica única para una aplicación hipotética denominada *GetStarted*. Si no ha instalado y configurado todavía la AWS CLI, consulte [Getting Set Up with the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) (Configuración inicial del AWS Command Line Interface) en la *Guía del usuario*.
**Topics**
+ [Paso 1: Defina la configuración de datos](#define-data-domain)
+ [Paso 2: Agregue métricas a CloudWatch](#add-metrics-to-scenario)
+ [Paso 3: Obtenga estadísticas de CloudWatch](#GetStatistics)
+ [Paso 4: Visualice gráficos con la consola](#ViewGraphs)
## Paso 1: Defina la configuración de datos
En esta situación, publica puntos de datos que realizan un seguimiento de la latencia de solicitudes para la aplicación. Elija nombres para su métrica y el espacio de nombres que tenga sentido. En este ejemplo, nombre la métrica *RequestLatency* y coloque todos los puntos de datos en el espacio de nombres *GetStarted*.
Puede publicar varios puntos de datos que representan colectivamente los datos de latencia de tres horas. Los datos sin procesar engloban 15 lecturas de latencia de solicitud distribuidas en tres horas. Cada lectura está en milisegundos:
+ Hora uno: 87, 51, 125, 235
+ Hora dos: 121, 113, 189, 65, 89
+ Hora tres: 100, 47, 133, 98, 100, 328
Puede publicar datos en CloudWatch como puntos de datos únicos o como un conjunto de puntos de datos acumulados que se conoce como *conjunto estadístico*. Puede acumular métricas con una granularidad de tan solo un minuto. Puede publicar los puntos de datos acumulados en CloudWatch como un conjunto de estadísticas con cuatro claves predefinidas: `Sum`, `Minimum`, `Maximum` y `SampleCount`.
Publica los puntos de datos desde la hora uno como puntos de datos únicos. Para los datos de las horas dos y tres, acumulará los puntos de datos y publica un conjunto estadístico para cada hora. Los valores principales se muestran en la siguiente tabla.
| Hora | Datos sin procesar | Sum | Mínimo | Máximo | SampleCount |
| --- | --- | --- | --- | --- | --- |
| `1` | `87` | | | | |
| `1` | `51` | | | | |
| `1` | `125` | | | | |
| `1` | `235` | | | | |
| `2` | `121, 113, 189, 65, 89` | `577` | `65` | `189` | `5` |
| `3` | `100, 47, 133, 98, 100, 328` | `806` | `47` | `328` | `6` |
## Paso 2: Agregue métricas a CloudWatch
Después de haber definido la configuración de datos, está listo para agregar datos.
**Para publicar puntos de datos en CloudWatch**
1. En el símbolo del sistema, ejecute los siguientes comandos [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html) para agregar datos para la primera hora. Sustituya la marca temporal de ejemplo por una marca temporal que se encuentre dos horas en el pasado, en tiempo universal coordinado (UTC).
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp {{2016-10-14T20:30:00Z}} --value 87 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp {{2016-10-14T20:30:00Z}} --value 51 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp {{2016-10-14T20:30:00Z}} --value 125 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp {{2016-10-14T20:30:00Z}} --value 235 --unit Milliseconds
```
1. Agregue los datos para la segunda hora, utilizando una marca temporal que sea una hora después de la primera hora.
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp {{2016-10-14T21:30:00Z}} --statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds
```
1. Agregue datos para la tercera hora, omitiendo la marca temporal al valor predeterminado para la hora actual.
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds
```
## Paso 3: Obtenga estadísticas de CloudWatch
Ahora que ha publicado métricas en CloudWatch, puede recuperar las estadísticas basadas en dichas métricas mediante el comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) como se indica a continuación. Asegúrese de especificar `--start-time` y `--end-time` suficientemente lejos en el pasado para cubrir la primera marca temporal que ha publicado.
```
aws cloudwatch get-metric-statistics --namespace GetStarted --metric-name RequestLatency --statistics Average \
--start-time {{2016-10-14T00:00:00Z}} --end-time {{2016-10-15T00:00:00Z}} --period 60
```
A continuación, se muestra un ejemplo de la salida:
```
{
"Datapoints": [],
"Label": "Request:Latency"
}
```
## Paso 4: Visualice gráficos con la consola
Una vez que haya publicado métricas en CloudWatch, puede utilizar la consola de CloudWatch para ver los gráficos estadísticos.
**Para ver gráficos de sus estadísticas en la consola**
1. Abra la consola de CloudWatch en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel **Navigation**, seleccione **Metrics**.
1. En la pestaña **All metrics (Todas las métricas)**, en el campo de búsqueda, escriba **RequestLatency** y pulse Intro.
1. Seleccione la casilla de verificación de la métrica **RequestLatency**. Se muestra un gráfico de los datos de métricas en el panel superior.
Para obtener más información, consulte [Representación gráfica de las métricas](graph_metrics.md).