Azure Container Apps の Java アプリ用 Java メトリック

[アーティクル]
10/14/2024

Java 仮想マシン (JVM) メトリックは、Java アプリケーションの正常性とパフォーマンスを監視するのに不可欠です。収集されるデータには、JVM のメモリ使用量、ガベージコレクション、スレッド数に関する分析情報が含まれます。次のメトリックを使用すると、アプリケーションの正常性と安定性を確保するのに役立ちます。

収集されるメトリック

カテゴリ	タイトル	説明	メトリック ID	出荷単位
Java	`jvm.memory.total.used`	ヒープまたは非ヒープによって使用されるメモリの合計量	`JvmMemoryTotalUsed`	バイト
Java	`jvm.memory.total.committed`	ヒープまたは非ヒープで使用できるようになることが保証されているメモリの合計量	`JvmMemoryTotalCommitted`	バイト
Java	`jvm.memory.total.limit`	ヒープまたは非ヒープの最大取得可能メモリの合計量	`JvmMemoryTotalLimit`	バイト
Java	`jvm.memory.used`	各プールで使用されるメモリの量	`JvmMemoryUsed`	バイト
Java	`jvm.memory.committed`	各プールで使用できるようになることが保証されているメモリの量	`JvmMemoryCommitted`	バイト
Java	`jvm.memory.limit`	各プールの最大取得可能メモリの量	`JvmMemoryLimit`	バイト
Java	`jvm.buffer.memory.usage`	バッファー (ダイレクトメモリなど) で使用されるメモリの量	`JvmBufferMemoryUsage`	バイト
Java	`jvm.buffer.memory.limit`	バッファーの合計メモリ容量	`JvmBufferMemoryLimit`	バイト
Java	`jvm.buffer.count`	メモリプール内のバッファーの数	`JvmBufferCount`	該当なし
Java	`jvm.gc.count`	JVM ガベージコレクションアクションの数	`JvmGcCount`	該当なし
Java	`jvm.gc.duration`	JVM ガベージコレクションアクションの期間	`JvmGcDuration`	ミリ秒
Java	`jvm.thread.count`	実行されるプラットフォームスレッドの数	`JvmThreadCount`	該当なし

構成

アプリで Java メトリックのコレクションを使用可能にするには、特定の設定でコンテナーアプリを構成します。

create
update

[作成] ウィンドウの [展開元] に [コンテナーイメージ] のオプションを選択した場合は、スタック固有の機能にアクセスできます。

[開発スタック固有の機能] で、[開発スタック] として [Java] を選択します

Java 開発スタックを選択すると、[お客様のアプリ用に Java 機能をカスタマイズする] ウィンドウが表示されます。 [Java の特徴] ラベルの横にある [ JVM コアメトリクス] を選択します。

アプリランタイムと Java メトリックに関連する CLI オプションは次の 2 つです。

オプション	説明
`--runtime`	コンテナーアプリのランタイム。サポートされている値は、`generic` および `java` です。
`--enable-java-metrics`	アプリの Java メトリックを有効または無効にするブール値のオプション。 Java ランタイムにのみ適用できます。

Note

--enable-java-metrics=<true|false> パラメーターは暗黙的に --runtime=java を設定します。 --runtime=generic パラメーターはすべての Java ランタイム情報をリセットします。

Java メトリックを有効にする

Java メトリックは、create または update コマンドのいずれかを使用して有効にできます。

create
update

az containerapp create \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --image <CONTAINER_IMAGE_LOCATION> \
  --enable-java-metrics=true

az containerapp update \ 
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --enable-java-metrics=true

Java メトリックを無効にする

Java メトリックは、up コマンドを使用して無効にできます。

az containerapp up \ 
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --enable-java-metrics=false

Note

Java メトリックフラグを更新すると、コンテナーアプリが再起動されます。

Java メトリックを表示する

次の手順に従って、コンテナーアプリのメトリックの視覚化を表示します。

Azure ポータルにアクセスします。
コンテナーアプリに移動します。
[監視] セクションで、 [メトリック] を選択します。

そこから、アプリケーションで追跡しているメトリックをプロットするグラフが表示されます。

Azure Monitor に Java メトリック名は表示されますが、データセットは、機能が有効になっていない限り空として表示されます。有効にする方法については、構成のセクションを参照してください。

次のステップ

Log Analytics を使用してログを監視する

次の方法で共有