9.2. 統計、メトリック、および JMX の設定
DataGrid が MicroProfileMetrics エンドポイントまたは Data Grid を介してエクスポートする統計を有効にします。JMX MBean を登録することで、管理操作を実施することもできます。
9.2.1. Data Grid 統計の有効化 リンクのコピーリンクがクリップボードにコピーされました!
Data Grid を使用すると、キャッシュマネージャーとキャッシュの統計を有効にすることができます。ただし、キャッシュマネージャーの統計を有効にしても、キャッシュマネージャーが制御するキャッシュの統計は有効になりません。キャッシュの統計を明示的に有効にする必要があります。
Data Grid サーバーは、デフォルトでキャッシュマネージャーの統計を有効にします。
手順
- 統計を宣言的またはプログラムで有効にします。
宣言的に
<cache-container statistics="true"> <local-cache name="mycache" statistics="true"/> </cache-container>
<cache-container statistics="true">
<local-cache name="mycache" statistics="true"/>
</cache-container>
プログラムで
9.2.2. Data Grid メトリックの有効化 リンクのコピーリンクがクリップボードにコピーされました!
Data Grid を設定して、ゲージとヒストグラムをエクスポートします。
手順
- メトリックを宣言的またはプログラム的に設定する。
宣言的に
<cache-container statistics="true"> <metrics gauges="true" histograms="true" /> </cache-container>
<cache-container statistics="true">
<metrics gauges="true" histograms="true" />
</cache-container>
プログラムで
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder() .statistics().enable() .metrics().gauges(true).histograms(true) .build();
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
.statistics().enable()
.metrics().gauges(true).histograms(true)
.build();
9.2.3. Data Grid メトリックの収集 リンクのコピーリンクがクリップボードにコピーされました!
Prometheus などのモニタリングツールを使用して、Data Grid メトリクスを収集します。
前提条件
-
統計を有効にします。統計を有効にしないと、Data Grid はメトリックに
0
と-1
の値を指定します。 - 必要に応じて、ヒストグラムを有効にします。デフォルトでは、Data Grid はゲージを生成しますが、ヒストグラムは生成しません。
手順
Prometheus (OpenMetrics) 形式でメトリックを取得します。
curl -v http://localhost:11222/metrics
$ curl -v http://localhost:11222/metrics
Copy to Clipboard Copied! Toggle word wrap Toggle overflow MicroProfile JSON 形式でメトリックを取得します。
curl --header "Accept: application/json" http://localhost:11222/metrics
$ curl --header "Accept: application/json" http://localhost:11222/metrics
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
次のステップ
Data Grid メトリクスを収集するようにモニタリングアプリケーションを設定します。たとえば、以下を prometheus.yml
に追加します。
static_configs: - targets: ['localhost:11222']
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" /> </cache-container>
<cache-container>
<jmx enabled="true" />
</cache-container>
- 1
- Data Grid JMX MBean を登録します。
プログラムで
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder() .jmx().enable() .build();
GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
.jmx().enable()
.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 のドキュメントを参照してください。