Intégrer l'agent Python sur Microsoft Azure Container Apps et App Service

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Ce document fournit des solutions sur New Relic l’intégration dans Azure Python l’application hébergée par sans avoir à modifier le application code . Il existe deux instances prises en charge de cette fonctionnalité :

Applications conteneurisées Azure
Microsoft Azure App Service, à l'aide du code

La prise en charge de l'intégration New Relic pour App Services utilisant des images conteneurisées n'est pas disponible.

Compatibilité et exigences

Avant de commencer, nous vous recommandons ce qui suit :

Démarrer avec une application conteneur ou un service d'application qui a été déployé
Installation de l' interface de ligne de commande Azure dans votre environnement si vous n'utilisez pas le portail Azure

Informations

Gardez à l’esprit que l’agent Python ne capture pas la télémétrie pour Azure Functions sans notre intégration. Nous vous recommandons d’installer l’ intégration du monitoring Azure Functions si vous souhaitez collecter des données sur Azure Functions.

Intégrer l' sur Python agent les applications conteneurisées

Dans certains cas, une application gérée via Azure Container Apps possède déjà une image qui ne peut pas être modifiée par l'utilisateur (ou l'utilisateur peut simplement ne pas vouloir modifier l'application). Cela permet d’intégrer New Relic dans l’environnement sans avoir à apporter de modifications au code qui crée l’image conteneurisée.

Cela peut être effectué via le portail Azure ou l’interface de ligne de commande Azure.

Ajouter New Relic

Cette étape est facultative mais fortement recommandée.

Si Azure Key Vault n’a pas été créé, suivez ce guide quickstart .

Sélectionnez Container Apps > (select a Python app) > Settings > Secrets.
Ajoutez un secret. Donnez un nom au secret, sélectionnez « Référence Key Vault » et ajoutez votre clé de licence
Enregistrez vos modifications.

Associer le partage de fichiers Azure à l'application conteneur

Créez un partage de fichiersAzure en suivant ce didacticiel quickstart .

Sélectionnez Container Apps > (select a Python app) > Application > Containers.
Sélectionnez « Modifier et déployer »
Accédez à l'onglet « Volumes » et cliquez sur « (+) Ajouter »
Sélectionnez « Volume de fichiers Azure », indiquez le nom du volume souhaité et sélectionnez le partage de fichiers créé précédemment.
Enregistrez vos modifications.

Ajouter et configurer le conteneur d'initialisation

Sélectionnez Container Apps > (select a Python app) > Application > Containers.
Sous la section « image du conteneur », cliquez sur « Ajouter » et sélectionnez « Init conteneur »
Saisissez les informations suivantes :
- Nom du conteneur d'initialisation souhaité
- « Docker Hub ou autres registres » pour « Source de l'image »
- newrelic/newrelic-python-init sous "Image et tag"
- /bin/sh pour « Commande de remplacement »
- -c, cp -r /instrumentation /mnt/ pour « Les arguments remplacent »
- Cœurs de processeur et mémoire souhaités. Celle-ci ne doit pas dépasser celle du conteneur primaire.
Accédez à l’onglet « Montages de volume » et sélectionnez le montage de volume créé aux étapes précédentes. Le chemin de montage doit être /mnt/instrumentation.
Enregistrez vos modifications.

Associer New Relic à l'application principale

Sélectionnez Container Apps > (select a Python app) > Application > Containers.
Dans la section « Image du conteneur », sélectionnez l'application principale et cliquez sur « Modifier »
Accédez à l’onglet « Variables d’environnement » et saisissez les éléments suivants :
- NEW_RELIC_APP_NAME: [desired app name]
- PYTHONPATH: /mnt/instrumentation
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
- NEW_RELIC_LICENSE_KEY > Référencer un secret > sélectionnez le nom du secret à l'étape 1 (ou saisissez manuellement la clé de licence)
Accédez à l'onglet « Montages de volume » et sélectionnez le montage de volume créé à l'étape 2. Le chemin de montage doit être /mnt/instrumentation.
Enregistrez vos modifications.

Cela devrait redéployer l'application conteneur. Attendez quelques minutes que le conteneur d’initialisation termine son exécution.

Ajouter une clé de licence New Relic à Azure Key Vault

Cette étape est facultative mais fortement recommandée.

Si Azure Key Vault n’a pas été créé, suivez ce didacticiel quickstart .

az containerapp secret set --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --secrets license-key=$NEW_RELIC_LICENSE_KEY

Créer un partage de fichiers Azure et un lien vers l'application conteneur

