# Cenário: publicar métricas no CloudWatch
<a name="PublishMetrics"></a>

Neste cenário, você usa a AWS Command Line Interface (AWS CLI) para publicar uma única métrica de um aplicativo hipotético chamado *GetStarted*. Se você ainda não tiver instalado e configurado a AWS CLI, consulte [Configurar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) no *Manual do usuário da AWS Command Line Interface*.

**Topics**
+ [Etapa 1: definir a configuração dos dados](#define-data-domain)
+ [Etapa 2: adicionar métricas ao CloudWatch](#add-metrics-to-scenario)
+ [Etapa 3: obter estatísticas do CloudWatch](#GetStatistics)
+ [Etapa 4: visualizar gráficos com o console](#ViewGraphs)

## Etapa 1: definir a configuração dos dados
<a name="define-data-domain"></a>

Neste cenário, você publica pontos de dados que rastreiam a latência de solicitação do aplicativo. Escolha nomes para sua métrica e namespace que façam sentido para você. Para este exemplo, dê à métrica o nome *RequestLatency* e coloque todos os pontos de dados no namespace *GetStarted*. 

Você publica diversos pontos de dados que, coletivamente, representam três horas de dados de latência. Os dados brutos compreendem 15 leituras de latência de solicitação distribuídas ao longo de três horas. Cada leitura é feita em milissegundos: 
+ Primeira hora: 87, 51, 125, 235
+ Segunda hora: 121, 113, 189, 65, 89
+ Terceira hora: 100, 47, 133, 98, 100, 328

Você pode publicar dados no CloudWatch como pontos de dados únicos ou como um conjunto agregado de pontos de dados denominado *conjunto de estatísticas*. Você pode agregar métricas para uma granularidade de até um minuto. É possível publicar os pontos de dados agregados no CloudWatch como um conjunto de estatísticas com quatro chaves predefinidas: `Sum` `Minimum`, `Maximum` e `SampleCount`.

Você publica os pontos de dados da primeira hora como pontos de dados únicos. Para os dados da segunda e terceira horas, você agrega os pontos de dados e publica um conjunto de estatísticas para cada hora. Os principais valores são mostrados na tabela a seguir.


| Hora | Dados brutos | Soma | 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` | 

## Etapa 2: adicionar métricas ao CloudWatch
<a name="add-metrics-to-scenario"></a>

Depois de definir a configuração de dados, você estará pronto para adicionar dados.

**Para publicar pontos de dados no CloudWatch**

1. Em um prompt de comando, execute os seguintes comandos [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html) para adicionar dados para a primeira hora. Substitua o time stamp de exemplo por um time stamp que seja duas horas no passado, em Universal Coordinated Time (UTC – Tempo universal coordenado).

   ```
   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. Adicione dados para a segunda hora usando um time stamp que seja uma hora posterior à primeira 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. Adicione dados para a terceira hora omitindo o time stamp para o padrão à hora atual. 

   ```
   aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
   --statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds
   ```

## Etapa 3: obter estatísticas do CloudWatch
<a name="GetStatistics"></a>

Agora que você publicou métricas no CloudWatch, pode recuperar as estatísticas de acordo com as métricas usando o comando [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html), como se segue. Especifique `--start-time` e `--end-time` o suficiente no passado para cobrir o primeiro time stamp 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 seguir está um exemplo de saída:

```
{
	"Datapoints": [],
	"Label": "Request:Latency"
}
```

## Etapa 4: visualizar gráficos com o console
<a name="ViewGraphs"></a>

Depois de publicar métricas no CloudWatch, você pode usar o console do CloudWatch para visualizar gráficos estatísticos.

**Para visualizar gráficos de estatísticas no console**

1. Abra o console do CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de **navegação**, selecione **Métricas**.

1. Na guia **All metrics (Todas as métricas)**, na caixa de pesquisa, digite **RequestLatency** e pressione Enter.

1. Marque a caixa de seleção da métrica **RequestLatency**. Um gráfico dos dados de métrica é exibido no painel superior.

Para obter mais informações, consulte [Criar gráficos de métricas](graph_metrics.md).