Azure Spring Apps Enterprise プランで Application Live View を使用してアプリを監視する

Note

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

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

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

Application Live View は、Spring Boot Actuator の情報を調べることで、実行中のアプリに関する視覚的な分析情報を提供します。 これは、アプリ内からデータのライブ ビューのみを提供します。 Application Live View は、詳細な分析や履歴のビューのためのアプリ データの格納は行いません。 使いやすいインターフェイスで、アプリの特定の側面のトラブルシューティング、学習、および概要の保守を行うことができます。 実行中のアプリのログ レベルや環境プロパティなどの一部のパラメーターを変更できるように、ユーザーに一定のレベルの制御を提供します。

この記事では、Application Live View UI の機能、およびApplication Live View ユーザー インターフェイスに含まれるページとビューについて説明します。

前提条件

詳細ページ

[Details] ページは、[Live View] セクションに読み込まれる既定のページです。 このページは、次のプロパティを含む表形式の概要を示します。

  • アプリ名
  • Instance ID
  • 場所
  • アクチュエータの位置
  • 正常性エンドポイント
  • アクチュエータへの直接アクセス
  • フレームワーク
  • Version
  • 新しいパッチ バージョン
  • 新しいメジャー バージョン
  • ビルド バージョン

ページの右上隅にあるドロップダウンから選択することで、情報カテゴリ間を移動できます。

デモ アプリの [Details] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Health] ページ

[Health] ページに移動するには、[Information Category] ドロップダウンから [Health] オプションを選択します。 [Health] ページは、アプリの正常性に関する詳細情報を提供します。

[Health] ページには、次の機能が含まれています。

  • アプリの正常性を構成するすべてのコンポーネント (準備状況、ライブネス、ディスク領域など) の一覧を表示します。
  • 各コンポーネントに関連付けられている状態と詳細を表示します。

[Health] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Environment] ページ

[Environment] ページに移動するには、[Information Category] ドロップダウンから [Environment] オプションを選択します。 [Environment] ページには、アプリの環境の詳細が含まれています。 これには、システム プロパティ、環境変数、構成プロパティ (Spring Boot アプリの application.properties など) が含まれますが、これらに限定されません。

[Environment] ページには、次の機能が含まれています。

  • 検索機能を使用してプロパティまたは値を検索します。
  • 右隅にある検索アイコンを使用して、特定のプロパティのすべての出現箇所を表示します。 検索フィールドに手動で入力しなくても、プロパティ キーをすばやく見つけることができます。 このボタンを選択すると、ページがフィルター処理されて、そのプロパティ名に絞り込まれます。
  • ページの右上隅にある [REFRESH SCOPE] を選択することで、アプリをプローブしてすべての環境プロパティを更新します。
  • 行で [override] を選択し、値を編集することで、既存のプロパティを編集します。 値を保存すると、ページの上部にある [Applied Overrides] セクションに、更新されたプロパティが表示されます。
  • [Reset] を選択することで、環境プロパティを元の状態にリセットします。
  • アプリに新しい環境プロパティを追加し、[Applied Overrides] セクションでオーバーライドされた環境変数を編集または削除します。

[Environment] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

Note

アプリのアプリ構成プロパティで management.endpoint.env.post.enabled=true を設定する必要があり、対応する編集可能な環境がアプリに存在する必要があります。

[Log Levels] ページ

[Log Levels] ページに移動するには、[Information Category] ドロップダウンから [Log Levels] オプションを選択します。 [Log Levels] ページを使用すると、アプリのロガーとそのレベルの構成にアクセスできます。

[Log Levels] ページには、次の機能が含まれています。

  • INFODEBUGTRACE などのログ レベルを UI からリアルタイムで構成します。
  • パッケージを検索し、それぞれのログ レベルを編集します。
  • 特定のクラスとパッケージでログ レベルを構成します。
  • ルート ロガーのログ レベルを OFF に変更することで、すべてのログ レベルを非アクティブ化します。
  • [Changes Only] トグルを使用して、変更されたログ レベルを表示します。
  • 検索機能を使用してロガー名で検索します。
  • [RESET] を選択することで、ログ レベルを元の状態にリセットします。
  • ページの右上隅にある [RESET ALL] を選択することで、すべてのロガーを既定の状態にリセットします。

[Log Levels] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Threads] ページ

[Threads] ページに移動するには、[Information Category] ドロップダウンから [Threads] オプションを選択します。 このページには、JVM スレッドとアプリの実行中のプロセスに関連するすべての詳細が表示されます。 これは、ライブ スレッドとデーモン スレッドをリアルタイムで追跡します。 これは、さまざまなスレッド状態のスナップショットです。

