show

Display deadlocks, logs, metrics, missing disk-stores and subcription queue sizes.

show dead-locks

Display any deadlocks in the GemFire distributed system.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

show dead-locks --file=value

Table 1. Parameters
Name	Description
--file	Required. Name of the file to which dependencies between members will be written.

Example Commands:

show dead-locks --file=deadlocks.txt

Sample Output:

gfsh>show dead-locks --file=deadlocks.txt
No dead lock detected.

Please view the dependencies between the members in file : deadlocks.txt

show log

Display the log for a member.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

show log --member=value [--lines=value]

Table 2. Parameters
Name	Description
--member	Required. Name/ID of the member whose log file will be displayed.
--lines	Number of lines from the log file to display. The maximum is 100.	0

Example Commands:

show log --member=locator1 --lines=5

Sample Output:

gfsh>show log --member=locator1 --lines=5
SystemLog:
[info 2012/09/25 14:04:51.340 PDT locator1 <RMI TCP Connection(14)-192.168.129.1
29> tid=0x57] (tid=12 msgId=4) Parent region for "region1/subregion1" doesnt exi
st.

[info 2012/09/25 14:04:51.372 PDT locator1 <RMI TCP Connection(14)-192.168.129.1
29> tid=0x57] (tid=12 msgId=5) Error occurred while executing "create region --n
ame=region1/subregion1 --type=LOCAL".

[info 2012/09/25 15:14:34.314 PDT locator1 <RMI TCP Connection(159)-192.168.129.
129> tid=0x68] (tid=13 msgId=6) Error occurred while executing "show log --membe
r=server1 --lines=5".

show metrics

Display or export metrics for the entire distributed system, a member or a region.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

show metrics [--member=value] [--region=value] [--file=value] 
[--port=value] [--categories=value(,value)*]

Table 3. Parameters
Name	Description
--member	Name/ID of the member whose metrics will be displayed/exported.
--region	Name/Path of the region whose metrics will be displayed/exported.
--file	Name of the file to which metrics will be written.
--port	Port number of the Cache Server whose metrics are to be displayed/exported. This can only be used along with the `--member` parameter.
--categories	Categories available based upon the parameters specified (listed above) are: no parameters specified: cluster, cache, diskstore, query region specified: cluster, region, partition, diskstore, callback, eviction member specified: member, jvm, region, serialization, communication, function, transaction, diskstore, lock, eviction, distribution member and region specified: region, partition, diskstore, callback, eviction

Example Commands:

// Metrics for the entire system
show metrics 
// Metrics for a region:
show metrics --region=region1
// Metrics for a given member
show metrics --member=server1
// Metrics for a region on a member
show metrics --region=region1 --member=server1
//  Metrics for a member and the cacheserver it hosts
// NOTE: port option only work when used with --member option
show metrics --member=server1 --port=10334
// Export metrics for the entire system
show metrics --file=data/stats/system-stats.csv

Sample Output:

gfsh>show metrics

Cluster-wide Metrics

  Type    |        Metric         | Value
--------- | --------------------- | -----
cluster   | totalHeapSize         | 123
cache     | totalRegionEntryCount | 0
          | totalRegionCount      | 0
          | totalMissCount        | 0
          | totalHitCount         | 0
diskstore | totalBytesOnDisk      | 0
          | diskReadsRate         | 0
          | diskWritesRate        | 0
          | flushTimeAvgLatency   | 0
          | totalBackupInProgress | 0
query     | queryRequestRate      | 0

show missing-disk-stores

Display a summary of the disk stores that are currently missing from a distributed system.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

show missing-disk-stores

Example Commands:

show missing-disk-stores

Sample Output:

gfsh> show missing-disk-stores

           Disk Store ID             |   Host    |               Directory                                           
------------------------------------ | --------- | -------------------------------------
60399215-532b-406f-b81f-9b5bd8d1b55a | excalibur | /usr/local/gemfire/deploy/disk_store1

show subscription-queue-size

Shows the number of events in the subscription queue.

If a CQ name is provided, it counts the number of events in the subscription queue for the specified CQ.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:

show subscription-queue-size --durable-client-Id=value 
[--durable-cq-name=value] [--member=value] [--group=value]

Table 4. Parameters
Name	Description
--durable-client-id	Required. The ID used to identify the durable client.
--durable-cq-name	The name that identifies the CQ.
--member	Name/Id of the member for which subscription queue events are to be counted.
--group	Group of members for which subscription queue events are to be counted.

Example Commands:

show subscription-queue-size --durable-client-id=client1

Sample Output:

gfsh>show subscription-queue-size --durable-client-Id=client1
member  | subcription-queue-size for durable-client : "client1".
------- | ------------------------------------------------------
server3 | 1
server4 | 0

Error Messages:

gfsh>show subscription-queue-size --durable-client-Id=client1

No client found with client-id : client1
Occurred on members
1.server4
2.server1
3.server3