14
pt-collect - Collect information from a server for some period of time.
22
Usage: pt-collect [OPTION...]
30
pt-collect focuses on gathering diagnostic data during a MySQL performance
31
problem. It is typically executed by \ ``stalk``\ .
39
Visit `http://www.percona.com/software/ <http://www.percona.com/software/>`_ to download the latest release of
40
Percona Toolkit. Or, to get the latest release from the command line:
45
wget percona.com/latest/percona-toolkit/PKG
48
Replace \ ``PKG``\ with \ ``tar``\ , \ ``rpm``\ , or \ ``deb``\ to download the package in that
49
format. You can also get individual tools from the latest release:
54
wget percona.com/latest/percona-toolkit/TOOL
57
Replace \ ``TOOL``\ with the name of any tool.
65
The environment variable \ ``PTDEBUG``\ enables verbose debugging output to STDERR.
66
To enable debugging and capture all output to a file, run the tool like:
71
PTDEBUG=1 pt-collect ... > FILE 2>&1
74
Be careful: debugging output is voluminous and can generate several megabytes
91
For a list of known bugs, see `http://www.percona.com/bugs/pt-collect <http://www.percona.com/bugs/pt-collect>`_.
93
Please report bugs at `https://bugs.launchpad.net/percona-toolkit <https://bugs.launchpad.net/percona-toolkit>`_.
94
Include the following information in your bug report:
97
\* Complete command-line used to run the tool
105
\* MySQL version of all servers involved
109
\* Output from the tool including STDERR
113
\* Input files (log/dump/config files, etc.)
117
If possible, include debugging output by running the tool with \ ``PTDEBUG``\ ;
129
*********************
130
ABOUT PERCONA TOOLKIT
131
*********************
134
This tool is part of Percona Toolkit, a collection of advanced command-line
135
tools developed by Percona for MySQL support and consulting. Percona Toolkit
136
was forked from two projects in June, 2011: Maatkit and Aspersa. Those
137
projects were created by Baron Schwartz and developed primarily by him and
138
Daniel Nichter, both of whom are employed by Percona. Visit
139
`http://www.percona.com/software/ <http://www.percona.com/software/>`_ for more software developed by Percona.
142
********************************
143
COPYRIGHT, LICENSE, AND WARRANTY
144
********************************
147
This program is copyright 2010-2011 Baron Schwartz, 2011 Percona Inc.
148
Feedback and improvements are welcome.
150
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
151
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
152
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
154
This program is free software; you can redistribute it and/or modify it under
155
the terms of the GNU General Public License as published by the Free Software
156
Foundation, version 2; OR the Perl Artistic License. On UNIX and similar
157
systems, you can issue \`man perlgpl' or \`man perlartistic' to read these
160
You should have received a copy of the GNU General Public License along with
161
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
162
Place, Suite 330, Boston, MA 02111-1307 USA.
170
Percona Toolkit v1.0.0 released 2011-08-01
added
removed
docs/user/pt-collect.rst
