Apache Geode CHANGELOG

show

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

show dead-locks

Display any deadlocks in the cluster.

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

Syntax:

show dead-locks --file=value

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

Table 1. Show Dead-Locks Parameters

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]

Name Description Default 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. 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.0.2.0> 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.0.2.0> 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.0.2.0> 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 cluster, a member, or a region.

When no command line arguments are given, metrics under the categories of cluster, cache, diskstore, and query are displayed.

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. Show Metrics 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:
  • region specified: cluster, region, partition, diskstore, callback, eviction
  • member specified: member, jvm, region, serialization, communication, function, transaction, diskstore, lock, eviction, distribution, offheap
  • member and region specified: region, partition, diskstore, callback, eviction

Table 3. Show Metrics Parameters

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 the cluster.

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
 [--members=value(,value)*] [--groups=value(,value)*]

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

Table 4. Show Subscription-Queue-Size Parameters

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