Integrar el agente de Python en las aplicaciones contenedoras Microsoft Azure y App Service

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

Este documento proporciona soluciones para la integración de New Relic en la aplicación Python alojada en Azure sin tener que modificar el código de la aplicación. Hay dos instancias admitidas de esta capacidad:

Aplicaciones de Azure Container
Servicio de aplicaciones Microsoft Azure, mediante código

El soporte para la integración de New Relic para App Services mediante imágenes en contenedores no está disponible.

Compatibilidad y requisitos

Antes de comenzar, te recomendamos lo siguiente:

Comenzando con una App contenedora o App Service que se implementó
Instalación de la CLI de Azure en su entorno si no emplea el Portal de Azure

Información

Tenga en cuenta que el agente de Python no captura telemetría para Azure Functions sin nuestra integración. Recomendamos instalar la integración de monitoreoAzure Functions si desea recopilar datos sobre Azure Functions.

Integrar el agente Python en las aplicaciones de contenedor

En ciertos casos, una aplicación gestionada a través de Azure Contenedor Apps ya tiene una imagen que el usuario no puede modificar (o el usuario simplemente puede no querer modificar la aplicación). Esto proporciona una manera de integrar New Relic en el entorno sin tener que realizar ninguna modificación en el código que crea la imagen en contenedor.

Esto se puede hacer a través del Portal de Azure o la CLI de Azure.

Agregar New Relic clave de licencia

Este paso es opcional pero muy recomendable.

Si no se creó Azure Key Vault , siga esta guía de inicio rápido.

Seleccione Container Apps > (select a Python app) > Settings > Secrets.
Agrega un secreto. Dale un nombre al secreto, selecciona "Referencia de Key Vault" y agrega tu clave de licencia.
Guarde sus cambios.

Vincular un recurso compartido de archivos de Azure a una aplicación de contenedor

Cree un recurso compartido de archivos de Azure siguiendo este tutorial de inicio rápido.

Seleccione Container Apps > (select a Python app) > Application > Containers.
Seleccione “Editar y desplegar”
Vaya a la pestaña "Volúmenes" y haga clic en "(+) Agregar"
Seleccione "Volumen de archivo de Azure", complete el nombre del volumen deseado y seleccione el recurso compartido de archivos creado anteriormente.
Guarde sus cambios.

Agregar y configurar el contenedor init

Seleccione Container Apps > (select a Python app) > Application > Containers.
En la sección “imagen del contenedor”, haga clic en “Agregar” y seleccione “Iniciar contenedor”
Introduzca lo siguiente:
- Nombre del contenedor de inicio deseado
- Docker Hub u otros registros" para "Fuente de la imagen"
- newrelic/newrelic-python-init en "Imagen y etiqueta"
- /bin/sh para "Anular comando"
- -c, cp -r /instrumentation /mnt/ para "Los argumentos prevalecen"
- Núcleos de CPU y memoria deseados. Este no debe exceder el del contenedor primario.
Vaya a la pestaña "Montajes de volumen" y seleccione el montaje de volumen creado en los pasos anteriores. La ruta de montaje debe ser /mnt/instrumentation.
Guarde sus cambios.

Vincular New Relic a la aplicación principal

Seleccione Container Apps > (select a Python app) > Application > Containers.
En la sección "Imagen del contenedor", seleccione la aplicación principal y haga clic en "Editar"
Vaya a la pestaña "Variables de entorno" e ingrese lo siguiente:
- NEW_RELIC_APP_NAME: [nombre de la aplicación deseada]
- PYTHONPATH: /mnt/instrumentation
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
- NEW_RELIC_LICENSE_KEY > Hacer referencia a un secreto > seleccione el nombre del secreto del Paso 1 (o ingrese manualmente la clave de licencia)
Vaya a la pestaña "Montajes de volumen" y seleccione el montaje de volumen creado en el Paso 2. La ruta de montaje debe ser /mnt/instrumentation.
Guarde sus cambios.

Esto debería volver a desplegar la aplicación contenedor. Espere unos minutos hasta que el contenedor de inicio termine de ejecutar.

Agregar clave de licencia de New Relic a Azure Key Vault

Este paso es opcional pero muy recomendable.

Si no se creó Azure Key Vault , siga este tutorial de inicio rápido.

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

Cree un recurso compartido de archivos de Azure y vincúlelo a una aplicación de contenedor

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

Agregar variables de entorno

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

Vincular New Relic a la aplicación principal

Exportar la configuración de la aplicación contenedor

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

Este archivo producirá un archivo de plantilla parcial que contiene información sobre la aplicación contenedor. Será necesario agregar información adicional para vincular New Relic a la aplicación.

Montar volumen en la aplicación contenedor

En propiedades > plantilla, habrá una sección llamada volumes. En este momento, esto dice volumes: null. Reemplazaremos esa línea con estas líneas:

bash

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

Donde $STORAGE_MOUNT_NAME es lo que se empleó en el Paso 2 y $VOLUME_NAME es un nombre de su elección

