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 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"

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
Number of op log messages to show up in one pass.

Type
Integer

Required
No

Default
5