ceph/doc/config-cluster/log-and-debug-ref.rst
John Wilkins 7465dbeb82 doc: Added logging reference under configuration section.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2012-09-03 14:04:11 -07:00

293 lines
4.6 KiB
ReStructuredText

========================================
Logging and Debugging Config Reference
========================================
Logging and debugging settings are not required, but you may override default settings
as needed. Ceph supports the following settings:
Logging
=======
``log file``
:Desription: The location of the logging file for your cluster.
:Type: String
:Required: No
:Default: ``/var/log/ceph/$cluster-$name.log``
``log max new``
:Description: The maximum number of new log files.
:Type: Integer
:Required: No
:Default: ``1000``
``log max recent``
:Description: The maximum number of recent events to include in a log file.
:Type: Integer
:Required: No
:Default: ``1000000``
``log to stderr``
:Description: Determines if logging messages should appear in ``stderr``.
:Type: Boolean
:Required: No
:Default: ``true``
``err to stderr``
:Description: Determines if error messages should appear in ``stderr``.
:Type: Boolean
:Required: No
:Default: ``true``
``log to syslog``
:Description: Determines if logging messages should appear in ``syslog``.
:Type: Boolean
:Required: No
:Default: ``false``
``err to syslog``
:Description: Determines if error messages should appear in ``syslog``.
:Type: Boolean
:Required: No
:Default: ``false``
``log flush on exit``
:Description: Determines if Ceph should flush the log files after exit.
:Type: Boolean
:Required: No
:Default: ``true``
``clog to monitors``
:Description: Determines if ``clog`` messages should be sent to monitors.
:Type: Boolean
:Required: No
:Default: ``true``
``clog to syslog``
:Description: Determines if ``clog`` messages should be sent to syslog.
:Type: Boolean
:Required: No
:Default: ``false``
``mon cluster log to syslog``
:Description: Determines if the cluster log should be output to the syslog.
:Type: Boolean
:Required: No
:Default: ``false``
``mon cluster log file``
:Description: The location of the cluster's log file.
:Type: String
:Required: No
:Default: ``/var/log/ceph/$cluster.log``
OSD
===
``osd debug drop ping probability``
:Description: ?
:Type: Double
:Required: No
:Default: 0
``osd debug drop ping duration``
:Description: The duration ?
:Type: Integer
:Required: No
:Default: 0
``osd debug drop pg create probability``
:Description:
:Type: Integer
:Required: No
:Default: 0
``osd debug drop pg create duration``
:Description: ?
:Type: Double
:Required: No
:Default: 1
``osd preserve trimmed log``
:Description: ?
:Type: Boolean
:Required: No
:Default: ``false``
``osd tmapput sets uses tmap``
:Description: For debug only. ???
:Type: Boolean
:Required: No
:Default: ``false``
``osd min pg log entries``
:Description: The minimum number of log entries for placement groups.
:Type: 32-bit Unsigned Integer
:Required: No
:Default: 1000
``osd op log threshold``
:Description: How many op log messages to show up in one pass.
:Type: Integer
:Required: No
:Default: 5
Filestore
=========
``filestore debug omap check``
:Description: Checks the ``omap``. This is an expensive operation.
:Type: Boolean
:Required: No
:Default: 0
MDS
===
``mds debug scatterstat``
:Description: ?
:Type: Boolean
:Required: No
:Default: ``false``
``mds debug frag``
:Description:
:Type: Boolean
:Required: No
:Default: ``false``
``mds debug auth pins``
:Description: ?
:Type: Boolean
:Required: No
:Default: ``false``
``mds debug subtrees``
:Description: ?
:Type: Boolean
:Required: No
:Default: ``false``
RADOS Gateway
=============
``rgw log nonexistent bucket``
:Description: Should we log a non-existent buckets?
:Type: Boolean
:Required: No
:Default: ``false``
``rgw log object name``
:Description: Should an object's name be logged. // man date to see codes (a subset are supported)
:Type: String
:Required: No
:Default: ``%Y-%m-%d-%H-%i-%n``
``rgw log object name utc``
:Description: Object log name contains UTC?
:Type: Boolean
:Required: No
:Default: ``false``
``rgw enable ops log``
:Description: Enables logging of every RGW operation.
:Type: Boolean
:Required: No
:Default: ``true``
``rgw enable usage log``
:Description: Enable logging of RGW's bandwidth usage.
:Type: Boolean
:Required: No
:Default: ``true``
``rgw usage log flush threshold``
:Description: Threshold to flush pending log data.
:Type: Integer
:Required: No
:Default: ``1024``
``rgw usage log tick interval``
:Description: Flush pending log data every ``s`` seconds.
:Type: Integer
:Required: No
:Default: 30
``rgw intent log object name``
:Description:
:Type: String
:Required: No
:Default: ``%Y-%m-%d-%i-%n``
``rgw intent log object name utc``
:Description: Include a UTC timestamp in the intent log object name.
:Type: Boolean
:Required: No
:Default: ``false``