Microsoft Azure コンテナーアプリと App Service に Python エージェントを統合する

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビュープログラムの一部として提供されています。

このドキュメントでは、アプリケーションコードを変更することなく、Azure でホストされる Python アプリケーションへのNew Relicインテグレーションに関するソリューションを提供します。この機能には 2 つのインスタンスがサポートされています。

Azure コンテナーアプリ
Microsoft Azure App Service 、コードの使用

コンテナ化されたイメージを使用した App Services のNew Relicインテグレーションのサポートは利用できません。

互換性と要件

始める前に、次のことをお勧めします。

デプロイ済みのコンテナアプリまたはApp Serviceから開始する
Azure ポータルを使用しない場合は、環境にAzure CLI をインストールします。

情報

Python エージェントは、統合がなければAzure Functionsのテレメトリーをキャプチャしないことに注意してください。に関するデータを収集したい場合は、Azure Functions 監視統合Azure Functions をインストールすることをお勧めします。

Pythonエージェントをコンテナアプリに統合する

場合によっては、 Azure コンテナーアプリを通じて管理されるアプリには、ユーザーが変更できないイメージが既に含まれていることがあります (または、ユーザーが単にアプリの変更を望まない場合もあります)。これにより、コンテナ化されたイメージを構築するコードを変更することなく、New Relic を環境に統合できるようになります。

これは、Azure Portal または Azure CLI を通じて実行できます。

New Relic ライセンスキーを追加する

この手順はオプションですが、強くお勧めします。

Azure Key Vault がまだ作成されていない場合は、このクイックスタートガイドに従ってください。

Container Apps > (select a Python app) > Settings > Secretsを選択します。
秘密を追加します。シークレットに名前を付け、「Key Vault参照」を選択し、ライセンスキーを追加します
変更を保存します。

Azure ファイル共有をコンテナーアプリにリンクする

このクイックスタートチュートリアルに従って、 Azure ファイル共有を作成します。

Container Apps > (select a Python app) > Application > Containersを選択します。
「編集とデプロイ」を選択します
「ボリューム」タブに移動して「（+）追加」をクリックします
「Azure ファイルボリューム」を選択し、希望のボリューム名を入力して、先ほど作成したファイル共有を選択します。
変更を保存します。

初期化コンテナの追加と設定

Container Apps > (select a Python app) > Application > Containersを選択します。
「コンテナイメージ」セクションで「追加」をクリックし、「コンテナの初期化」を選択します。
以下を入力してください:
- 希望の初期化コンテナ名
- 「イメージソース」の「docker Hub またはその他のレジストリ」
- newrelic/newrelic-python-init 「画像とタグ」の下
- /bin/sh 「コマンドオーバーライド」
- -c, cp -r /instrumentation /mnt/ 「引数のオーバーライド」
- 必要な CPU コアとメモリ。これはプライマリコンテナの容量を超えてはなりません。
「ボリュームマウント」タブに移動し、前の手順で作成したボリュームマウントを選択します。マウントパスは/mnt/instrumentationである必要があります。
変更を保存します。

New Relicをプライマリアプリケーションにリンクする

Container Apps > (select a Python app) > Application > Containersを選択します。
「コンテナイメージ」セクションで、プライマリアプリケーションを選択し、「編集」をクリックします。
「環境変数」タブに移動して、以下を入力します。
- NEW_RELIC_APP_NAME: [希望するアプリ名]
- PYTHONPATH： /mnt/instrumentation
- NEW_RELIC_AZURE_OPERATOR_ENABLED： True
- NEW_RELIC_LICENSE_KEY > シークレットを参照 > ステップ 1 でシークレット名を選択します (または手動でライセンスキーを入力します)
「ボリュームマウント」タブに移動し、手順 2 で作成したボリュームマウントを選択します。マウントパスは/mnt/instrumentationになります。
変更を保存します。

これにより、コンテナアプリが再デプロイされます。初期化コンテナの実行が完了するまで数分間待ちます。

New Relicライセンスキーを Azure Key Vault に追加する

この手順はオプションですが、強くお勧めします。

Azure Key Vaultがまだ作成されていない場合は、このクイックスタートチュートリアルに従ってください。

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

Azure ファイル共有を作成し、コンテナーアプリにリンクする

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

環境変数を追加する

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

New Relicをプライマリアプリケーションにリンクする

コンテナアプリの設定をエクスポート

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

このファイルは、コンテナアプリに関する情報を含む部分的なテンプレートファイルを生成します。 New Relic をアプリにリンクするには、追加情報を追加する必要があります。

コンテナアプリにボリュームをマウントする

プロパティ > テンプレートには、 volumesというセクションがあります。現時点では、 volumes: nullと表示されています。その行を次の行に置き換えます。

bash

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

$STORAGE_MOUNT_NAMEステップ2で使用されたもので、 $VOLUME_NAME選択した名前です。

初期化コンテナを追加する

