Monitorando o statsd
Com o Observability do Instana, você pode monitorar de forma abrangente suas aplicações e serviços que utilizam o protocolo StatsD para obter informações sobre seu desempenho e integridade.
Para começar, instale o agente de host do Instana, que atua como um daemon coletor do StatsD e recebe métricas, eliminando a necessidade de implantar outro daemon do StatsD. O agente instala o sensor do StatsD. Você pode visualizar métricas relacionadas às suas aplicações e serviços na interface do usuário do Instana após configurar o sensor conforme descrito na seção “Configuração ”.
Informações de suporte
Para garantir que o sensor StatsD seja compatível com a sua configuração atual, consulte as seguintes seções de informações de suporte:
Sistemas Operacionais com Suporte
Os sistemas operacionais suportados do sensor StatsD são consistentes com os requisitos do agente host. Para obter mais informações, consulte os sistemas operacionais compatíveis na seção Instalação de agentes de host.
Versões compatíveis e política de suporte
A tabela a seguir mostra a versão mais recente compatível e a política de suporte:
| Tecnologia | Política de suporte | Versão com tecnologia de ponta | Versão mais recente suportada |
|---|---|---|---|
| statsd | 45 dias | 0.10.2 | 0.10.2 |
Para obter mais informações sobre a política de suporte, consulte a estratégia de suporte para sensores.
Configurando um sensor d StatsD
Por padrão, o sensor statsd está desativado. Para ativar o sensor, edite o arquivo de configuração <agent_install_dir>/etc/instana/configuration.yaml do agente conforme mostrado no exemplo a seguir:
com.instana.plugin.statsd:
enabled: true
ports:
udp: 8125
mgmt: 8126
bind-ip: "0.0.0.0" # all IPs by default
flush-interval: 10 # in seconds
Para monitorar um conjunto de métricas usando uma expressão regular, configure o sensor StatsD usando a seguinte configuração:
com.instana.plugin.statsd:
metricsRegex: '<OPTIONAL_REGEX_HERE>'
statsd regular, pois isso impede que o agente fique à escuta nessas portas. Execute apenas o agente, que funciona como um statsd servidor.Antes de iniciar
Verifique se a porta UDP está aberta para o sensor Instana StatsD seguindo estas etapas:
- Desativar o sensor StatsD .
- Execute o seguinte comando no host no qual está instalado o agente do Instana com o sensor StatsD ativado:
nc -l -u 8125 - A partir de qualquer outro computador, envie um comando, como:
echo -n "custom.metric.name-test:1|c" | 34.135.37.172 8125 - Verifique a saída do listener que está em execução na porta 8125 A saída é exibida no console do host onde o agente do Instana está instalado.
Se a métrica for exibida na saída do listener, a conexão com StatsD será estabelecida. Caso contrário, a porta UDP não está aberta no host.
Visualizando as métricas
Quando o protocolo padrão StatsD de qualquer biblioteca cliente é usado para enviar dados ao agente Instana por meio do sensor StatsD, o painel do host exibe até 3.000 métricas personalizadas. O agente recebe os dados de métrica no host.
O sensor StatsD pode coletar um máximo de 1.000 métricas para cada tipo de métrica: contadores, medidores e temporizadores.
Para visualizar as métricas, conclua as seguintes etapas:
- No menu de navegação da interface do usuário do Instana, selecione Infraestrutura.
- Clique em um host monitorado.
É possível ver um painel do host com todas as métricas coletadas.. As métricas são enviadas para a porta UDP configurada no formato StatsD através do endereço UDP. Para obter mais informações sobre o formato, consulte StatsD Tipos de medidas.
O sensor aceita as métricas que são enviadas nos formatos StatsD a seguir:
metric name:value:Por exemplo, o script a seguir aumenta um contador chamado
hitsem um:echo "hits:1|c" | nc -u -w0 127.0.0.1 8125\ncomo separador para enviar várias métricas através de UDP para a porta UDP configurada:echo "hits:1|c\nlatency:320|ms\nvisits:333|g\nresponse time:765|s" | nc -u -w0 127.0.0.1 8125#Tags:echo "host.network_receive_errs_total:10|c|#collector:network,device:utun2,host:testmachine" | nc -u -w0 127.0.0.1 8125