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]
swift-recon(1) OpenStack Swift swift-recon(1)
NAME
swift-recon - OpenStack Swift recon middleware cli tool
SYNOPSIS
swift-recon <server_type> [-v] [--suppress] [-a] [-r] [-u] [-d] [-l]
[-T] [--md5] [--auditor] [--updater] [--expirer] [--sockstat]
DESCRIPTION
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.
OPTIONS
<server_type>
account|container|object - Defaults to object server.
-h, --help
show this help message and exit
-v, --verbose
Print verbose information
--suppress
Suppress most connection related errors
-a, --async
Get async stats
--auditor
Get auditor stats
--updater
Get updater stats
--expirer
Get expirer stats
-r, --replication
Get replication stats
-u, --unmounted
Check cluster for unmounted devices
-d, --diskusage
Get disk usage stats
--top=COUNT
Also show the top COUNT entries in rank order
--lowest=COUNT
Also show the lowest COUNT entries in rank order
--human-readable
Use human readable suffix for disk usage stats
-l, --loadstats
Get cluster load average stats
-q, --quarantined
Get cluster quarantine stats
--validate-servers
Validate servers on the ring
--md5 Get md5sum of servers ring and compare to local copy
--sockstat
Get cluster socket usage stats
--driveaudit
Get drive audit error stats
-T, --time
Check time synchronization
--all Perform all checks. Equivalent to -arudlqT --md5 --sockstat
--auditor --updater --expirer --driveaudit --validate-servers
--region=REGION
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
--swiftdir=PATH
Default = /etc/swift
EXAMPLE
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
DOCUMENTATION
More documentation about OpenStack Swift can be found at
http://swift.openstack.org/index.html Also more specific documentation
about swift-recon can be found at http://swift.open-
stack.org/admin_guide.html#cluster-telemetry-and-monitoring
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | cloud/openstack/swift |
+---------------+-----------------------+
|Stability | Uncommitted |
SEE ALSO---------------+-----------------------+
object-server.conf(4)
NOTES
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://tarballs.open-
stack.org/swift/swift-2.7.0.tar.gz
Further information about this software can be found on the open source
community website at http://www.openstack.org/.
OpenStack 8/26/2011 swift-recon(1)