Integrar o agente Python no Microsoft Azure contêiner Apps e App Service

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

Este documento fornece soluções sobre a integração New Relic ao aplicativo Python hospedado no Azure sem precisar modificar o código do aplicativo. Há duas instâncias suportadas desse recurso:

Aplicativos de contêiner do Azure
Microsoft Azure App Service, usando código

O suporte para integração do New Relic para App Services usando imagens em contêineres não está disponível.

Compatibilidade e requisitos

Antes de começar, recomendamos o seguinte:

Começando com um contêiner App ou App Service que foi implantado
Instalando o Azure CLI em seu ambiente se não estiver usando o Portal do Azure

Informações

Tenha em mente que o agente Python não captura telemetria para o Azure Functions sem nossa integração. Recomendamos instalar a integração de monitoramento do Azure Functions se você quiser coletar dados sobre o Azure Functions.

Integrar o agente Python em aplicativos de contêiner

Em certos casos, um aplicativo gerenciado pelo Azure contêiner Apps já possui uma imagem que não pode ser modificada pelo usuário (ou o usuário pode simplesmente não querer modificar o aplicativo). Isso fornece uma maneira de integrar o New Relic ao ambiente sem precisar fazer nenhuma modificação no código que cria a imagem em contêiner.

Isso pode ser feito por meio do Portal do Azure ou da CLI do Azure.

Add New Relic chave de licença

Esta etapa é opcional, mas altamente recomendada.

Se o Azure Key Vault não tiver sido criado, siga este guia de início rápido.

Selecione Container Apps > (select a Python app) > Settings > Secrets.
Adicione um segredo. Dê um nome ao segredo, selecione "Referência do Key Vault" e adicione sua chave de licença
Salve suas alterações.

Vincular o Compartilhamento de Arquivos do Azure ao Aplicativo de Contêiner

Crie um Compartilhamento de Arquivos do Azure seguindo este tutorial de início rápido.

Selecione Container Apps > (select a Python app) > Application > Containers.
Selecione "Editar e implantar"
Vá para a aba "Volumes" e clique em "(+) Adicionar"
Selecione "Volume de arquivo do Azure", preencha o nome do volume desejado e selecione o compartilhamento de arquivo criado anteriormente.
Salve suas alterações.

Adicionar e configurar o contêiner init

Selecione Container Apps > (select a Python app) > Application > Containers.
Na seção "contêiner image", clique em "Add" e selecione "Init contêiner"
Insira o seguinte:
- Nome do contêiner init desejado
- docker Hub ou outros registros" para "Fonte da imagem"
- newrelic/newrelic-python-init em "Imagem e tag"
- /bin/sh para "Substituição de comando"
- -c, cp -r /instrumentation /mnt/ para "Substituição de argumentos"
- Núcleos de CPU e memória desejados. Este não deve exceder o do contêiner primário.
Vá para a aba "Montagens de volume" e selecione a montagem de volume criada nas etapas anteriores. O caminho de montagem deve ser /mnt/instrumentation.
Salve suas alterações.

Vincule o New Relic ao aplicativo principal

Selecione Container Apps > (select a Python app) > Application > Containers.
Na seção "Imagem do contêiner", selecione o aplicativo principal e clique em "Editar"
Vá para a aba "Variáveis de ambiente" e digite o seguinte:
- NEW_RELIC_APP_NAME: [nome do aplicativo desejado]
- PYTHONPATH: /mnt/instrumentation
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
- NEW_RELIC_LICENSE_KEY > Faça referência a um segredo > selecione o nome do segredo na Etapa 1 (ou insira manualmente a chave de licença)
Vá para a aba "Montagens de volume" e selecione a montagem de volume criada na Etapa 2. O caminho de montagem deve ser /mnt/instrumentation.
Salve suas alterações.

Isso deverá reimplantar o aplicativo contêiner. Aguarde alguns minutos para que o contêiner init termine de ser executado.

Adicionar a chave de licença New Relic ao Azure Key Vault

Esta etapa é opcional, mas altamente recomendada.

Se o Azure Key Vault não tiver sido criado, siga este tutorial de início rápido.

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

Crie um Compartilhamento de Arquivos do Azure e vincule ao aplicativo contêiner

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

Adicionar variáveis de ambiente

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

Vincule o New Relic ao aplicativo principal

Exportar configuração do app contêiner

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

Este arquivo produzirá um arquivo de modelo parcial que contém informações sobre o aplicativo de contêiner. Informações adicionais precisarão ser adicionadas para vincular o New Relic ao aplicativo.

Montar volume no aplicativo de contêiner

Em propriedades > modelo, haverá uma seção chamada volumes. Agora mesmo, isso diz volumes: null. Substituiremos essa linha por estas linhas:

bash

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

Onde $STORAGE_MOUNT_NAME é o que foi usado na Etapa 2 e $VOLUME_NAME é um nome de sua escolha

Adicionar contêiner init

