Appendix H. Ceph debugging and logging configuration options
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'."
- 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
-
10000
- 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
clogmessages will be sent tosyslog. - 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
clogmessages 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"
- 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
