Da aplicação ao serviço de métricas
O StatsD é um serviço que recebe medidas de aplicações, reúne os valores por intervalo e envia as agregações a um ou mais destinos configurados, como o Graphite. Esse serviço roda em segundo plano como um daemon e pode receber mensagens por UDP ou TCP, conforme a configuração do projeto.
Cada mensagem identifica o nome da métrica, o valor medido e seu tipo. O tipo determina o cálculo: um timer reúne durações para produzir estatísticas, como a média do intervalo. Um gauge registra um valor atual, como o tamanho de uma fila, e o mantém até receber uma atualização. A configuração pode alterar o envio de gauges sem novas medidas.
Uma duração enviada como timer
Neste exemplo didático do protocolo, a aplicação terminou uma importação em 320 milissegundos e envia a seguinte mensagem ao StatsD:
importacao.duracao:320|msO nome é importacao.duracao, o número 320 informa a duração e ms identifica o timer em milissegundos. Ao terminar o intervalo de agregação, o StatsD calcula as estatísticas das durações recebidas e as encaminha ao destino. Você lê a média como um resumo daquele intervalo, sem confundi-la com a duração de cada importação.
A mensagem acima mostra o conteúdo a enviar, sem abrir uma conexão. Para conferir o resultado, acompanhe o recebimento no StatsD e procure a métrica no destino configurado. O gráfico ainda depende de como esse serviço armazena e apresenta as agregações.
Dúvidas frequentes
Perguntas frequentes sobre StatsD
- O StatsD recebe métricas apenas por UDP?
- O projeto também aceita TCP, conforme o servidor configurado. A aplicação precisa enviar as medidas pelo transporte habilitado na instalação.
- Quando usar um gauge no lugar de um timer?
- Use um gauge para um valor atual, como o tamanho de uma fila. Um timer reúne durações e permite calcular estatísticas do intervalo.
- O envio de uma métrica confirma sua chegada ao gráfico?
- O gráfico depende de o StatsD receber a mensagem e encaminhar a agregação ao destino configurado. Confira também o período consultado no painel.
Para continuar
Recursos relacionados
Documentação
StatsD: recebimento e encaminhamento de métricas
Repositório do projeto com o protocolo de envio, a configuração do intervalo de agregação e os serviços de destino suportados.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Sessão ao vivo para investigar a instrumentação da aplicação e acompanhar o envio de métricas até o serviço de destino.
Abrir recursoAplicação na formação
Formação DevOps
A instrumentação de serviços permite acompanhar durações e interpretar as agregações exibidas no monitoramento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.