Azure Spring Apps Enterprise プランで Application Live View を使用する

Note

Azure Spring Apps は、Azure Spring Cloud サービスの新しい名前です。 サービスの名前は新しくなりましたが、スクリーンショット、ビデオ、図などの資産の更新に取り組んでいる間、場所によってはしばらく古い名前が表示されます。

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

この記事では、Azure Spring Apps Enterprise プランで Application Live View for VMware Tanzu を使用する方法について説明します。

Application Live View for VMware Tanzu は、アプリの開発者とアプリのオペレーターが実行中のアプリ内を調べるのに役立つ、分析情報とトラブルシューティングのための軽量ツールです。

Application Live View では、Spring Boot アプリケーションのみがサポートされます。

前提条件

• Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。

• Azure Marketplace の Enterprise プランの「要件」セクションを理解し、要件を満たします。

• Azure Spring Apps 拡張機能を使用した Azure CLI。 次のコマンドを使用して、以前のバージョンを削除し、最新の拡張機能をインストールします。 以前に spring-cloud 拡張機能をインストールした場合は、構成とバージョンの不一致を回避するためにそれをアンインストールします。

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

Application Live View の有効化

Azure Spring Apps Enterprise プラン インスタンスをプロビジョニングするときに、Application Live View を有効にできます。 プロビジョニング済みの Azure Spring Apps Enterprise リソースが既にある場合は、この記事の「既存の Enterprise プラン インスタンスでの Application Live View の管理」セクションを参照してください。

Application Live View は、Azure portal または Azure CLI を使用して有効にできます。

Azure Portal

Azure portal を使用して Application Live View を有効にするには、次の手順に従います。

1. Azure Portal に移動します。

2. [基本] タブで、価格の [Enterprise レベル] を選択し、他の入力フィールドを指定して、[次へ] を選択します。

3. [VMware Tanzu の設定] タブで、[アプリのライブ ビューを有効にする] を選択します。

   

4. 他の設定を指定し、[確認と作成] を選択します。

5. [Enable Application Live View]\(Application Live View の有効化\) と [開発者ツール ポータルを有効にする] が、[確認と作成] タブで [はい] に設定されていることを確認し、[作成] を選択して Enterprise プラン インスタンスを作成します。

Azure CLI

Azure CLI を使用して Azure Spring Apps サービス インスタンスをプロビジョニングするには、次の手順を使用します。

1. 次のコマンドを使用して、Azure CLI にサインインし、アクティブなサブスクリプションを指定します。

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. 次のコマンドを使用して、Enterprise プランの法律条項とプライバシー ステートメントに同意します。 この手順は、サブスクリプションが Azure Spring Apps の Enterprise プラン インスタンスの作成に使用されたことがない場合にのみ必要です。

   az provider register --namespace Microsoft.SaaS
   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

3. 場所を選択します。 この場所は、Azure Spring Apps Enterprise プランをサポートする場所である必要があります。 詳細については、「Azure Spring Apps に関する FAQ」を参照してください。

4. 次のコマンドを使用して、リソース グループを作成します。

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   リソース グループの詳細については、「Azure Resource Manager とは」を参照してください。

5. Azure Spring Apps サービス インスタンスの名前を準備します。 名前の長さは 4 文字から 32 文字で、小文字、数字、およびハイフンのみを使用できます。 サービス名の最初の文字は英字でなければならず、最後の文字は英字または数字でなければなりません。

6. 次のコマンドを使用して、Azure Spring Apps サービス インスタンスを作成します。

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise \
       --enable-application-live-view
   

Application Live View の監視

Azure Spring Apps は、コネクタ モードで Application Live View を実行します。

コンポーネント	説明
Application Live View Server	登録されているアプリの一覧を含む中央サーバー コンポーネント。 Application Live View Server は、アプリに関連するアクチュエータ情報をフェッチする要求をプロキシ処理する役割を担います。
Application Live View コネクタ	実行中のアプリを検出し、インスタンスを Application Live View Server に登録して監視するコンポーネント。 Application Live View Connector は、アクチュエータ クエリをアプリにプロキシする役割も担います。

