Métodos de instalação
Se você estiver executando um aplicativo da Web e implantando como código no Windows, poderá instalar facilmente o agente do Node usando nossa Extensão de Site do Azure. []Veja estas instruções](/docs/agente APM/nodejs-agente/instalação-configuração/install-nodejs-azure-site-extension).
Se você estiver implantando um aplicativo de contêiner, siga nossas instruções para o docker.
Você precisa instalar o agente manualmente para aplicativos web hospedados no Linux, o que descrevemos abaixo.
Instalação manual
Saiba mais sobre considerações especiais para usar os Microsoft Azure Web Apps como um serviço de hospedagem com o agente Node.js da New Relic.
O que você precisa
Além da Compatibilidade e dos requisitos para o agente Node.js, este tutorial pressupõe que você tenha uma instalação funcional do Node.js e do SDK do Windows Azure para Node.js para sua plataforma:
- Instale o SDK do Azure para Node.js.
- Certifique-se de que o Git esteja instalado.
Importante
O agente Node.js não pode fornecer telemetria para Azure Functions. Em vez disso, você precisará usar a integração de monitoramento do Azure Functions
Instalando o agente Node.js
Para adicionar o agente New Relic Node.js ao seu aplicativo Azure, certifique-se de que o módulo newrelic seja carregado primeiro, use o sinalizador -r/--require do Node.js para executar o seguinte:
$node -r newrelic server.jsImportante
Para um aplicativo Next.js, carregue nosso agente via NODE_OPTIONS, como:
$NODE_OPTIONS='-r newrelic' next startAdicionar configurações de aplicativo no Azure
Após a instalação, você deverá configurar seu aplicativo nos Aplicativos Web do Azure:
Faça login em portal.azure.com.
Selecione App Services > (select a Node.js app) > Configure.
Adicione o seguinte ao app settings:
new_relic_app_name: o nome do site do Windows Azurenew_relic_license_key: Sua New Relic
Salve suas configurações.
Reinicie seu aplicativo Node.js.
Gere algum tráfego para seu aplicativo e aguarde alguns minutos. Depois de esperar, veja seus dados acessando one.newrelic.com > All capabilities > APM & services > (select your app).
Opcional: Adicionando configurações de aplicativo com a CLI
Opcional: aqui está um exemplo de como adicionar as configurações do aplicativo usando a CLI (SDK Node.js):
$azure account download "YOUR_SUBSCRIPTION_NAME"$azure account import "PATH_TO_PUBLISH_SETTINGS_FILE"$azure site config add "new_relic_app_name=REPLACE_WITH_YOUR_APP_NAME"$azure site config add "new_relic_license_key=REPLACE_WITH_YOUR_LICENSE_KEY"$azure site restart AZURE_WEB_APP_NAMEUsando variáveis de ambiente
Se o seu agente for executado em ambientes PaaS, como Heroku ou Azure Web Apps, todas as variáveis de configuração em newrelic.js terão equivalentes que podem ser definidas como variáveis de ambiente. Você pode misturar e combinar variáveis livremente no arquivo de configuração. As variáveis de ambiente substituem as configurações do arquivo de configuração.
Por exemplo, para conveniência do usuário do Azure, o agente usará APP_POOL_ID como o nome do aplicativo (NEW_RELIC_APP_NAME) se estiver definido, para que você possa usar o nome escolhido sem defini-lo duas vezes. Para obter mais informações, consulte Configurando o Node.js com variáveis de ambiente.