プロパティ > テンプレートには、 initContainersというセクションがあります。現時点では、 initContainers: nullと表示されています。その行を次の行に置き換えます。

bash

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

ボリュームをコンテナにリンクする

プロパティ > テンプレートに、 containersとinitContainersセクションが追加されました。これらの各セクション内に、次の行を追加します。

bash

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

$VOLUME_NAMEは先ほど選択した名前です

コンテナアプリを新しい設定で更新する

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

これにより、コンテナアプリが再デプロイされます。初期化コンテナの実行が完了するまで数分間待ちます。

Python エージェントを Azure App Service に統合する

現在、App Services はサイドカーのみをサポートしており、init コンテナーはサポートしていません。そのサポートが利用可能になるまで、このプレビルドスクリプトを使用できます。注: これはコードを使用する App Services でのみ機能し、コンテナー化されたイメージでは機能しません。

これは、Azure Portal または Azure CLI を通じて実行できます。

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

起動スクリプトをアップロード

https://[YOUR_LINUX_AZURE_WEBSITE_NAME].scm.azurewebsites.net/newui/fileManager にアクセスします。 prebuild.shスクリプトを/homeディレクトリにアップロードします

必要な環境変数を追加する

App Services > (select a Python app) > Settings > Environment variablesを選択します。
App settingsに以下を追加します:
- NEW_RELIC_APP_NAME: Linux Azure Web サイト名
- NEW_RELIC_LICENSE_KEY: あなたのNew Relic
- PYTHONPATH： /home:/home/workspace/newrelic
- NEW_RELIC_AZURE_OPERATOR_ENABLED： True
設定を保存します。
特定のエージェントバージョンが必要な場合は、 AGENT_VERSION環境変数にバージョン番号を追加し、先頭にvを付けます（例： v10.0.0 ）。

スタートアップファイル設定として`prebuild.sh`を追加します

App Services > (select a Python app) > Settings > Configurationを選択します。
Startup Commandに以下を追加します: /home/prebuild.sh
設定を保存します。これにより、アプリが再デプロイされます。
これには数分かかります。

起動スクリプトをアップロード

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

必要な環境変数を追加する

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"

特定のエージェントバージョンが必要な場合は、 AGENT_VERSION環境変数にバージョン番号を追加し、先頭にvを付けます（例： v10.0.0 ) を次の例のように使用します。

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

スタートアップファイル設定として`prebuild.sh`を追加します

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

これには数分かかります。

トラブルシューティング

場合によっては、テレメトリーが利用できない場合や、 prebuild.shスクリプトが原因で既存のアプリケーションの再デプロイメントが失敗する場合があります。これを解決するには、次の環境変数を有効にします。

SCM_DO_BUILD_DURING_DEVELOPMENT： True
ENABLE_ORYX_BUILD： True

この機械翻訳は、参考として提供されています。

Microsoft Azure コンテナーアプリと App Service に Python エージェントを統合する

プレビュー

互換性と要件

情報

Pythonエージェントをコンテナアプリに統合する

Azure ポータル経由で New Relic Python エージェントをコンテナーアプリに統合する

New Relic ライセンスキーを追加する

Azure ファイル共有をコンテナーアプリにリンクする

初期化コンテナの追加と設定

New Relicをプライマリアプリケーションにリンクする

Azure CLI を介して New Relic Python エージェントをコンテナーアプリに統合する

New Relicライセンスキーを Azure Key Vault に追加する

Azure ファイル共有を作成し、コンテナーアプリにリンクする

環境変数を追加する

New Relicをプライマリアプリケーションにリンクする

コンテナアプリの設定をエクスポート

コンテナアプリにボリュームをマウントする

初期化コンテナを追加する

ボリュームをコンテナにリンクする

コンテナアプリを新しい設定で更新する

Python エージェントを Azure App Service に統合する

Azure ポータルを通じて New Relic Python エージェントを App Services に統合する

起動スクリプトをアップロード

必要な環境変数を追加する

スタートアップファイル設定として`prebuild.sh`を追加します

Azure CLI を介して New Relic Python エージェントを App Services に統合する

起動スクリプトをアップロード

必要な環境変数を追加する

スタートアップファイル設定として`prebuild.sh`を追加します

トラブルシューティング

この機械翻訳は、参考として提供されています。

Microsoft Azure コンテナー アプリと App Service に Python エージェントを統合する

プレビュー

互換性と要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

情報

Pythonエージェントをコンテナアプリに統合する

Azure CLI を介して New Relic Python エージェントをコンテナー アプリに統合する

Python エージェントを Azure App Service に統合する

Azure ポータルを通じて New Relic Python エージェントを App Services に統合する

Azure CLI を介して New Relic Python エージェントを App Services に統合する

トラブルシューティング

Microsoft Azure コンテナーアプリと App Service に Python エージェントを統合する

互換性と要件

Azure CLI を介して New Relic Python エージェントをコンテナーアプリに統合する