Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Instrumentando Aplicativos Node.js

Instrumentação automática

A instrumentação automática para Node.js é feita incluindo as bibliotecas Javascript de instrumentação automática com seu aplicativo. Uma ampla gama de bibliotecas e frameworks é suportada.

A instrumentação automática não requer nenhuma modificação do aplicativo. Para configurá-la, siga estas etapas:

  1. Adicione o SDK de instrumentação Open Telemetry ao seu aplicativo:

    npm install --save @opentelemetry/api
npm install --save @opentelemetry/auto-instrumentations-node

  2. Atualize o comando que inicia seu aplicativo para carregar o SDK, seja atualizando o ponto de entrada ou comando da imagem docker ou atualizando o command no manifesto Kubernetes do seu aplicativo. Adicione --require @opentelemetry/auto-instrumentations-node/register:

    node --require @opentelemetry/auto-instrumentations-node/register app.js

  3. Implante seu aplicativo com as variáveis de ambiente extras para configurar o nome do serviço e o endpoint do exportador.

  4. Verifique se SUSE Observability está recebendo rastros e/ou métricas

Para mais detalhes, consulte a documentação do Open Telemetry.

A instrumentação automática configurada via variáveis de ambiente suporta apenas rastros até que este problema do Open Telemetry seja resolvido. Para habilitar métricas a partir da instrumentação automática, são necessárias alterações no código. Por favor, siga as instruções na documentação do Open Telemetry para fazer essas alterações.

Instrumentação manual

A instrumentação manual pode ser usada quando você precisa de métricas, rastros ou logs de partes do código que não são suportadas pela instrumentação automática. Por exemplo, bibliotecas não suportadas, código interno ou métricas de nível de negócios.

Para capturar esses dados, você precisa modificar seu aplicativo.

  1. Inclua o SDK Open Telemetry como uma dependência.

  2. Adicione código ao seu aplicativo para capturar métricas, spans ou logs onde necessário.

Há documentação detalhada sobre isso nas páginas de documentação do SDK Open Telemetry Javascript.

Certifique-se de usar o exportador OTLP e configurar corretamente o endpoint do exportador a partir do código. Veja também a documentação do Open Telemetry. Assumindo que você configurou o exportador conforme documentado, o endpoint que precisa ser configurado é http://opentelemetry-collector.open-telemetry.svc.cluster.local:4317, usando gRPC. Veja também gRPC vs HTTP caso o gRPC apresente problemas.