14
pt-diskstats - Read a file generated from /proc/diskstats and summarize it.
22
Usage: pt-diskstats [OPTION...]
30
The file read should look like this:
35
<contents of /proc/diskstats>
37
<contents of /proc/diskstats>
39
TS <timestamp> <-- must end with a TS line.
48
Visit `http://www.percona.com/software/ <http://www.percona.com/software/>`_ to download the latest release of
49
Percona Toolkit. Or, to get the latest release from the command line:
54
wget percona.com/latest/percona-toolkit/PKG
57
Replace \ ``PKG``\ with \ ``tar``\ , \ ``rpm``\ , or \ ``deb``\ to download the package in that
58
format. You can also get individual tools from the latest release:
63
wget percona.com/latest/percona-toolkit/TOOL
66
Replace \ ``TOOL``\ with the name of any tool.
74
The environment variable \ ``PTDEBUG``\ enables verbose debugging output to STDERR.
75
To enable debugging and capture all output to a file, run the tool like:
80
PTDEBUG=1 pt-diskstats ... > FILE 2>&1
83
Be careful: debugging output is voluminous and can generate several megabytes
92
You need Perl, DBI, DBD::mysql, and some core packages that ought to be
93
installed in any reasonably new version of Perl.
101
For a list of known bugs, see `http://www.percona.com/bugs/pt-diskstats <http://www.percona.com/bugs/pt-diskstats>`_.
103
Please report bugs at `https://bugs.launchpad.net/percona-toolkit <https://bugs.launchpad.net/percona-toolkit>`_.
104
Include the following information in your bug report:
107
\* Complete command-line used to run the tool
115
\* MySQL version of all servers involved
119
\* Output from the tool including STDERR
123
\* Input files (log/dump/config files, etc.)
127
If possible, include debugging output by running the tool with \ ``PTDEBUG``\ ;
139
*********************
140
ABOUT PERCONA TOOLKIT
141
*********************
144
This tool is part of Percona Toolkit, a collection of advanced command-line
145
tools developed by Percona for MySQL support and consulting. Percona Toolkit
146
was forked from two projects in June, 2011: Maatkit and Aspersa. Those
147
projects were created by Baron Schwartz and developed primarily by him and
148
Daniel Nichter, both of whom are employed by Percona. Visit
149
`http://www.percona.com/software/ <http://www.percona.com/software/>`_ for more software developed by Percona.
152
********************************
153
COPYRIGHT, LICENSE, AND WARRANTY
154
********************************
157
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
158
Feedback and improvements are welcome.
160
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
161
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
162
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
164
This program is free software; you can redistribute it and/or modify it under
165
the terms of the GNU General Public License as published by the Free Software
166
Foundation, version 2; OR the Perl Artistic License. On UNIX and similar
167
systems, you can issue \`man perlgpl' or \`man perlartistic' to read these
170
You should have received a copy of the GNU General Public License along with
171
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
172
Place, Suite 330, Boston, MA 02111-1307 USA.
180
Percona Toolkit v1.0.0 released 2011-08-01
added
removed
docs/user/pt-diskstats.rst
