Cenário: publicar métricas no CloudWatch

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 no Manual do usuário da AWS Command Line Interface.

Etapa 1: definir a configuração dos dados

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

Etapa 2: adicionar métricas ao CloudWatch

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

2. 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

3. 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

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, 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

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/.

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

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

4. 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.