クイックスタート: アプリケーションをエンドツーエンドで監視する

[アーティクル]
08/28/2024

Note

Basic、Standard、Enterprise プランは、2025 年 3 月中旬以降非推奨になり、廃止期間は 3 年間です。 Azure Container Apps に移行することをお勧めします。詳細については、「Azure Spring Apps の廃止のお知らせ」を参照してください。

Standard 従量課金と専用プランは、2024 年 9 月 30 日以降に非推奨になり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。詳細については、「Azure Spring Apps の Standard 従量課金および専用プランを Azure Container Apps に移行する」を参照してください。

この記事の適用対象:❌ Basic または Standard ✔️ Enterprise

このクイックスタートでは、Application Insights と Log Analytics を使用して、Azure Spring Apps Enterprise プランを実行しているアプリを監視する方法について説明します。

注意

App Insights、Log Analytics、New Relic、Dynatrace、AppDynamics、Elastic、Splunk など、任意のツールとプラットフォームを使って、Spring ワークロードをエンドツーエンドで監視できます。詳しくは、後の「他の監視ツールを使用する」をご覧ください。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure Marketplace の Enterprise プランの「要件」セクションを理解し、要件を満たします。
Azure CLI バージョン 2.45.0 以降。
Git.
Azure Spring Apps Enterprise プランの拡張機能。次のコマンドを使用して、以前のバージョンを削除し、最新の Enterprise プランの拡張機能をインストールします。以前に spring-cloud 拡張機能をインストールした場合は、構成とバージョンの不一致を回避するためにそれをアンインストールします。
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
監視するリソース (次のクイックスタートで作成されたものなど):

アプリケーションを更新する

Application Insights の接続文字列を、Order Service (ASP.NET Core) アプリケーションと Cart Service (Python) アプリケーションに手動で提供する必要があります。次の手順では、この接続文字列を提供し、Application Insights へのサンプリングレートを増やす方法について説明します。

注意

現在、Application Insights のインストルメンテーションをサポートするのは、Java と NodeJS のアプリケーションの Buildpack だけです。

次のコマンドを使用して、リソースを保持する変数を作成します。プレースホルダーは必ず、独自の値で置き換えてください。 Azure Spring Apps サービスインスタンスの名前は、長さが 4 文字から 32 文字でなければならず、小文字、数字、およびハイフンのみを使用できます。サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。
```
export RESOURCE_GROUP="<resource-group-name>"
export APP_INSIGHTS_NAME="<app-insights-name>"
export KEY_VAULT_NAME="<key-vault-name>"
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME="<Azure-Spring-Apps-service-instance-name>"
```
Note

既定では、APP_INSIGHTS_NAME は AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME と同じです。

次のコマンドを使って、Application Insights の接続文字列を取得し、Key Vault に設定します。

export CONNECTION_STRING=$(az monitor app-insights component show \
    --resource-group ${RESOURCE_GROUP} \
    --app ${APP_INSIGHTS_NAME} \
    --query "connectionString" \
    --output tsv)

az keyvault secret set \
    --vault-name ${KEY_VAULT_NAME} \
    --name "ApplicationInsights--ConnectionString" \
    --value ${CONNECTION_STRING}

次のコマンドを使って、Application Insights バインディングのサンプリングレートを更新して、使用可能なデータの量を増やします。

az spring build-service builder buildpack-binding set \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --builder-name default \
    --name default \
    --type ApplicationInsights \
    --properties sampling-rate=100 connection_string=${CONNECTION_STRING}

次のコマンドを使って、アプリケーションを再起動して構成を再度読み込みます。

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name cart-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name order-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name catalog-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name frontend

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name payment-service

シングルサインオンを構成している場合は、次のコマンドを使ってアプリケーションを再起動し、ID サービスアプリの構成を再度読み込みます。
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Java と NodeJS のアプリケーションの場合、再起動すると、新しいサンプリングレートが有効になります。 Java 以外のアプリケーションの場合、再起動すると、Key Vault の新しく追加されたインストルメンテーションキーにアクセスできるようになります。

ログを表示する

Azure Spring Apps でログを表示するには、アプリインスタンスごとのリアルタイムログのログストリーミング、または高度なクエリ機能を持つ集計されたログ用の Log Analytics の、2 つの方法があります

ログストリーミングを使用する

アプリケーション内を移動し、カタログを表示し、注文を行うことで、アプリケーション内のトラフィックを生成します。キャンセルされるまで、次のコマンドを使ってトラフィックを継続的に生成します。

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --query "properties.url" \
    --output tsv)

export GATEWAY_URL=https://${GATEWAY_URL} 

cd azure-spring-apps-enterprise/load-test/traffic-generator
./gradlew gatlingRun-com.vmware.acme.simulation.GuestSimulation.java

次のコマンドを使って、Catalog Service アプリケーションから最新の 100 行のアプリケーションコンソールログを取得します。

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --lines 100

--follow オプションを追加すると、アプリからリアルタイムのログストリーミングを取得できます。次のコマンドを使って、Catalog Service アプリケーションのログストリーミングを試します。

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --follow

ヒント

さらに多くのパラメーターとログストリーム機能を調べるには、az spring app logs --help を使います。

Log Analytics の使用

Azure portal に移動し、作成した Log Analytics インスタンスを開きます。 Log Analytics インスタンスは、Azure Spring Apps サービスインスタンスを作成したのと同じリソースグループにあります。

Log Analytics のページで、[ログ] ペインを選んで、Azure Spring Apps に次のいずれかのサンプルクエリを実行します。

次の Kusto クエリを入力して実行して、アプリケーションログを表示します。

AppPlatformLogsforSpring
| where TimeGenerated > ago(24h)
| limit 500
| sort by TimeGenerated
| project TimeGenerated, AppName, Log