Show Table of Contents
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
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"
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
sseconds. - 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
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.