9.2. 統計、メトリック、および JMX の設定
DataGrid が MicroProfileMetrics エンドポイントまたは Data Grid を介してエクスポートする統計を有効にします。JMX MBean を登録することで、管理操作を実施することもできます。
9.2.1. Data Grid 統計の有効化
Data Grid を使用すると、キャッシュマネージャーとキャッシュの統計を有効にすることができます。ただし、キャッシュマネージャーの統計を有効にしても、キャッシュマネージャーが制御するキャッシュの統計は有効になりません。キャッシュの統計を明示的に有効にする必要があります。
Data Grid サーバーは、デフォルトでキャッシュマネージャーの統計を有効にします。
手順
- 統計を宣言的またはプログラムで有効にします。
宣言的に
<cache-container statistics="true"> 1 <local-cache name="mycache" statistics="true"/> 2 </cache-container>
プログラムで
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder() .cacheContainer().statistics(true) 1 .build(); ... Configuration config = new ConfigurationBuilder() .statistics().enable() 2 .build();
9.2.2. Data Grid メトリックの有効化
Data Grid を設定して、ゲージとヒストグラムをエクスポートします。
手順
- メトリックを宣言的またはプログラム的に設定する。
宣言的に
<cache-container statistics="true"> 1 <metrics gauges="true" histograms="true" /> 2 </cache-container>
プログラムで
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder() .statistics().enable() 1 .metrics().gauges(true).histograms(true) 2 .build();
9.2.3. Data Grid メトリックの収集
Prometheus などのモニタリングツールを使用して、Data Grid メトリクスを収集します。
前提条件
-
統計を有効にします。統計を有効にしないと、Data Grid はメトリックに
0と-1の値を指定します。 - 必要に応じて、ヒストグラムを有効にします。デフォルトでは、Data Grid はゲージを生成しますが、ヒストグラムは生成しません。
手順
Prometheus (OpenMetrics) 形式でメトリックを取得します。
$ curl -v http://localhost:11222/metrics
MicroProfile JSON 形式でメトリックを取得します。
$ curl --header "Accept: application/json" http://localhost:11222/metrics
次のステップ
Data Grid メトリクスを収集するようにモニタリングアプリケーションを設定します。たとえば、以下を prometheus.yml に追加します。
static_configs:
- targets: ['localhost:11222']参照資料
- Prometheus Configuration
- Data Grid 統計の有効化
9.2.4. JMX MBean を登録するための Data Grid の設定
Data Grid は、統計の収集と管理操作の実行に使用できる JMX MBean を登録できます。ただし、JMX とは別に統計を有効にする必要があります。そうしなければ、Data Grid はすべての統計属性に 0 の値を提供します。
手順
- JMX を宣言的またはプログラム的に有効にします。
宣言的に
<cache-container>
<jmx enabled="true" /> 1
</cache-container>
- 1
- Data Grid JMX MBean を登録します。
プログラムで
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
.jmx().enable() 1
.build();
- 1
- Data Grid JMX MBean を登録します。
9.2.4.1. Data Grid MBean
Data Grid は、管理可能なリソースを表す JMX MBean を公開します。
org.infinispan:type=Cache- キャッシュインスタンスに使用できる属性および操作。
org.infinispan:type=CacheManager- Data Grid キャッシュやクラスターのヘルス統計など、Cache Manager で使用できる属性および操作。
使用できる JMX MBean の詳細なリストおよび説明、ならびに使用可能な操作および属性については、Data Grid JMX Components のドキュメントを参照してください。
