Instrumentação Linux

Você pode configurar o monitoramento do New Relic para aplicativos de funções do Azure hospedados no Linux. Isso é alcançado instrumentando seu aplicativo de função com o agente New Relic apropriado para seu tempo de execução, como Node.js .NET ou Python. Essa instrumentação permite que você monitore o desempenho e a integridade do seu Azure Functions em tempo real no New Relic.

Pré-requisitos

Garanta que sua Função do Azure atenda à nossa compatibilidade e requisitos.
Vincule sua conta do Azure ao New Relic. Para obter mais informações, consulte integraçãoAzure .

Configurar o monitoramento do Azure Functions

Você pode configurar o monitoramento do Azure Functions para diferentes ambientes e várias combinações de tempos de execução e métodos de implantação:

No diretório raiz do seu projeto do Node.js Azure Function App, instale o agente New Relic como uma dependência do projeto executando:
```
npm i newrelic
```
Para garantir que o agente New Relic seja instalado com a dependência do seu projeto durante o processo de implantação Azure, defina SCM_DO_BUILD_DURING_DEPLOYMENT como true nas configurações do seu aplicativo executando:
```
az functionapp config appsettings set --name {NAME_OF_YOUR_AZURE_FUNCTION_APP} --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
```
Publique seu aplicativo de função do Azure usando a CLI do Azure ou seu método de publicação preferido. Você pode usar um dos seguintes comandos para publicar seu aplicativo de função do Azure:
```
func azure functionapp publish {NAME_OF_YOUR_AZURE_FUNCTION_APP}
```
OU
```
az functionapp app up
```
OU
```
az functionapp deploy
```
Importante
Os comandos mostrados aqui são exemplos e podem exigir parâmetros adicionais com base na sua configuração específica Azure e estratégia de implantação, como OS, Node.js version, Azure resource group, Azure subscription, Azure storage account, Azure region e assim por diante. Consulte a documentação Azure para saber mais sobre esses parâmetros para os métodos func azure functionapp publish, az functionapp up e az functionapp deploy.

No diretório raiz do seu projeto do Python Azure Function App, abra o arquivo requirements.txt.
Adicione a seguinte linha ao seu arquivo requirements.txt para instalar o agente New Relic para instrumentação do Azure Function:
bash
```
$newrelic
```
Inicialize e registre o agente New Relic no seu código de função do Azure usando um dos seguintes métodos:
Abra o arquivo function_app.py no seu projeto.
Para importar o agente New Relic, adicione a seguinte instrução no início do arquivo:
import newrelic.agent
Inicialize o agente New Relic. Para obter mais informações, consulte Inicializar agente Python.
Registre o agente New Relic com sua função do Azure. Para obter mais informações, consulte Registrar agente Python.
Importante
O agente do New Relic usa variáveis de ambiente para nomear seu aplicativo na interface do usuário do New Relic. Certifique-se de que NEW_RELIC_APP_NAME (recomendado) ou WEBSITE_SITE_NAME (variável de nome de site padrão do Azure) esteja disponível como uma variável de ambiente para seu aplicativo de função.
Seu arquivo function_app.py deve se parecer com a seguinte estrutura:
import newrelic.agent import os import azure.functions as func ... newrelic.agent.initialize() app_name = os.environ.get("NEW_RELIC_APP_NAME", \ os.environ.get("WEBSITE_SITE_NAME", None)) newrelic.agent.register_application(app_name) ... # Code here
No diretório raiz do seu projeto do Python Azure Function App, crie um novo arquivo chamado initialization.sh.
Adicione o seguinte conteúdo de script ao arquivo initialization.sh :
bash
$#!/bin/bash $ # initialization.sh $ $ ##################################################################### $ # $ # This one-time use script performs the following tasks: $ # 1. Creates a new function_app.py file with New Relic $ # initialization and registration $ # 2. Moves the original function_app.py file into a directory $ # named "original". $ # 3. Adds the "original" directory to the .funcignore file $ # to prevent duplication in published files. $ # $ ##################################################################### $ $ mkdir original $ mv function_app.py ./original/ $ $ echo -e 'import newrelic.agent\nimport os\n\nnewrelic.agent.initialize()\napp_name = os.environ.get("NEW_RELIC_APP_NAME", os.environ.get("WEBSITE_SITE_NAME", None))\nnewrelic.agent.register_application(app_name)\n' | cat - ./original/function_app.py > function_app.py $ $ echo 'original' >> .funcignore
Salve o arquivo initialization.sh.
Forneça as permissões para o arquivo de script executando:
bash
$chmod 755 initialization.sh
Execute o script a partir do diretório raiz do seu projeto:
bash
$./initialization.sh
Publique seu aplicativo de função do Azure usando a CLI do Azure ou seu método de publicação preferido. Você pode usar o seguinte comando para publicar seu aplicativo de função do Azure:
bash
```
$func azure functionapp publish ${NAME_OF_YOUR_AZURE_FUNCTION_APP}
```

