From 569dcaa6d19aeb6c410e96104e44d0cc76012bf4 Mon Sep 17 00:00:00 2001 From: Lalleh Rafeei Date: Mon, 14 Oct 2024 12:05:55 -0700 Subject: [PATCH 1/6] Python release notes for v10.1.0 --- .../python-agent-configuration.mdx | 51 +++++++++++++++++++ .../python-azure-touchless-integration.mdx | 8 +-- .../python-agent-100200.mdx | 27 ++++++++++ 3 files changed, 82 insertions(+), 4 deletions(-) create mode 100644 src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx diff --git a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index 2c62244593c..d7e891b874d 100644 --- a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5432,6 +5432,57 @@ Here are assorted other settings available via the agent configuration file. This setting does **not** enable/disable this function of the agent. + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ Type + + Boolean +
+ Default + + false +
+ [Set in](#options) + + Config file, environment variable +
+ [Environ variable](#environment-variables) + + `NEW_RELIC_AZURE_OPERATOR_ENABLED` +
+ + This setting is used to enable the agent to be injected into a Microsoft Azure Container App. + ## Heroku diff --git a/src/content/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx b/src/content/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx index 6d69174c4f7..f7fb35161c0 100644 --- a/src/content/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx +++ b/src/content/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration.mdx @@ -93,7 +93,7 @@ This can be done through the Azure Portal or the Azure CLI. 3. Jump to "Environment variables" tab and enter the following: * `NEW_RELIC_APP_NAME`: [desired app name] * `PYTHONPATH`: `/mnt/instrumentation` - * `NEW_RELIC_K8S_OPERATOR_ENABLED`: `True` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`: `True` * `NEW_RELIC_LICENSE_KEY` > Reference a secret > select the secret name from Step 1 (or manually enter the license key) 4. Go to "Volume Mounts" tab and select the volume mount created in Step 2. The mount path should be `/mnt/instrumentation`. 5. Save your changes. @@ -135,7 +135,7 @@ This can be done through the Azure Portal or the Azure CLI. ## Add environment variables [#add-env-vars-cli] - `az containerapp update --name $CONTAINER_APP_NAME --resource-group $RESOURCE_GROUP --set-env-vars "NEW_RELIC_APP_NAME=$NEW_RELIC_APP_NAME" "NEW_RELIC_K8S_OPERATOR_ENABLED=True" "NEW_RELIC_LICENSE_KEY=secretref:license-key" "PYTHONPATH="/mnt/instrumentation` + `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` @@ -251,7 +251,7 @@ gunicorn app:app * `NEW_RELIC_APP_NAME`: Your Linux Azure website name * `NEW_RELIC_LICENSE_KEY`: Your New Relic * `PYTHONPATH`: `/home:/home/workspace/newrelic` - * `NEW_RELIC_K8S_OPERATOR_ENABLED`: `True` + * `NEW_RELIC_AZURE_OPERATOR_ENABLED`: `True` 3. Save your settings. If a specific agent version is desired, add the `AGENT_VERSION` environment variable with the version number, prepended by `v` (e.g. `v10.0.0`). @@ -283,7 +283,7 @@ gunicorn app:app ## Add necessary environment variables - `az webapp config appsettings set --name ${WEB_APP_NAME} --resource-group ${RESOURCE_GROUP} --settings NEW_RELIC_LICENSE_KEY=$NEW_RELIC_LICENSE_KEY NEW_RELIC_K8S_OPERATOR_ENABLED=true NEW_RELIC_APP_NAME="Azure Service App" PYTHONPATH="/home:/home/workspace/newrelic"` + `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"` If a specific agent version is desired, add the `AGENT_VERSION` environment variable with the version number, prepended by `v` (e.g. `v10.0.0`) as shown in the example below: diff --git a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx new file mode 100644 index 00000000000..0d0712d6589 --- /dev/null +++ b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx @@ -0,0 +1,27 @@ +--- +subject: 'Python agent' +releaseDate: '2024-10-15' +version: 10.2.0 +downloadLink: 'https://pypi.python.org/pypi/newrelic' +features: ['Add Azure Operator Flag'] +bugs: [] +security: [] +--- + +## Notes + +This release of the Python agent adds a flag for the Azure Init Container Operator. + +Install the agent using `easy_install/pip/distribute` via the [Python Package Index](https://pypi.python.org/pypi/newrelic) or download it directly from the [New Relic download site](https://download.newrelic.com/python_agent/release). + +## New features + +* Add Azure Init Container Operator Flag + + * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To enable the init container functionality, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. This can also be set through the `azure_operator.enabled` setting in the `newrelic.ini` file. + +## Support statement + +We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read [more](/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/) about keeping agents up to date. + +See the New Relic Python agent [EOL policy](/docs/apm/agents/python-agent/getting-started/python-agent-eol-policy/) for information about agent releases and support dates. From b83614d1fed746398929e3f8fbb813875e9afdd7 Mon Sep 17 00:00:00 2001 From: jcol <116673918+jeff-colucci@users.noreply.github.com> Date: Tue, 15 Oct 2024 16:16:56 -0500 Subject: [PATCH 2/6] Update python-agent-100200.mdx --- .../python-release-notes/python-agent-100200.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx index 0d0712d6589..453934071ee 100644 --- a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx +++ b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx @@ -18,7 +18,7 @@ Install the agent using `easy_install/pip/distribute` via the [Python Package In * Add Azure Init Container Operator Flag - * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To enable the init container functionality, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. This can also be set through the `azure_operator.enabled` setting in the `newrelic.ini` file. + * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To enable the init container functionality, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. You can set it through the `azure_operator.enabled` setting in the `newrelic.ini` file. ## Support statement From 75007def4e0951ef9388bc99566d7dd08324f79d Mon Sep 17 00:00:00 2001 From: Lalleh Rafeei Date: Tue, 15 Oct 2024 15:00:26 -0700 Subject: [PATCH 3/6] Remove Azure and K8s setting from config --- .../python-agent-configuration.mdx | 17 ++++++++++------- .../python-agent-100200.mdx | 2 +- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index d7e891b874d..6e55b406e85 100644 --- a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5380,8 +5380,8 @@ Here are assorted other settings available via the agent configuration file. @@ -5411,7 +5411,7 @@ Here are assorted other settings available via the agent configuration file. @@ -5434,8 +5434,8 @@ Here are assorted other settings available via the agent configuration file.
- Config file, environment variable + Environment variable
@@ -5465,7 +5465,7 @@ Here are assorted other settings available via the agent configuration file. @@ -5481,7 +5481,10 @@ Here are assorted other settings available via the agent configuration file.
- Config file, environment variable + Environment variable
- This setting is used to enable the agent to be injected into a Microsoft Azure Container App. + This is an informational setting used to report when the agent is injected into a Microsoft Azure Container App. + + This setting does **not** enable/disable this function of the agent. + diff --git a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx index 453934071ee..06099f7655b 100644 --- a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx +++ b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx @@ -18,7 +18,7 @@ Install the agent using `easy_install/pip/distribute` via the [Python Package In * Add Azure Init Container Operator Flag - * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To enable the init container functionality, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. You can set it through the `azure_operator.enabled` setting in the `newrelic.ini` file. + * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To flag that this is the installation method used, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. ## Support statement From 15d7e2162a3cd5be5c08d80a6dc3261677f96a5c Mon Sep 17 00:00:00 2001 From: jcol <116673918+jeff-colucci@users.noreply.github.com> Date: Tue, 15 Oct 2024 18:01:31 -0500 Subject: [PATCH 4/6] Update python-agent-100200.mdx Style changes --- .../python-release-notes/python-agent-100200.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx index 06099f7655b..2d1fa12b0a7 100644 --- a/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx +++ b/src/content/docs/release-notes/agent-release-notes/python-release-notes/python-agent-100200.mdx @@ -10,7 +10,7 @@ security: [] ## Notes -This release of the Python agent adds a flag for the Azure Init Container Operator. +This release of the Python agent adds a flag for the Azure init container operator. Install the agent using `easy_install/pip/distribute` via the [Python Package Index](https://pypi.python.org/pypi/newrelic) or download it directly from the [New Relic download site](https://download.newrelic.com/python_agent/release). @@ -18,7 +18,7 @@ Install the agent using `easy_install/pip/distribute` via the [Python Package In * Add Azure Init Container Operator Flag - * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). To flag that this is the installation method used, the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable can be set. + * New Relic can be integrated into applications hosted on Microsoft Azure, either [directly](/docs/apm/agents/python-agent/hosting-services/python-azure-containerapps-appservice), through an [init container](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-container-app) for [Azure Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/overview), or a [pre-build startup script](/docs/apm/agents/python-agent/hosting-services/python-azure-touchless-integration#integrate-agent-app-service) for [Microsoft Azure App Service](https://learn.microsoft.com/en-us/azure/app-service/overview). You can flag that this is the installation method used by setting the `NEW_RELIC_AZURE_OPERATOR_ENABLED` environment variable. ## Support statement From 1527ed3ef3328f741563adad087bef73df52b93b Mon Sep 17 00:00:00 2001 From: jcol <116673918+jeff-colucci@users.noreply.github.com> Date: Tue, 15 Oct 2024 18:02:21 -0500 Subject: [PATCH 5/6] Update python-agent-configuration.mdx --- .../python-agent/configuration/python-agent-configuration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index 6e55b406e85..0f509df3a11 100644 --- a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5429,7 +5429,7 @@ Here are assorted other settings available via the agent configuration file. This is an informational setting used to report when the agent is injected into a Kubernetes cluster. - This setting does **not** enable/disable this function of the agent. + This setting does **not** enable or disable this function of the agent. From 3f22ced178d981d11f05d10e682b1339dbd9c68f Mon Sep 17 00:00:00 2001 From: jcol <116673918+jeff-colucci@users.noreply.github.com> Date: Tue, 15 Oct 2024 18:03:38 -0500 Subject: [PATCH 6/6] Update python-agent-configuration.mdx --- .../python-agent/configuration/python-agent-configuration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx index 0f509df3a11..21c04d7d77a 100644 --- a/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx +++ b/src/content/docs/apm/agents/python-agent/configuration/python-agent-configuration.mdx @@ -5483,7 +5483,7 @@ Here are assorted other settings available via the agent configuration file. This is an informational setting used to report when the agent is injected into a Microsoft Azure Container App. - This setting does **not** enable/disable this function of the agent. + This setting does **not** enable or disable this function of the agent.