Agregar contenedor de inicialización

En propiedades > plantilla, habrá una sección llamada initContainers. En este momento, esto dice initContainers: null. Reemplazaremos esa línea con estas líneas:

bash

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

Vincular volumen a contenedor

En propiedades > plantilla, ahora tenemos secciones containers y initContainers . Dentro de cada una de estas secciones, agregue las siguientes líneas:

bash

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

Donde $VOLUME_NAME es el nombre elegido anteriormente

Actualizar la aplicación contenedor con nueva configuración

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

Esto debería volver a desplegar la aplicación contenedor. Espere unos minutos hasta que el contenedor de inicio termine de ejecutar.

Integrar el agente de Python en Azure App Service

Actualmente, App Services solo admite sidecars pero no contenedores de inicio. Hasta que ese soporte esté disponible, se puede emplear este script preconstruido. Nota: Esto solo funciona para App Services que usan código y no para imágenes en contenedores.

Esto se puede hacer a través del Portal de Azure o la CLI de 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

Subir script de inicio

Vaya a https://[NOMBRE_DE_SU_SITIO_WEBSITE_LINUX_AZURE].scm.azurewebsites.net/newui/fileManager y cargue el script prebuild.sh en el directorio /home

Agregar las variables de entorno necesarias

Seleccione App Services > (select a Python app) > Settings > Environment variables.
Agregue lo siguiente al App settings:
- NEW_RELIC_APP_NAME:El nombre de su sitio web de Linux Azure
- NEW_RELIC_LICENSE_KEY: Tu New Relic
- PYTHONPATH: /home:/home/workspace/newrelic
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
Guarde su configuración.
Si se desea una versión específica del agente, agregue la variable de entorno AGENT_VERSION con el número de versión, precedido por v (por ejemplo, v10.0.0).

Agregar `prebuild.sh` como configuración de archivo de inicio

Seleccione App Services > (select a Python app) > Settings > Configuration.
Agrega lo siguiente a Startup Command: /home/prebuild.sh
Almacene su configuración. Esto debería volver a implementar la aplicación.
Esto tomará unos minutos.

Subir script de inicio

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

Agregar las variables de entorno necesarias

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 se desea una versión específica del agente, agregue la variable de entorno AGENT_VERSION con el número de versión, precedido por v (por ejemplo, v10.0.0) como se muestra en el siguiente ejemplo:

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

Agregar `prebuild.sh` como configuración de archivo de inicio

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

Esto tomará unos minutos.

Resolución de problemas

En algunos casos, la telemetría puede no estar disponible, o que el script prebuild.sh pueda provocar que la aplicación existente no pueda volver a desplegar. Para solucionar esto, habilite estas variables de entorno:

SCM_DO_BUILD_DURING_DEVELOPMENT: True
ENABLE_ORYX_BUILD: True

Te ofrecemos esta traducción automática para facilitar la lectura.

Integrar el agente de Python en las aplicaciones contenedoras Microsoft Azure y App Service

avance

Compatibilidad y requisitos

Información

Integrar el agente Python en las aplicaciones de contenedor

Integre el agente Python de New Relic en una aplicación de contenedor a través del portal de Azure

Agregar New Relic clave de licencia

Vincular un recurso compartido de archivos de Azure a una aplicación de contenedor

Agregar y configurar el contenedor init

Vincular New Relic a la aplicación principal

Integrar el agente Python de New Relic en una aplicación de contenedor a través de la CLI de Azure

Agregar clave de licencia de New Relic a Azure Key Vault

Cree un recurso compartido de archivos de Azure y vincúlelo a una aplicación de contenedor

Agregar variables de entorno

Vincular New Relic a la aplicación principal

Exportar la configuración de la aplicación contenedor

Montar volumen en la aplicación contenedor

Agregar contenedor de inicialización

Vincular volumen a contenedor

Actualizar la aplicación contenedor con nueva configuración

Integrar el agente de Python en Azure App Service

Integración del agente Python de New Relic en App Services a través del portal de Azure

Subir script de inicio

Agregar las variables de entorno necesarias

Agregar `prebuild.sh` como configuración de archivo de inicio

Integración del agente Python de New Relic en App Services a través de la CLI de Azure

Subir script de inicio

Agregar las variables de entorno necesarias

Agregar `prebuild.sh` como configuración de archivo de inicio

Resolución de problemas

Te ofrecemos esta traducción automática para facilitar la lectura.

Integrar el agente de Python en las aplicaciones contenedoras Microsoft Azure y App Service

avance

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

Información

Integrar el agente Python en las aplicaciones de contenedor

Integrar el agente Python de New Relic en una aplicación de contenedor a través de la CLI de Azure

Integrar el agente de Python en Azure App Service

Integración del agente Python de New Relic en App Services a través del portal de Azure

Integración del agente Python de New Relic en App Services a través de la CLI de Azure

Resolución de problemas

Compatibilidad y requisitos