[Threads] ページには、次の機能が含まれています。

  • スレッドの状態に移動して、特定のスレッドとそのスタック トレースに関するすべての情報を表示します。
  • 検索機能を使用して、スレッド ID または状態でスレッドを検索します。
  • 更新アイコンを使用して、スレッドの最新の状態に更新します。
  • スレッド ID を選択することで、スレッドをさらに詳細に表示します。
  • 分析目的でスレッド ダンプをダウンロードします。

[Threads] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

特定のスレッドの詳細を提供するオーバーレイを含む [Threads] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Memory] ページ

[Memory] ページに移動するには、[Information Category] ドロップダウンから [Memory] オプションを選択します。

[Memory] ページは、JVM 内でのメモリ使用量を中心に表示します。 ヒープ内とヒープ以外のさまざまなメモリ領域をグラフィカルに表します。 JVM で実行されている Spring Boot アプリについて、[Memory] ページは JVM 内のデータを視覚化し、Kubernetes ポッド レベルに関する外部情報と対比して、アプリに関するメモリ分析情報を提供します。

[Memory] ページには、次の機能が含まれています。

  • メモリ内のさまざまなスペースの積み重ねられた概要を、使用されたメモリの合計および合計メモリ サイズと合わせて表示するリアルタイム グラフを表示します。
  • GC の一時停止と GC イベントを示すグラフを表示します。
  • 右上隅にある [HEAP DUMP] ボタンを使用して、ヒープ ダンプ データをダウンロードします。

[Memory] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

Note

このグラフィカルな視覚化はリアルタイムで行われ、リアルタイム データのみが表示されます。 前述のように、Application Live View の機能は情報を格納しません。 つまり、グラフは、そのページを表示している間のみ、時間の経過にともなってデータを視覚化します。

[Request Mappings] ページ

[Request Mappings] ページに移動するには、[Information Category] ドロップダウンから [Request Mappings] オプションを選択します。 このページは、アプリの要求マッピングに関する情報を提供します。 マッピングごとに、ページに要求ハンドラー メソッドが表示されます。

