Chapter 10. Logging Configuration Reference

Logging and debugging settings are not required in a Ceph configuration file, but you can override default settings as needed.

The options take a single item that is assumed to be the default for all daemons regardless of channel. For example, specifying "info" is interpreted as "default=info". However, options can also take key/value pairs. For example, "default=daemon audit=local0" is interpreted as "default all to 'daemon', override 'audit' with 'local0'."

Ceph supports the following settings:

log_file
Description
The location of the logging file for the cluster.
Type
String
Required
No
Default
/var/log/ceph/$cluster-$name.log
mon_cluster_log_file
Description
The location of the monitor cluster’s log file.
Type
String
Required
No
Default
/var/log/ceph/$cluster.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_flush_on_exit
Description
Determines if Ceph flushes the log files after exit.
Type
Boolean
Required
No
Default
true
mon_cluster_log_file_level
Description
The level of file logging for the monitor cluster. Valid settings include "debug", "info", "sec", "warn", and "error".
Type
String
Default
"info"
log_to_stderr
Description
Determines if logging messages appear in stderr.
Type
Boolean
Required
No
Default
true
err_to_stderr
Description
Determines if error messages appear in stderr.
Type
Boolean
Required
No
Default
true
log_to_syslog
Description
Determines if logging messages appear in syslog.
Type
Boolean
Required
No
Default
false
err_to_syslog
Description
Determines if error messages appear in syslog.
Type
Boolean
Required
No
Default
false
clog_to_syslog
Description
Determines if clog messages will be sent to syslog.
Type
Boolean
Required
No
Default
false
mon_cluster_log_to_syslog
Description
Determines if the cluster log will be output to syslog.
Type
Boolean
Required
No
Default
false
mon_cluster_log_to_syslog_level
Description
The level of syslog logging for the monitor cluster. Valid settings include "debug", "info", "sec", "warn", and "error".
Type
String
Default
"info"
mon_cluster_log_to_syslog_facility
Description
The facility generating the syslog output. This is usually set to "daemon" for the Ceph daemons.
Type
String
Default
"daemon"
clog_to_monitors
Description
Determines if clog messages will be sent to monitors.
Type
Boolean
Required
No
Default
true
mon_cluster_log_to_graylog
Description
Determines if the cluster will output log messages to graylog.
Type
String
Default
"false"
mon_cluster_log_to_graylog_host
Description
The IP address of the graylog host. If the graylog host is different from the monitor host, override this setting with the appropriate IP address.
Type
String
Default
"127.0.0.1"
mon_cluster_log_to_graylog_port
Description
Graylog logs will be sent to this port. Ensure the port is open for receiving data.
Type
String
Default
"12201"

10.1. OSD

osd_preserve_trimmed_log
Description
Preserves trimmed logs after trimming.
Type
Boolean
Required
No
Default
false
osd_tmapput_sets_uses_tmap
Description
Uses tmap. 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

10.2. File Store

filestore_debug_omap_check
Description
Debugging check on synchronization. This is an expensive operation.
Type
Boolean
Required
No
Default
0

10.3. The Ceph Object Gateway

rgw_log_nonexistent_bucket
Description
Log non-existent buckets.
Type
Boolean
Required
No
Default
false
rgw_log_object_name
Description
Log an object’s name.
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 time stamp in the intent log object name.
Type
Boolean
Required
No
Default
false