How to list GlusterFS volume options

Listing GlusterFS volume options exposes the effective tunables applied to a volume, which helps explain changes in performance, healing behavior, and client-side consistency across a cluster.

A GlusterFS volume maintains an option dictionary managed by glusterd, and the gluster CLI reads that dictionary with gluster volume get to report option keys (such as performance.* or cluster.*) with their current values.

Option output depends on volume type and which keys were explicitly set; keys not listed are generally using built-in defaults or inherited settings for the running version. Run the commands from a trusted node with management access and treat copied option listings as operational metadata when sharing logs or documentation.

1. List volumes to confirm the target volume name.

   $ sudo gluster volume list
   volume1
   volume2

2. Show all configured option keys and values for the volume.

   $ sudo gluster volume get volume1 all
   Option                                  Value
   ------                                  -----
   cluster.granular-entry-heal             on
   features.quota                          off
   performance.client-io-threads           on
   performance.readdir-ahead               on
   transport.address-family                inet
   ##### snipped #####

   Keys not present in the output are generally using defaults for the running GlusterFS version and volume type.

3. Filter the option list to a prefix when checking a category of settings.

   $ sudo gluster volume get volume1 all | grep '^performance\.'
   performance.client-io-threads           on
   performance.readdir-ahead               on

   Replace performance. with features. or cluster. to narrow output by subsystem.

4. Query a single option to confirm its current value.

   $ sudo gluster volume get volume1 performance.readdir-ahead
   Option                                  Value
   ------                                  -----
   performance.readdir-ahead               on