Provided by: swift_2.21.0-0ubuntu1_all bug


       swift-recon - OpenStack Swift recon middleware cli tool


       swift-recon   <server_type>  [-v]  [--suppress]  [-a]  [-r]  [-u]  [-d]  [-l] [-T] [--md5]
       [--auditor] [--updater] [--expirer] [--sockstat]


       The swift-recon cli tool can be used to retrieve various metrics and telemetry information
       about a cluster that has been collected by the swift-recon middleware.

       In order to make use of the swift-recon middleware, update the object-server.conf file and
       enable the recon middleware by adding a pipeline entry and setting its option(s). You  can
       view more information in the example section below.


              account|container|object - Defaults to object server.

       -h, --help
              show this help message and exit

       -v, --verbose
              Print verbose information

              Suppress most connection related errors

       -a, --async
              Get async stats

              Get auditor stats

              Get updater stats

              Get expirer stats

       -r, --replication
              Get replication stats

       -u, --unmounted
              Check cluster for unmounted devices

       -d, --diskusage
              Get disk usage stats

              Also show the top COUNT entries in rank order

              Also show the lowest COUNT entries in rank order

              Use human readable suffix for disk usage stats

       -l, --loadstats
              Get cluster load average stats

       -q, --quarantined
              Get cluster quarantine stats

              Validate servers on the ring

       --md5  Get md5sum of servers ring and compare to local copy

              Get cluster socket usage stats

              Get drive audit error stats

       -T, --time
              Check time synchronization

              Check swift version

       --all  Perform  all  checks.  Equivalent  to -arudlqT --md5 --sockstat --auditor --updater
              --expirer --driveaudit --validate-servers --swift-versions

              Only query servers in specified region

       -z ZONE, --zone=ZONE
              Only query servers in specified zone

       -t SECONDS, --timeout=SECONDS
              Time to wait for a response from a server

              Default = /etc/swift


       ubuntu:~$ swift-recon -q --zone 3
       [2011-10-18 19:36:00] Checking quarantine dirs on 1 hosts...
       [Quarantined objects] low: 4, high: 4, avg: 4, total: 4
       [Quarantined accounts] low: 0, high: 0, avg: 0, total: 0
       [Quarantined containers] low: 0, high: 0, avg: 0, total: 0

       Finally if you also wish to track asynchronous pending's you will need to setup a  cronjob
       to run the swift-recon-cron script periodically:

       */5 * * * * swift /usr/bin/swift-recon-cron /etc/swift/object-server.conf


       More      documentation      about     OpenStack     Swift     can     be     found     at Also more  specific  documentation  about  swift-
       recon can be found at