~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/administration/logging.rst

  • Committer: Daniel Nichter
  • Date: 2011-10-23 16:01:37 UTC
  • mto: This revision was merged to the branch mainline in revision 2448.
  • Revision ID: daniel@percona.com-20111023160137-7ac3blgz8z4tf8za
Add Administration Getting Started and Logging.  Capitalize SQL clause keywords.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. program:: drizzled
 
2
 
 
3
Logging
 
4
=======
 
5
 
 
6
Error Messages
 
7
--------------
 
8
 
 
9
Error messages are also handled by plugins.  Drizzle loads the
 
10
:ref:`errmsg_stderr_plugin` plugin by default which prints error messages
 
11
to ``STDERR``.  In many cases, this is sufficient if ``STDERR`` is
 
12
redirected to a log file when
 
13
:ref:`starting Drizzle <starting_and_stopping_drizzled>`.
 
14
 
 
15
Since :program:`syslog` is the standard UNIX logging facility,
 
16
the :ref:`syslog_plugin` plugin is also loaded by default which will log error
 
17
messages to the system log (:file:`/var/log/syslog` on Ubuntu for example).
 
18
However, you must start :program:`drizzled` with
 
19
:option:`--syslog.errmsg-enable` to enable this feature.
 
20
 
 
21
Queries
 
22
-------
 
23
 
 
24
The :ref:`query_log_plugin` plugin is the most feature-complete and flexible
 
25
query logging plugin.  It logs queries to a file with a consistent,
 
26
easy-to-parse format, and all of its options are dynamic, so once the plugin
 
27
is loaded, logging can be enabled and disabled at runtime.
 
28
 
 
29
Drizzle does not load the :ref:`query_log_plugin` plugin by default, so you
 
30
must load it when starting Drizzle.
 
31
 
 
32
The :ref:`syslog_plugin` plugin also provides basic query logging to
 
33
the system log.  Although the plugin is loaded by default, you must
 
34
enable query logging by specifying :option:`--syslog.logging-enable`
 
35
and one of the threshold options, such as
 
36
:option:`--syslog.logging-threshold-slow`.  The plugin is not dynamic,
 
37
so once query logging is enabled, you must restart Drizzle to disable
 
38
or change its settings.