Adicione a versão mais recente do pacote NuGet NewRelic.Agent ao seu projeto de aplicativo.
Use seu mecanismo de publicação preferido para implantar seu aplicativo atualizado no Azure.
Ao implantar seu aplicativo, o agente .NET é instalado na pasta /home/site/wwwroot/newrelic .

Configurar variáveis de ambiente

Depois de publicar o aplicativo Azure Function, configure as variáveis de ambiente:

Navegue até suas Funções Azure no portal Azure .
Em Settings , clique em Environment variables e depois em Advanced edit .

Com base no tempo de execução da sua implantação, cole os seguintes valores:

Importante

Certifique-se de adicionar uma vírgula no final da última linha existente e atualize sua chave de licença na seguinte configuração.

{
  "NODE_OPTIONS": "-r newrelic",
  "NEW_RELIC_LICENSE_KEY": "YOUR-NEW-RELIC-INGEST-LICENSE-KEY",
  "NEW_RELIC_APP_NAME": "NAME-OF-THE-FUNCTION-APP"
}

{
  "NEW_RELIC_LICENSE_KEY": "YOUR-NEW-RELIC-LICENSE-KEY",
  "NEW_RELIC_APP_NAME": "NAME-OF-THE-FUNCTION-APP",
  "PYTHONPATH": "${PYTHONPATH}:/home/site/wwwroot:/home/site/wwwroot/.python_packages/lib/site-packages",
  "FUNCTIONS_WORKER_RUNTIME": "python",
  "PYTHON_ENABLE_WORKER_EXTENSIONS": 1
}

({
  "name": "CORECLR_ENABLE_PROFILING",
  "value": "1",
  "slotSetting": false
},
{
  "name": "CORECLR_NEW_RELIC_HOME",
  "value": "/home/site/wwwroot/newrelic",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER",
  "value": "{36032161-FFC0-4B61-B559-F6C5D41BAE5A}",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER_PATH",
  "value": "/home/site/wwwroot/newrelic/libNewRelicProfiler.so",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LOG_DIRECTORY",
  "value": "/home/LogFiles/NewRelic",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LICENSE_KEY",
  "value": "<your New Relic ingest license key here>",
  "slotSetting": false
})

Reinicie suas funções Azure

Depois de adicionar as variáveis de ambiente, reinicie o Azure Functions para aplicar as alterações.

Encontre e use dados

Depois de configurar sua Azure Function, você pode localizar e usar os dados na interface New Relic.

Acesse https://one.newrelic.com > APM & Services.
No banner de pesquisa, defina os critérios de pesquisa como isAzureFunction = true:
Na lista exibida, selecione sua Função do Azure para visualizar os dados.

Compatibilidade e requisitos

Requisitos para suas Azure Functions

Instrumentação Windows

Aprenda a configurar o Azure Functions para Windows para monitorá-lo no New Relic.

contêiner instrumentação

Aprenda a configurar suas Azure Functions para contêiner para monitorá-las no New Relic.

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos

Configurar o monitoramento do Azure Functions

Importante

Opção 1: Atualizar manualmente o arquivo function_app.py

Importante

Opção 2: Usando o script único fornecido pelo New Relic

Configurar variáveis de ambiente

Importante

Reinicie suas funções Azure

Encontre e use dados

Compatibilidade e requisitos

Instrumentação Windows

contêiner instrumentação

Esta tradução de máquina é fornecida para sua comodidade.

Instrumentação Linux

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar o monitoramento do Azure Functions

Importante

Opção 2: Usando o script único fornecido pelo New Relic

Configurar variáveis de ambiente

Importante

Reinicie suas funções Azure

Encontre e use dados

Artigos relacionados

Compatibilidade e requisitos

Instrumentação Windows

contêiner instrumentação

Pré-requisitos