Em propriedades > modelo, haverá uma seção chamada initContainers. Agora mesmo, isso diz initContainers: null. Substituiremos essa linha por estas linhas:

bash

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

Volume do link para o contêiner

Em propriedades > modelo, agora temos as seções containers e initContainers . Dentro de cada uma dessas seções, adicione as seguintes linhas:

bash

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

Onde $VOLUME_NAME é o nome escolhido anteriormente

Atualizar aplicativo de contêiner com nova configuração

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

Isso deverá reimplantar o aplicativo contêiner. Aguarde alguns minutos para que o contêiner init termine de ser executado.

Integrar o agente Python no Azure App Service

Atualmente, os App Services oferecem suporte apenas a sidecars, mas não a init contêiner. Até que esse suporte esteja disponível, este script de pré-compilação pode ser usado. Observação: isso só funciona para serviços de aplicativo que usam código e não para imagens em contêineres.

Isso pode ser feito por meio do Portal do Azure ou da CLI do 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

Carregar script de inicialização

Acesse https://[NOME_DO_SEU_SITE_LINUX_AZURE].scm.azurewebsites.net/newui/fileManager e carregue o script prebuild.sh no diretório /home

Adicione as variáveis de ambiente necessárias

Selecione App Services > (select a Python app) > Settings > Environment variables.
Adicione o seguinte ao App settings:
- NEW_RELIC_APP_NAME: Nome do seu site Linux Azure
- NEW_RELIC_LICENSE_KEY: Sua New Relic
- PYTHONPATH: /home:/home/workspace/newrelic
- NEW_RELIC_AZURE_OPERATOR_ENABLED: True
Salve suas configurações.
Se uma versão específica do agente for desejada, adicione a variável de ambiente AGENT_VERSION com o número da versão, precedido por v (por exemplo v10.0.0).

Adicionar `prebuild.sh` como uma configuração de arquivo de inicialização

Selecione App Services > (select a Python app) > Settings > Configuration.
Adicione o seguinte a Startup Command: /home/prebuild.sh
Salve suas configurações. Isso deve reimplantar o aplicativo.
Isso levará alguns minutos.

Carregar script de inicialização

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

Adicione as variáveis de ambiente necessárias

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"

Se uma versão específica do agente for desejada, adicione a variável de ambiente AGENT_VERSION com o número da versão, precedido por v (por exemplo v10.0.0) conforme mostrado no exemplo abaixo:

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

Adicionar `prebuild.sh` como uma configuração de arquivo de inicialização

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

Isso levará alguns minutos.

Resolução de problemas

Em alguns casos, a telemetria pode não estar disponível ou o script prebuild.sh pode fazer com que o aplicativo existente falhe na reimplantação. Para remediar isso, habilite estas variáveis de ambiente:

SCM_DO_BUILD_DURING_DEVELOPMENT: True
ENABLE_ORYX_BUILD: True

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

Integrar o agente Python no Microsoft Azure contêiner Apps e App Service

visualização

Compatibilidade e requisitos

Informações

Integrar o agente Python em aplicativos de contêiner

Integrar o agente Python New Relic em um aplicativo de contêiner por meio do Portal do Azure

Add New Relic chave de licença

Vincular o Compartilhamento de Arquivos do Azure ao Aplicativo de Contêiner

Adicionar e configurar o contêiner init

Vincule o New Relic ao aplicativo principal

Integrar o agente Python New Relic em um aplicativo de contêiner por meio do Azure CLI

Adicionar a chave de licença New Relic ao Azure Key Vault

Crie um Compartilhamento de Arquivos do Azure e vincule ao aplicativo contêiner

Adicionar variáveis de ambiente

Vincule o New Relic ao aplicativo principal

Exportar configuração do app contêiner

Montar volume no aplicativo de contêiner

Adicionar contêiner init

Volume do link para o contêiner

Atualizar aplicativo de contêiner com nova configuração

Integrar o agente Python no Azure App Service

Integrar o agente Python New Relic aos Serviços de Aplicativos por meio do Portal do Azure

Carregar script de inicialização

Adicione as variáveis de ambiente necessárias

Adicionar `prebuild.sh` como uma configuração de arquivo de inicialização

Integrar o agente Python New Relic no App Services por meio do Azure CLI

Carregar script de inicialização

Adicione as variáveis de ambiente necessárias

Adicionar `prebuild.sh` como uma configuração de arquivo de inicialização

Resolução de problemas

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

Integrar o agente Python no Microsoft Azure contêiner Apps e App Service

visualização

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

Informações

Integrar o agente Python em aplicativos de contêiner

Integrar o agente Python New Relic em um aplicativo de contêiner por meio do Azure CLI

Integrar o agente Python no Azure App Service

Integrar o agente Python New Relic aos Serviços de Aplicativos por meio do Portal do Azure

Integrar o agente Python New Relic no App Services por meio do Azure CLI

Resolução de problemas

Compatibilidade e requisitos