Pular para o conteúdo principal
Certifique-se de instalar o AppSignal collector antes de prosseguir com estas instruções.

Instale os pacotes do OpenTelemetry

Use o npm para adicionar o SDK do OpenTelemetry e o exporter OTLP às dependências da sua aplicação:
O pacote @opentelemetry/auto-instrumentations-node instrumentará automaticamente a maioria das aplicações e bibliotecas. Confira o README do pacote para uma lista de bibliotecas e frameworks que ele instrumenta. Você pode encontrar instrumentações adicionais para bibliotecas e frameworks no Registro do OpenTelemetry.

Configure o OpenTelemetry na sua aplicação

Adicione este arquivo opentelemetry.cjs à sua aplicação com o exporter do OpenTelemetry e a configuração do AppSignal. Certifique-se de atualizar os valores abaixo com o nome da sua aplicação no AppSignal, ambiente e push API key, e de substituir o endpoint do exporter pelo endereço do seu AppSignal collector se necessário.

Inicie sua aplicação com o OpenTelemetry

Para rodar sua aplicação com o OpenTelemetry, você precisa usar a flag --require para carregar o arquivo opentelemetry.cjs antes de iniciar sua aplicação:
Atualize seu arquivo package.json para adicionar --require ao comando que inicia seu app.
Você também pode usar a flag --require com ferramentas como ts-node e nodemon. Ao usar uma CLI wrapper, como nest start ou fastify start, para iniciar sua aplicação, use a variável de ambiente NODE_OPTIONS para passar a flag ao runtime do Node.js:

Teste o app!

Agora que todos os componentes estão conectados, inicie seu app com os argumentos de linha de comando necessários e teste se você vê os dados chegando no AppSignal. Verifique especificamente as páginas “Errors > Issue list” e “Performance > Traces”. Se, depois de seguir nossas instruções de instalação, você ainda não vir dados no AppSignal, avise-nos e te ajudaremos a finalizar a instalação do OpenTelemetry!