Azure Spring Apps Enterprise プラン インスタンスをプロビジョニングしたら、その実行状態とリソース消費量を取得し、Application Live View を管理できます。

Application Live View は、Azure portal または Azure CLI を使用して監視できます。

Azure Portal

Azure portal の [開発者ツール] ページの [概要] タブで、Application Live View の状態を表示できます。

Azure CLI

Application Live View を表示するには、次のコマンドを使用します。

az spring application-live-view show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Application Live View にアクセスするための開発ツールの構成

Application Live View にアクセスするには、Tanzu Dev Tools を構成する必要があります。 詳細については、「Azure Spring Apps Enterprise プランで Tanzu Dev Tools を構成する」を参照してください。

Application Live View を使用したアプリの監視

Application Live View では、Spring Boot アプリケーションと Spring Native アプリケーションのライブ メトリックを表示できます。 Application Live View は、Spring Boot アクチュエータの概念に基づいています。

アプリをデプロイし、そのアプリを Application Live View で監視するには、次の手順に従います。

1. アプリケーションの pom.xml ファイルに、次の依存関係を追加します。

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
   

2. ビルド情報を公開するために、pom.xml ファイル内の Maven プラグインに次の実行目標を追加します。

   <plugin>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-maven-plugin</artifactId>
   <executions>
       <execution>
       <goals>
           <goal>build-info</goal>
       </goals>
       <configuration>
           <additionalProperties>
           <spring.boot.version>${project.parent.version}</spring.boot.version>
           </additionalProperties>
       </configuration>
       </execution>
   </executions>
   </plugin>
   

3. application.properties に次の構成を追加して、アクチュエータ エンドポイントを有効にします。

   management.endpoints.web.exposure.include=info,health
   

4. 次のコマンドを使用して、パッケージをローカルにビルドします。

   mvn clean package -DskipTests
   

5. 次のコマンドを使用して、バイナリをデプロイします。

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name>
   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name> \
       --artifact-path <jar-file-in-target-folder>
   

6. アプリが正常にデプロイされたら、Dev Tools ポータルの Application Live View ダッシュボードを使用してアプリを監視できます。 詳細については、「Application Live View を使用してアプリを監視する」を参照してください。

   既に、開発ツール ポータルを有効にし、パブリック エンドポイントを公開している場合は、次のコマンドを使用して開発ツール ポータルのダッシュボードの URL を取得します。 エンドポイントを構成するサフィックス /app-live-view を追加して、Application Live View にアクセスします。

   az spring dev-tool show --service <Azure-Spring-Apps-service-instance-name> \
       --resource-group <resource-group-name> \
       --query properties.url \
       --output tsv
   

   Visual Studio Code (VS Code) を使用して Application Live View にアクセスすることもできます。 詳細については、この記事の「VS Code での Application Live View の使用」セクションを参照してください。

既存の Enterprise プラン インスタンスでの Application Live View の管理

Azure portal または Azure CLI を使用して、既存の Azure Spring Apps Enterprise プラン インスタンスで Application Live View を有効にできます。

開発ツール ポータルを有効にし、パブリック エンドポイントを公開している場合は、Application Live View を有効にした後、Ctrl+F5 キーを押してブラウザー キャッシュを非アクティブ化します。

Azure Portal

Azure portal を使用して Application Live View を管理するには、次の手順に従います。

1. Azure Spring Apps サービス インスタンスに移動して、[開発者ツール] を選択します。

2. [ツールの管理] を選択します。

   

3. [アプリのライブ ビューを有効にする] チェック ボックスをオンにし、[保存] を選択します。

   

4. その後、開発者ツールで Application Live View の状態を表示できます。

Azure CLI

次のコマンドを使用して、Azure CLI を使用して Application Live View を有効にします。