az storage account create --resource-group $RESOURCE_GROUP --name $STORAGE_ACCOUNT_NAME --location $LOCATION --kind StorageV2 --sku Standard_LRS --enable-large-file-share
az storage share-rm create --resource-group $RESOURCE_GROUP --storage-account $STORAGE_ACCOUNT_NAME --name $STORAGE_SHARE_NAME --quota 4096 --enabled-protocols SMB
STORAGE_ACCOUNT_KEY=`az storage account keys list -n $STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv --resource-group $RESOURCE_GROUP`
az containerapp env storage set --access-mode ReadWrite --azure-file-account-name $STORAGE_ACCOUNT_NAME --azure-file-account-key $STORAGE_ACCOUNT_KEY --azure-file-share-name $STORAGE_SHARE_NAME --storage-name $STORAGE_MOUNT_NAME --name $ENVIRONMENT_NAME --resource-group $RESOURCE_GROUP

Ajouter des variables d’environnement

az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --set-env-vars "NEW_RELIC_APP_NAME=$NEW_RELIC_APP_NAME" "NEW_RELIC_AZURE_OPERATOR_ENABLED=True" "NEW_RELIC_LICENSE_KEY=secretref:license-key" "PYTHONPATH="/mnt/instrumentation

Associer New Relic à l'application principale

Exporter la configuration de l'application conteneur

az containerapp show --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --output yaml > demoapp.yaml

Ce fichier produira un fichier de modèle partiel contenant des informations sur l'application conteneur. Des informations supplémentaires devront être ajoutées pour lier New Relic à l'application.

Monter le volume sur l'application conteneur

Dans les propriétés > modèle, il y aura une section appelée volumes. En ce moment, cela indique volumes: null. Nous remplacerons cette ligne par ces lignes :

bash

$volumes:
$- name: $VOLUME_NAME
$    storageName: $STORAGE_MOUNT_NAME
$    storageType: AzureFile

Où $STORAGE_MOUNT_NAME est ce qui a été utilisé à l'étape 2 et $VOLUME_NAME est un nom de votre choix

Ajouter un conteneur d'initialisation

Dans les propriétés > modèle, il y aura une section appelée initContainers. En ce moment, cela indique initContainers: null. Nous remplacerons cette ligne par ces lignes :

bash

$initContainers:
$- args:
$    - -c
$    - cp -r /instrumentation /mnt/
$    command:
$    - /bin/sh
$    image: docker.io/newrelic/newrelic-python-init
$    name: nr-init-container

Lier le volume au conteneur

Dans les propriétés > modèle, nous avons maintenant les sections containers et initContainers . Dans chacune de ces sections, ajoutez les lignes suivantes :

bash

$volumeMounts:
$- mountPath: /mnt/instrumentation
$    volumeName: $VOLUME_NAME

Où $VOLUME_NAME est le nom choisi précédemment

Mettre à jour l'application conteneur avec la nouvelle configuration

az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --yaml demoapp.yaml

Cela devrait redéployer l'application conteneur. Attendez quelques minutes que le conteneur d’initialisation termine son exécution.

Intégrer l'agent Python sur Azure App Service

Actuellement, App Services ne prend en charge que les side-cars mais pas le conteneur d'initialisation. En attendant que ce support soit disponible, ce script pré-buildé peut être utilisé. Remarque : cela ne fonctionne que pour les services d’application utilisant du code et non pour les images conteneurisées.

Cela peut être fait via le portail Azure ou l'interface de ligne de commande Azure :

bash

