Pular para o conteúdo principal
O OpenTelemetry fornece instrumentação extensiva para muitas bibliotecas e frameworks populares. Durante a instalação do AppSignal e do OpenTelemetry, você pode já ter instalado alguns pacotes de instrumentação, mas pode ser necessário adicionar pacotes de instrumentação adicionais para monitorar bibliotecas específicas que seu aplicativo usa. Este guia explica como identificar, instalar e configurar pacotes adicionais de instrumentação do OpenTelemetry para uma melhor cobertura de observabilidade.

​
Por que adicionar instrumentação adicional?

Seu aplicativo pode usar bibliotecas que não são cobertas pelos pacotes de instrumentação que você instalou durante a configuração, como:
  • Drivers de banco de dados
  • Bibliotecas de cliente HTTP
  • Sistemas de fila de mensagens
  • Bibliotecas personalizadas ou de nicho
Adicionar instrumentação para essas bibliotecas fornece uma configuração de monitoramento mais completa para todos os componentes do seu aplicativo.

​
Etapas gerais

Esta seção descreve as etapas necessárias para a maioria das linguagens para instrumentar uma biblioteca adicional. Verifique a seção Instruções específicas por linguagem para etapas específicas por linguagem.

​
1. Identifique bibliotecas para instrumentar

Primeiro, determine quais bibliotecas seu aplicativo usa que você gostaria de monitorar. Candidatos comuns incluem:
  • Clientes de banco de dados (MySQL, PostgreSQL, MongoDB, Redis)
  • Clientes HTTP
  • Filas de mensagens (RabbitMQ, Kafka, SQS)
  • Mecanismos de template

​
2. Encontre pacotes de instrumentação

Procure pacotes de instrumentação nesta ordem de preferência:
  1. Pacotes oficiais do OpenTelemetry - mantidos pela comunidade OpenTelemetry
  2. Pacotes contrib do OpenTelemetry - instrumentação contribuída pela comunidade
  3. Pacotes de terceiros - certifique-se de confiar no mantenedor e revise o código
Verifique o OpenTelemetry Registry para pacotes de instrumentação disponíveis. Observe que algumas bibliotecas podem incluir a instrumentação do OpenTelemetry por conta própria e nenhuma configuração adicional é necessária.

​
3. Instale o pacote

Depois de encontrar um pacote de instrumentação relevante, instale o pacote de instrumentação usando o gerenciador de pacotes da sua linguagem. Por exemplo: 
go get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp

​
4. Inicialize a instrumentação

Dependendo da linguagem e do método de instrumentação do SDK, os pacotes de instrumentação podem exigir inicialização no código de inicialização do seu aplicativo. Isso normalmente envolve:
  • Importar o pacote de instrumentação
  • Chamar uma função de inicialização
  • Configurar quaisquer opções específicas do pacote
Para algumas linguagens, como PHP e Java usando auto instrumentations, esta etapa não é necessária. Ela configurará automaticamente a instrumentação, a menos que seja instruída o contrário.

​
5. Verifique os dados recebidos

Após a instalação, verifique se a instrumentação está funcionando:
  • Verifique se novos spans sobre a biblioteca instrumentada aparecem em seus traces reportados ao AppSignal.com.
  • Confirme se as métricas sobre a biblioteca instrumentada estão sendo reportadas ao AppSignal.com.
  • Teste cenários de erro para garantir que os erros sejam reportados.

​
Instruções específicas por linguagem

Para instruções detalhadas sobre como adicionar pacotes de instrumentação para linguagens específicas:

​
Solução de problemas

​
Problemas comuns

  • Traces ausentes: certifique-se de que a instrumentação seja inicializada antes que a biblioteca seja usada.
  • Dados incompletos: verifique se o pacote de instrumentação suporta a versão da sua biblioteca.
  • Spans duplicados: evite instrumentar a mesma biblioteca várias vezes.

​
Obtendo ajuda

Se você encontrar problemas:
  1. Verifique a documentação do pacote de instrumentação
  2. Entre em contato com o suporte AppSignal para obter assistência