Instrumentation Linux

Vous pouvez configurer monitoring New Relic pour les applications Azure Function hébergées sur Linux. Ceci est réalisé en instrumentant votre application de fonction avec l'agent New Relic approprié pour son exécution tel que Node.js, .NET ou Python. Cette instrumentation vous permet de monitorer les performances et la santé de vos Azure Functions en temps réel dans New Relic.

Prérequis

Assurez-vous que votre Azure Function répond à nos exigences de compatibilité.
Liez votre compte Azure à New Relic. Pour plus d’informations, consultez l’intégration Azure.

Configurer Azure Functions monitoring

Vous pouvez configurer Azure Functions monitoring pour différents environnements et diverses combinaisons d'environnements d'exécution et de méthodes de déploiement :

Dans le répertoire racine de votre projet Node.js Azure Function App, installez l'agent New Relic en tant que dépendance de projet en exécutant :
```
npm i newrelic
```
Pour vous assurer que l'agent New Relic est installé avec la dépendance de votre projet pendant le processus de déploiement Azure, définissez SCM_DO_BUILD_DURING_DEPLOYMENT sur true dans les paramètres de votre application en exécutant :
```
az functionapp config appsettings set --name {NAME_OF_YOUR_AZURE_FUNCTION_APP} --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true
```
Publiez votre application Azure Function à l’aide de l’interface de ligne de commande Azure ou de votre méthode de publication préférée. Vous pouvez utiliser l’une des commandes suivantes pour publier votre application Azure Function :
```
func azure functionapp publish {NAME_OF_YOUR_AZURE_FUNCTION_APP}
```
OU
```
az functionapp app up
```
OU
```
az functionapp deploy
```
Important
Les commandes présentées ici sont des exemples et peuvent nécessiter des paramètres supplémentaires en fonction de votre configuration Azure spécifique et de votre stratégie de déploiement, tels que OS, Node.js version, Azure resource group, Azure subscription, Azure storage account, Azure region, etc. Consultez la documentation Azure pour en savoir plus sur ces paramètres pour les méthodes func azure functionapp publish, az functionapp up et az functionapp deploy.

Dans le répertoire racine de votre projet Python Azure Function App, ouvrez le fichier requirements.txt.
Ajoutez la ligne suivante à votre fichier requirements.txt pour installer l'agent New Relic pour l'instrumentation Azure Function :
bash
```
$newrelic
```
Initialisez et enregistrez l’agent New Relic dans votre code Azure Function à l’aide de l’une des méthodes suivantes :
Ouvrez votre fichier function_app.py dans votre projet.
Pour importer l'agent New Relic, ajoutez l'instruction suivante en haut du fichier :
import newrelic.agent
Initialisez l'agent New Relic. Pour plus d'informations, reportez-vous à Initialiser l'agent Python.
Enregistrez l’agent New Relic auprès de votre Azure Function. Pour plus d'informations, reportez-vous à Enregistrer l'agent Python.
Important
L'agent New Relic utilise des variables d'environnement pour nommer votre application dans l'interface utilisateur de New Relic. Assurez-vous que NEW_RELIC_APP_NAME (recommandé) ou WEBSITE_SITE_NAME (variable de nom de site par défaut d’Azure) est disponible en tant que variable d’environnement pour votre application de fonction.
Votre fichier function_app.py doit ressembler à la structure suivante :
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
Dans le répertoire racine de votre projet Python Azure Function App, créez un nouveau fichier nommé initialization.sh.
Ajoutez le contenu de script suivant au fichier 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
Enregistrez le fichier initialization.sh.
Fournissez les autorisations au fichier de script en exécutant :
bash
$chmod 755 initialization.sh
Exécutez le script depuis le répertoire racine de votre projet :
bash
$./initialization.sh
Publiez votre application Azure Function à l’aide de l’interface de ligne de commande Azure ou de votre méthode de publication préférée. Vous pouvez utiliser la commande suivante pour publier votre application Azure Function :
bash
```
$func azure functionapp publish ${NAME_OF_YOUR_AZURE_FUNCTION_APP}
```

Ajoutez la dernière version du package NuGet NewRelic.Agent à votre projet d’application.
Utilisez votre mécanisme de publication préféré pour déployer votre application mise à jour sur Azure.
Lorsque vous déployez votre application, l'agent .NET est installé dans le dossier /home/site/wwwroot/newrelic .

Configurer les variables d’environnement

Après avoir publié l’application Azure Function, configurez les variables d’environnement:

Accédez à votre Azure Function dans le portail Azure .
Sous Settings , cliquez sur Environment variables , puis sur Advanced edit .

En fonction de votre environnement d’exécution de déploiement, collez les valeurs suivantes :

Important

Assurez-vous d'ajouter une virgule à la fin de la dernière ligne existante et de mettre à jour votre clé de licence dans la configuration suivante.

{
  "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
})

Redémarrez votre Azure Function

Après avoir ajouté les variables d’environnement, redémarrez votre Azure Function pour appliquer les modifications.

Rechercher et utiliser des données

Après avoir configuré votre Azure Function, vous pouvez rechercher et utiliser les données dans l’interface utilisateur de New Relic.

Accédez à https://one.newrelic.com > APM & Services.
Dans la bannière de recherche, définissez les critères de recherche sur isAzureFunction = true:
Dans la liste affichée, sélectionnez votre Azure Function pour afficher les données.

Compatibilité et exigences

Exigences pour vos Azure Functions

Instrumentation Windows

Découvrez comment configurer vos Azure Functions pour Windows afin de les monitorer dans New Relic.

instrumentation de conteneur

Découvrez comment configurer vos Azure Functions pour les monitorer dans New Relic.

Cette traduction automatique est fournie pour votre commodité.

Prérequis

Configurer Azure Functions monitoring

Important

Option 1 : mettre à jour manuellement le fichier function_app.py

Important

Option 2 : Utilisation du script unique fourni par New Relic

Configurer les variables d’environnement

Important

Redémarrez votre Azure Function

Rechercher et utiliser des données

Compatibilité et exigences

Instrumentation Windows

instrumentation de conteneur

Cette traduction automatique est fournie pour votre commodité.

Instrumentation Linux

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

Configurer Azure Functions monitoring

Important

Option 2 : Utilisation du script unique fourni par New Relic

Configurer les variables d’environnement

Important

Redémarrez votre Azure Function

Rechercher et utiliser des données

Articles connexes

Compatibilité et exigences

Instrumentation Windows

instrumentation de conteneur

Prérequis