Monitoring the global cache

You can use resource statistics and the activity log to monitor any global cache (embedded global cache, external Redis global cache, or external WebSphere® eXtreme Scale (WXS) grid). You can also use the mqsicacheadmin command to monitor the embedded WXS grid.

About this task

The following tools provide information about the global cache and how it is performing.

Activity log: Activity logs provide a high-level overview of how IBM® App Connect Enterprise interacts with external resources, therefore helping you to understand what your message flows are doing. See Viewing activity logs for message flows in the web user interface.
Resource statistics: Resource statistics are collected by an integration server to record performance and operating details of the resources that it uses. See Managing resource statistics collection.
ibmint display cache command: The ibmint display cache command provides information about the embedded global cache.
mqsicacheadmin command: The mqsicacheadmin command provides information about an embedded WXS grid. For example, you can find out the size of a map and list the hosts that are participating in the grid. See Running the mqsicacheadmin command.

Running the mqsicacheadmin command

Procedure

To use the command to find information about the global cache that is embedded in an integration server, complete the following steps.

Before you run the mqsicacheadmin command, ensure that the integration server is running and that the global cache is available.

The cache is disabled by default. To use the cache, set the properties in the Global Cache section of the server.conf.yaml configuration file for the integration server.
Run the mqsicacheadmin command, specifying the appropriate parameters, as described in mqsicacheadmin command. Use the -c parameter to run a WebSphere eXtreme Scale command.
For example, to list all container servers and their shards in the embedded cache, run the WebSphere eXtreme Scale command, showPlacement:
```
mqsicacheadmin myIntegrationNode -c showPlacement
```
To clear all data from the map called myMap in the integration node myIntegrationNode, run the following command:
```
mqsicacheadmin myIntegrationNode -c clearGrid -m myMap
```
The data is cleared immediately; you do not need to restart the integration node for this action to take effect.
You do not have to specify an integration node name with this command. For example, use the -cep parameter to connect to a catalog server and show the routing table for each WebSphere eXtreme Scale shard:
```
mqsicacheadmin -cep server.company.com:2800 -c routetable
```
The -cep parameter specifies the catalog service endpoints, and you can use this parameter to specify a comma-separated list of catalog servers; the first valid server to be contacted will be used.
Examine the output and usage information that is returned by the command.