Chapter 6. Configuring Statistics, Metrics, and JMX

6.1. Enabling Data Grid Statistics
复制链接

Data Grid lets you enable statistics for Cache Managers and specific cache instances.

Note

Data Grid servers provide default infinispan.xml configuration files that enable statistics for Cache Managers. If you use the default Data Grid server configuration, you only need to enable statistics when you configure caches.

Procedure

Enable statistics declaratively or programmatically.

Declaratively

<cache-container statistics="true"> 
  <local-cache name="mycache" statistics="true"/> 
</cache-container>

<cache-container statistics="true">

1


  <local-cache name="mycache" statistics="true"/>

2


</cache-container>

Copy to Clipboard

Toggle word wrap

1: collects statistics about the Cache Manager.
2: collects statistics about the named cache.

Programmatically

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .cacheContainer().statistics(true) 
  .build();

 ...

Configuration config = new ConfigurationBuilder()
  .statistics().enable() 
  .build();

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .cacheContainer().statistics(true)

1


  .build();

 ...

Configuration config = new ConfigurationBuilder()
  .statistics().enable()

2


  .build();

Copy to Clipboard

Toggle word wrap

1: collects statistics about the Cache Manager.
2: collects statistics about the named cache.

Note

Enabling statistics for Cache Managers does not globally enable statistics for caches. This configuration only collects statistics for the Cache Manager.

6.2. Enabling Data Grid Metrics
复制链接

Data Grid is compatible with the Eclipse MicroProfile Metrics API and can generate gauge and histogram metrics.

Data Grid metrics are provided at the vendor scope. Metrics related to the JVM are provided in the base scope for Data Grid server.
Gauges provide values such as the average number of nanoseconds for write operations or JVM uptime. Gauges are enabled by default. If you enable statistics, Data Grid automatically generates gauges.
Histograms provide details about operation execution times such as read, write, and remove times. Data Grid does not enable histograms by default because they require additional computation.

Procedure

Configure metrics declaratively or programmatically.

Declaratively

<cache-container statistics="true"> 
  <metrics gauges="true" histograms="true" /> 
</cache-container>

<cache-container statistics="true">

1


  <metrics gauges="true" histograms="true" />

2


</cache-container>

Copy to Clipboard

Toggle word wrap

Programmatically

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .statistics().enable() 
  .metrics().gauges(true).histograms(true) 
  .build();

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .statistics().enable()

1


  .metrics().gauges(true).histograms(true)

2


  .build();

Copy to Clipboard

Toggle word wrap

1 1: computes and collects statistics about the Cache Manager.
2 2: exports collected statistics as gauge and histogram metrics.

Reference

6.3. Enabling and Configuring JMX
复制链接

You can enable JMX with Data Grid servers to collect statistics and perform administrative operations.

Note

You can enable JMX without enabling statistics if you want to use management operations only. In this case, Data Grid provides 0 values for all statistics.

Procedure

Enable JMX declaratively or programmatically.

Declaratively

<cache-container>
  <jmx enabled="true" /> 
</cache-container>

<cache-container>
  <jmx enabled="true" />

1


</cache-container>

Copy to Clipboard

Toggle word wrap

Programmatically

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .jmx().enable() 
  .build();

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .jmx().enable()

1


  .build();

Copy to Clipboard

Toggle word wrap

1 1: registers Data Grid JMX MBeans.

Reference

Enabling Data Grid Statistics

6.3.1. Naming Multiple Cache Managers
复制链接

In cases where multiple Data Grid Cache Managers run on the same JVM, you should uniquely identify each Cache Manager to prevent conflicts.

Procedure

Uniquely identify each cache manager in your environment.

For example, the following examples specify "Hibernate2LC" as the cache manager name, which results in a JMX MBean named org.infinispan:type=CacheManager,name="Hibernate2LC".

Declaratively

<cache-container name="Hibernate2LC">
  <jmx enabled="true" />
  ...
</cache-container>

<cache-container name="Hibernate2LC">
  <jmx enabled="true" />
  ...
</cache-container>

Copy to Clipboard

Toggle word wrap

Programmatically

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .cacheManagerName("Hibernate2LC")
  .jmx().enable()
  .build();

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .cacheManagerName("Hibernate2LC")
  .jmx().enable()
  .build();

Copy to Clipboard

Toggle word wrap

Reference

6.3.2. Registering MBeans In Custom MBean Servers
复制链接

Data Grid includes an MBeanServerLookup interface that you can use to register MBeans in custom MBeanServer instances.

Procedure

Create an implementation of MBeanServerLookup so that the getMBeanServer() method returns the custom MBeanServer instance.
Configure Data Grid with the fully qualified name of your class, as in the following example:

Declaratively

<cache-container>
   <jmx enabled="true" mbean-server-lookup="com.acme.MyMBeanServerLookup" />
</cache-container>

<cache-container>
   <jmx enabled="true" mbean-server-lookup="com.acme.MyMBeanServerLookup" />
</cache-container>

Copy to Clipboard

Toggle word wrap

Programmatically

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .jmx().enable().mBeanServerLookup(new com.acme.MyMBeanServerLookup())
  .build();

GlobalConfiguration globalConfig = new GlobalConfigurationBuilder()
  .jmx().enable().mBeanServerLookup(new com.acme.MyMBeanServerLookup())
  .build();

Copy to Clipboard

Toggle word wrap

Reference

6.3.3. Data Grid MBeans
复制链接

Data Grid exposes JMX MBeans that represent manageable resources.

org.infinispan:type=Cache: Attributes and operations available for cache instances.
org.infinispan:type=CacheManager: Attributes and operations available for cache managers, including Data Grid cache and cluster health statistics.

For a complete list of available JMX MBeans along with descriptions and available operations and attributes, see the Data Grid JMX Components documentation.

Reference

Data Grid JMX Components

此内容没有您所选择的语言版本。

6.1. Enabling Data Grid Statistics
复制链接

6.2. Enabling Data Grid Metrics
复制链接

6.3. Enabling and Configuring JMX
复制链接

6.3.1. Naming Multiple Cache Managers
复制链接

6.3.2. Registering MBeans In Custom MBean Servers
复制链接

6.3.3. Data Grid MBeans
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

此内容没有您所选择的语言版本。

Chapter 6. Configuring Statistics, Metrics, and JMX

6.1. Enabling Data Grid Statistics复制链接链接已复制到粘贴板!

6.2. Enabling Data Grid Metrics复制链接链接已复制到粘贴板!

6.3. Enabling and Configuring JMX复制链接链接已复制到粘贴板!

6.3.1. Naming Multiple Cache Managers复制链接链接已复制到粘贴板!

6.3.2. Registering MBeans In Custom MBean Servers复制链接链接已复制到粘贴板!

6.3.3. Data Grid MBeans复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

6.1. Enabling Data Grid Statistics
复制链接

6.2. Enabling Data Grid Metrics
复制链接

6.3. Enabling and Configuring JMX
复制链接

6.3.1. Naming Multiple Cache Managers
复制链接

6.3.2. Registering MBeans In Custom MBean Servers
复制链接

6.3.3. Data Grid MBeans
复制链接