az spring application-live-view create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Application Live View ダッシュボードにアクセスするには、Dev Tools ポータルを有効にして、パブリック エンドポイントを割り当てる必要があります。 Dev Tools ポータルを有効にしてパブリック エンドポイントを割り当てるには、次のコマンドを使用します。

az spring dev-tool create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-service-instance-name> \
   --assign-endpoint

カスタマイズされた Spring Boot アクチュエータを構成する

Application Live View では、既定のアクチュエータ設定を使用して Spring Boot アプリに自動的に接続して監視できます。 アクチュエータ エンドポイントの既定の HTTP ポートは、アプリケーションの HTTP ポートと同じです。そして、すべてのアクチュエータ エンドポイントには、/actuator サフィックスを持つ、アプリケーションの既定のコンテキスト パスからアクセスできます。

ポート (management.server.port=) またはコンテキスト パス (management.endpoints.web.base-path=/) がアプリに合わせてカスタマイズされている場合、Application Live View ではアプリへの接続とアプリの監視を停止し、アプリについて 404 を報告します。 Application Live View で、このようなアプリの監視を継続できるようにするには、次の手順に従ってアプリのデプロイを構成し、アクチュエータのエンドポイントをカスタマイズします。

Azure Portal

次の手順に従って、Azure portal でデプロイを構成します。

1. Azure Spring Apps サービス インスタンスに移動してから、[アプリ] ページに移動し、アプリケーションを選択します。

2. ナビゲーション ペインで、[構成] を選択します。

3. [全般設定] タブで、[Spring Boot アクチュエーター ポート] と [Spring Boot アクチュエーター パス] の値を更新して、[保存] を選択します。

   

Azure CLI

Azure CLI で、カスタム アクチュエータ設定を使用してアプリケーションをデプロイするには、次のコマンドを使用します。

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --artifact-path <jar-file-in-target-folder> \
    --custom-actuator-path <another-path-for-actuator> \
    --custom-actuator-port <another-port-for-actuator>

Note

この構成は、アプリまたはデプロイに対して設定できます。 アプリを構成すると、それは実際には現在のアクティブなデプロイに適用されます。新しいデプロイに自動的に適用されることはありません。

VS Code での Application Live View の使用

VS Code で Application Live View に直接アクセスして、Azure Spring Apps Enterprise プランでアプリを監視できます。

前提条件

• Visual Studio Code
• Visual Studio Code 用 Azure Spring Apps 拡張機能

Application Live View の表示ダッシュボード

サービス インスタンスの Application Live View ダッシュボードを表示するには、次の手順に従います。

1. Visual Studio Code で、Azure Spring Apps 拡張機能を開き、Azure アカウントにサインインします。

2. 監視するサービス インスタンスを展開し、右クリックしてサービス インスタンスを選びます。

3. メニューから [Open Application Live View]\(Application Live View を開く\) を選択して、既定のブラウザーで Application Live View ダッシュボードを開きます。

   

アプリの [View Application Live View]\(Application Live View の表示\) ページ

アプリの Application Live View ページを表示するには、次の手順に従います。

1. Visual Studio Code で、Azure Spring Apps 拡張機能を開き、Azure アカウントにサインインします。

2. 監視するサービス インスタンスとアプリを展開します。 アプリを右クリックします。

3. メニューから [Open Application Live View]\(Application Live View を開く\) を選択して、既定のブラウザーで Application Live View ページを開きます。

   

Application Live View の問題のトラブルシューティング

Application Live View を有効にしていない、またはパブリック エンドポイントを公開していないサービス インスタンスまたはアプリの Application Live View を開こうとすると、エラー メッセージが表示されます。

Application Live View を有効にしてパブリック エンドポイントを公開するには、Azure portal または Azure CLI を使用します。 詳細については、この記事の「既存の Enterprise プラン インスタンスでの Application Live View の管理」セクションを参照してください。

次のステップ

• Azure Spring Apps