This topic describes the show command in gfsh, the VMware Tanzu GemFire command-line interface.
Use this command to display deadlocks, logs, metrics, and missing disk-stores.
-
Display any deadlocks in the cluster.
-
Display the log for a member.
-
Display or export metrics for the entire cluster, a member, or a region.
-
Display a summary of the disk stores that are currently missing from the cluster.
-
Shows the number of events in the subscription queue.
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)*]
| 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:
|
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 members for which subscription queue events are to be counted. |
| ‑‑groups | Groups 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
