Install the Python agent on Microsoft Azure Container Apps and App Service

Microsoft Azure offers two platform services that manage your web or containerized apps. You can install the Python agent on both Microsoft Azure App Service and Azure Container Apps, letting you track your Azure-managed Python apps in New Relic.

Alternative Approaches

If you are looking for a way to integrate New Relic into your Azure hosted application without modifying your application code, this tutorial provides that solution.

Compatibility and requirements

Before you install the Python agent, we recommend:

Reviewing the Python agent's compatibility and requirements doc
Setting up a Python app on one (or both!) of the Azure managed platforms
Installing the Azure CLI in your environment

Info

Keep in mind that the Python agent doesn't capture telemetry for Azure Functions without our integration. We recommend installing the Azure Functions monitoring integration if you'd like to collect data about Azure Functions.

Install the Python agent onto Azure App Service or Container Apps

Add the Python agent to your Azure application

To add the New Relic Python agent to your Azure application, add newrelic to your requirements.txt file:

bash

$foo@bar:~$ cat requirements.txt 
$newrelic
$flask

Initialize the agent

The agent can be initialized either by manually initializing the app itself or by adding a New Relic entrypoint in the Dockerfile:

Update your app code to import newrelic.agent, then add the newrelic.agent.initialize() function to initialize the agent.

Here's an example Flask app with the agent initialized:

# app.py
# Run with command "flask run"

import newrelic.agent   # ADDED
from flask import Flask

newrelic.agent.initialize()   # ADDED

app = Flask(__name__)

@app.route('/')
def hello_world():
    return "Hello, fellow humans!"

if __name__ == '__main__':
    app.run()

If you're using a Dockerfile, add newrelic-admin run-program as an entrypoint to your startup script.

COPY requirements.txt .
COPY app.py .

RUN pip install -r requirements.txt

EXPOSE 5000

ENTRYPOINT ["newrelic-admin", "run-program"]
CMD ["flask", "run"]

Configure your Azure settings

Once you've installed the Python agent, we recommend configuring your app in either the Azure App Service or Container Apps portal, depending on the service you're using. You can update your app settings through the Azure UI, or using the Python CLI.

Sign in to portal.azure.com.
Select Container Apps > (select a Python app) > Containers > Environment variables.
Add the following to the Container settings:

NEW_RELIC_APP_NAME: Your Linux Azure website name
NEW_RELIC_LICENSE_KEY: Your New Relic

Save your settings.
Restart your Python app.
Generate some traffic to your app and wait a few minutes. You can see your data by going to one.newrelic.com > All capabilities > APM & services > (select your app).

Run the following on the command line:

bash

$az webapp config appsettings set --name ${WEB_APP_NAME} --settings NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY} NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME}

Run the following on the command line:

bash

$az containerapp update --name ${CONTAINER_APP_NAME} --set-env-vars "NEW_RELIC_APP_NAME=${NEW_RELIC_APP_NAME}" "NEW_RELIC_LICENSE_KEY=${NEW_RELIC_LICENSE_KEY}"

If multiple replicas are allowed, the command above will create a new one. Otherwise, the container replica will need to be restarted. To do so, find the name of the replica and use that to restart:

bash

$az containerapp revision list --name ${CONTAINER_APP_NAME} -o table
$az containerapp revision restart --revision [Revision name from list generated above]

What's next?

Now that you're collecting data from your Azure-managed Python apps, you can:

Check out our docs to learn how to query your New Relic data.
Learn how to create your first alert.
You can get started with dashboards to learn how to build tailored visualizations about your environment.

Install the Python agent on Microsoft Azure Container Apps and App Service

Alternative Approaches

Compatibility and requirements

Info

Install the Python agent onto Azure App Service or Container Apps

Add the Python agent to your Azure application

Initialize the agent

Initialize the Python agent with `initialize()`

Initialize the Python agent through the Dockerfile

Configure your Azure settings

Configure your app in Azure App Services through the Azure Portal

Configure your app in Azure Container Apps though the Azure Portal

Configure your app in Azure App Services through the CLI

Configure your app in Azure Container Apps though the CLI

What's next?

Install the Python agent on Microsoft Azure Container Apps and App Service

Alternative Approaches

Compatibility and requirements .css-21sua1{background:none;border:none;width:0;padding:0;}

Info

Install the Python agent onto Azure App Service or Container Apps

Add the Python agent to your Azure application

Initialize the agent

Initialize the Python agent through the Dockerfile

Configure your Azure settings

Configure your app in Azure App Services through the Azure Portal

Configure your app in Azure Container Apps though the Azure Portal

Configure your app in Azure App Services through the CLI

Configure your app in Azure Container Apps though the CLI

What's next?

Compatibility and requirements