show

Display deadlocks, logs, metrics and missing disk-stores.

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
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]
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. If the parameter is not specified, the default is 30.
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)*]
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     | activeCQCount         | 0
          | 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]
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