$#!/bin/sh
$# prebuild.sh
$
$# Retrieve files to use in startup script:
$curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/newrelic_k8s_operator.py > newrelic_k8s_operator.py
$curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-vendor.txt > requirements-vendor.txt
$curl -L https://raw.githubusercontent.com/newrelic/newrelic-agent-init-container/refs/heads/main/src/python/requirements-builder.txt > requirements-builder.txt
$
$cd /home/
$
$pip install -r requirements-builder.txt
$
$export NEW_RELIC_EXTENSIONS=false
$export WRAPT_DISABLE_EXTENSIONS=true
$
$pip install newrelic --target=./workspace/newrelic
$
$mkdir -p ./workspace/vendor
$pip install --target=./workspace/vendor -r requirements-vendor.txt
$
$cp ./workspace/* /home/
$cp /home/workspace/newrelic/newrelic/bootstrap/sitecustomize.py /home/sitecustomize.py
$
$cd /home/site/wwwroot
$
$# This is the where the application's original startup script goes:
$gunicorn app:app

Télécharger le script de démarrage

Accédez à https\://[VOTRE_NOM_DE_SITE_WEB_AZURE_LINUX].scm.azurewebsites.net/newui/fileManager et téléchargez le script prebuild.sh dans le répertoire /home

Ajouter les variables d’environnement nécessaires

Sélectionnez App Services > (select a Python app) > Settings > Environment variables.
Ajoutez ce qui suit au App settings:
- NEW_RELIC_APP_NAME: Le nom de votre site Web Linux Azure
- NEW_RELIC_LICENSE_KEY: Votre New Relic
- PYTHONPATH: /home:/home/workspace/newrelic
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
Enregistrez vos paramètres.
Si une version d'agent spécifique est souhaitée, ajoutez la variable d'environnement AGENT_VERSION avec le numéro de version, précédé de v (par exemple v10.0.0).

Ajoutez `prebuild.sh` comme paramètre de fichier de démarrage

Sélectionnez App Services > (select a Python app) > Settings > Configuration.
Ajoutez ce qui suit à Startup Command: /home/prebuild.sh
Enregistrez vos paramètres. Cela devrait redéployer l'application.
Cela prendra quelques minutes.

Télécharger le script de démarrage

az webapp deploy --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --src-path prebuild.sh --target-path /home/prebuild.sh --type=static

Ajouter les variables d’environnement nécessaires

az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings NEW_RELIC_LICENSE_KEY=$NEW_RELIC_LICENSE_KEY NEW_RELIC_AZURE_OPERATOR_ENABLED=true NEW_RELIC_APP_NAME="Azure Service App" PYTHONPATH="/home:/home/workspace/newrelic"

Si une version d'agent spécifique est souhaitée, ajoutez la variable d'environnement AGENT_VERSION avec le numéro de version, précédé de v (par exemple v10.0.0) comme indiqué dans l’exemple ci-dessous :

az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings AGENT_VERSION=v10.0.0

Ajoutez `prebuild.sh` comme paramètre de fichier de démarrage

az webapp config set --resource-group ${RESOURCE_GROUP} --name ${WEB_APP_NAME} --startup-file "/home/prebuild.sh"

Cela prendra quelques minutes.

Dépannage

Dans certains cas, la télémétrie peut ne pas être disponible, ou bien le script prebuild.sh peut provoquer l'échec du redéploiement de application existante. Pour remédier à cela, activez ces variables d’environnement :

SCM_DO_BUILD_DURING_DEVELOPMENT: True
ENABLE_ORYX_BUILD: True

Cette traduction automatique est fournie pour votre commodité.

Intégrer l'agent Python sur Microsoft Azure Container Apps et App Service

Aperçu

Compatibilité et exigences

Informations

Intégrer l' sur Python agent les applications conteneurisées

Intégrer l'agent Python New Relic dans une application conteneur via le portail Azure

Ajouter New Relic

Associer le partage de fichiers Azure à l'application conteneur

Ajouter et configurer le conteneur d'initialisation

Associer New Relic à l'application principale

Intégrer l'agent Python New Relic dans une application conteneur via Azure CLI

Ajouter une clé de licence New Relic à Azure Key Vault

Créer un partage de fichiers Azure et un lien vers l'application conteneur

Ajouter des variables d’environnement

Associer New Relic à l'application principale

Exporter la configuration de l'application conteneur

Monter le volume sur l'application conteneur

Ajouter un conteneur d'initialisation

Lier le volume au conteneur

Mettre à jour l'application conteneur avec la nouvelle configuration

Intégrer l'agent Python sur Azure App Service

Intégrer l'agent Python New Relic dans App Services via le portail Azure

Télécharger le script de démarrage

Ajouter les variables d’environnement nécessaires

Ajoutez `prebuild.sh` comme paramètre de fichier de démarrage

Intégrer l'agent Python New Relic dans App Services via Azure CLI

Télécharger le script de démarrage

Ajouter les variables d’environnement nécessaires

Ajoutez `prebuild.sh` comme paramètre de fichier de démarrage

Dépannage

Cette traduction automatique est fournie pour votre commodité.

Intégrer l'agent Python sur Microsoft Azure Container Apps et App Service

Aperçu

Compatibilité et exigences .css-21sua1{background:none;border:none;width:0;padding:0;}

Informations

Intégrer l' sur Python agent les applications conteneurisées

Intégrer l'agent Python New Relic dans une application conteneur via Azure CLI

Intégrer l'agent Python sur Azure App Service

Intégrer l'agent Python New Relic dans App Services via le portail Azure

Intégrer l'agent Python New Relic dans App Services via Azure CLI

Dépannage

Compatibilité et exigences