[Request Mappings] ページには、次の機能が含まれています。

  • マッピングを選択することで、producesconsumesHTTP メソッドをはじめとするアプリのヘッダー メタデータなどの、要求マッピングの詳細を表示します。
  • 要求マッピングまたはメソッドを検索します。
  • トグル [/actuator/** Request Mappings] を使用することで、アプリのアクチュエータ関連のマッピングを表示します。

Note

アプリのアクチュエータ エンドポイントが management.server.port で公開されていると、アプリはコンテキスト内のアクチュエータ要求マッピング データを返しません。 この場合、アクチュエータ トグルを有効にするとメッセージが表示されます。

[Request Mappings] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

特定の要求に関する詳細を提供するオーバーレイ ペインを含む [Request Mappings] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[HTTP Requests] ページ

[HTTP Requests] ページに移動するには、[Information Category] ドロップダウンから [HTTP Requests] オプションを選択します。 [HTTP Requests] ページは、アプリへの HTTP 要求と応答の交換に関する情報を提供します。 グラフは、すべての要求の応答状態を示す 1 秒あたりの要求数を視覚化します。

[HTTP Requests] ページには、次の機能が含まれています。

  • infosuccessredirectsclient-errorsserver-errors などの応答の状態でフィルター処理します。
  • タイムスタンプ、メソッド、パス、状態、コンテンツタイプ、長さ、時間などのメトリックを使用して、トレース データを表形式で詳細に表示します。
  • 表に対する検索機能を使用して、検索フィールドの値に基づいてトレースをフィルター処理します。
  • タイムスタンプを選択することで、アプリのメソッド、ヘッダー、応答などの要求をさらに詳細に表示します。
  • グラフの上にある更新アイコンを選択して、アプリの最新のトレースを読み込みます。
  • ページの右上隅にあるトグル [/actuator/**] を使用して、アプリのアクチュエータ関連トレースを表示します。

Note

アプリのアクチュエータ エンドポイントが management.server.port で公開されていると、アプリのアクチュエータ HTTP トレース データは返されません。 この場合、アクチュエータ トグルを有効にするとメッセージが表示されます。

[HTTP Requests] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

特定の要求に関する詳細を提供するオーバーレイを含む [HTTP Requests] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Caches] ページ

[Caches] ページに移動するには、[Information Category] ドロップダウンから [Caches] オプションを選択します。 [Caches] ページを使用すると、アプリのキャッシュにアクセスできます。 アプリに関連付けられているキャッシュ マネージャーの詳細 (ネイティブ キャッシュの完全修飾名など) が表示されます。

[Caches] ページには、次の機能が含まれています。

  • 検索機能を使用して、特定のキャッシュまたはキャッシュ マネージャーを検索します。
  • キャッシュをクリアする [EVICT] を選択することで、個々のキャッシュを削除します。
  • [EVICT ALL] を選択することで、すべてのキャッシュを削除します。 アプリのキャッシュ マネージャーがない場合は、メッセージ No cache managers available for the application が表示されます。

[HTTP Caches] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Configuration Properties] ページ

[Configuration Properties] ページに移動するには、[Information Category] ドロップダウンから [Configuration Properties] オプションを選択します。 [Configuration Properties] ページは、アプリの構成プロパティに関する情報を提供します。 Spring Boot について、アプリの @ConfigurationProperties Bean を表示します。 すべての Bean とそれに関連付けられている構成プロパティのスナップショットを提供します。

[Configuration Properties] ページには、次の機能が含まれています。

  • 検索機能を使用して、プロパティまたは Bean 名のキーと値を検索します。

[Configuration Properties] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Conditions] ページ

[Conditions] ページに移動するには、[Information Category] ドロップダウンから [Conditions] オプションを選択します。 条件評価レポートは、構成と自動構成のクラスの条件の評価に関する情報を提供します。 Spring Boot について、条件評価レポートは、アプリで構成されているすべての Bean を明確に表示します。

[Conditions] ページには、次の機能が含まれています。

  • Bean 名を選択して、条件と条件一致の理由を表示します。 Bean が構成されていない場合は、Bean の一致と不一致の両方の条件を表示します (存在する場合)。 条件に加えて、無条件の自動構成クラスの名前も表示します (存在する場合)。
  • 検索機能を使用して、Bean と条件をフィルター処理します。

[Conditions] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Scheduled Tasks] ページ

[Scheduled Tasks] ページに移動するには、[Information Category] ドロップダウンから [Scheduled Tasks] オプションを選択します。 [Scheduled Tasks] ページは、アプリのスケジュール済みタスクに関する情報 (cron タスク、固定遅延タスク、固定レート タスク、カスタム タスク、およびそれらに関連付けられているプロパティなど) を提供します。

[Scheduled Tasks] ページには、次の機能が含まれています。

  • 検索バーで特定のプロパティまたはタスクを検索して、タスクまたはプロパティの詳細を取得します。

[Scheduled Tasks] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Beans] ページ

[Beans] ページに移動するには、[Information Category] ドロップダウンから [Beans] オプションを選択します。 [Beans] ページは、すべてのアプリ Bean とその依存関係の一覧に関する情報を提供します。 これは、Bean の種類、依存関係、およびそのリソースに関する情報を表示します。

[Beans] ページには、次の機能が含まれています。

  • Bean 名またはそれに対応するフィールドで検索します。

[Beans] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Metrics] ページ

[Metrics] ページに移動するには、[Information Category] ドロップダウンから [Metrics] オプションを選択します。 [Metrics] ページを使用すると、アプリのメトリック情報にアクセスできます。

[Metrics] ページには、次の機能が含まれています。

  • アプリで使用できるさまざまなメトリック (jvm.memory.usedjvm.memory.maxhttp.server.request など) の一覧から選択します。 メトリックを選択すると、それに関連付けられているタグを表示できます。
  • フィルター条件に基づいて、各タグの値を選択します。
  • [ADD METRIC] を選択してメトリックを追加します。これは既定で 5 秒ごとに更新されます。
  • [Auto Refresh] トグルを無効にすることで、自動更新機能を一時停止します。
  • [REFRESH ALL] を選択することで、メトリックを手動で更新します。
  • 必要に応じてメトリック値の形式を変更します。
  • 同じ行のマイナス記号を選択することで、特定のメトリックを削除します。

[Metrics] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

[Actuator] ページ

[Actuator] ページに移動するには、[Information Category] ドロップダウンから [Actuator] オプションを選択します。 [Actuator] ページは、アクチュエータ データのツリー ビューを提供します。

[Actuator] ページには、次の機能が含まれています。

  • アクチュエータ エンドポイントの一覧から選択して、生のアクチュエータ データを解析します。

[Actuator] ページを表示するアプリケーション ライブ ビューのスクリーンショット。

次のステップ