Puppet Class: nova::logging

Defined in:
manifests/logging.pp

Overview

Class nova::logging

nova logging configuration

parameters

debug

(Optional) Should the daemons log debug messages Defaults to $facts

use_syslog

(Optional) Use syslog for logging. Defaults to $facts

use_json

(Optional) Use json for logging. Defaults to $facts

use_journal

(Optional) Use journal for logging. Defaults to $facts

use_stderr

(Optional) Use stderr for logging Defaults to $facts

log_facility

(Optional) Syslog facility to receive log lines. Defaults to $facts

log_dir

(Optional) Directory where logs should be stored. If set to $facts, it will not log to any directory. Defaults to ‘/var/log/nova’

log_file

(Optional) File where logs should be stored. Defaults to $facts

logging_context_format_string

(Optional) Format string to use for log messages with context. Defaults to $facts Example: ‘%(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s\

[%(request_id)s %(user_identity)s] %(instance)s%(message)s'
logging_default_format_string

(Optional) Format string to use for log messages without context. Defaults to $facts Example: ‘%(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s\

[-] %(instance)s%(message)s'
logging_debug_format_suffix

(Optional) Formatted data to append to log format when level is DEBUG. Defaults to $facts Example: ‘%(funcName)s %(pathname)s:%(lineno)d’

logging_exception_prefix

(Optional) Prefix each line of exception output with this format. Defaults to $facts Example: ‘%(asctime)s.%(msecs)03d %(process)d TRACE %(name)s %(instance)s’

log_config_append

(Optional) The name of an additional logging configuration file. Defaults to $facts See docs.python.org/2/howto/logging.html

default_log_levels

(Optional) Hash of logger (keys) and level (values) pairs. Defaults to $facts Example:

{ 'amqp' => 'WARN', 'amqplib' => 'WARN', 'boto' => 'WARN',
  'sqlalchemy' => 'WARN', 'suds' => 'INFO', 'iso8601' => 'WARN',
  'requests.packages.urllib3.connectionpool' => 'WARN' }
publish_errors

(Optional) Publish error events (boolean value). Defaults to $facts

fatal_deprecations

(Optional) Make deprecations fatal (boolean value) Defaults to $facts

instance_format

(Optional) If an instance is passed with the log message, format it

like this (string value).

Defaults to $facts Example: ‘[instance: %(uuid)s] ’

instance_uuid_format

(Optional) If an instance UUID is passed with the log message, format

it like this (string value).

Defaults to $facts Example: instance_uuid_format=‘[instance: %(uuid)s] ’

log_date_format

(Optional) Format string for %%(asctime)s in log records. Defaults to $facts Example: ‘Y-%m-%d %H:%M:%S’

DEPRECATED PARAMETERS

watch_log_file

(Optional) Uses logging handler designed to watch file system (boolean value). Defaults to undef

Parameters:

  • use_syslog (Any) (defaults to: $facts['os_service_default'])
  • use_json (Any) (defaults to: $facts['os_service_default'])
  • use_journal (Any) (defaults to: $facts['os_service_default'])
  • use_stderr (Any) (defaults to: $facts['os_service_default'])
  • log_facility (Any) (defaults to: $facts['os_service_default'])
  • log_dir (Any) (defaults to: '/var/log/nova')
  • log_file (Any) (defaults to: $facts['os_service_default'])
  • debug (Any) (defaults to: $facts['os_service_default'])
  • logging_context_format_string (Any) (defaults to: $facts['os_service_default'])
  • logging_default_format_string (Any) (defaults to: $facts['os_service_default'])
  • logging_debug_format_suffix (Any) (defaults to: $facts['os_service_default'])
  • logging_exception_prefix (Any) (defaults to: $facts['os_service_default'])
  • log_config_append (Any) (defaults to: $facts['os_service_default'])
  • default_log_levels (Any) (defaults to: $facts['os_service_default'])
  • publish_errors (Any) (defaults to: $facts['os_service_default'])
  • fatal_deprecations (Any) (defaults to: $facts['os_service_default'])
  • instance_format (Any) (defaults to: $facts['os_service_default'])
  • instance_uuid_format (Any) (defaults to: $facts['os_service_default'])
  • log_date_format (Any) (defaults to: $facts['os_service_default'])
  • watch_log_file (Any) (defaults to: undef)


106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
# File 'manifests/logging.pp', line 106

class nova::logging(
  $use_syslog                    = $facts['os_service_default'],
  $use_json                      = $facts['os_service_default'],
  $use_journal                   = $facts['os_service_default'],
  $use_stderr                    = $facts['os_service_default'],
  $log_facility                  = $facts['os_service_default'],
  $log_dir                       = '/var/log/nova',
  $log_file                      = $facts['os_service_default'],
  $debug                         = $facts['os_service_default'],
  $logging_context_format_string = $facts['os_service_default'],
  $logging_default_format_string = $facts['os_service_default'],
  $logging_debug_format_suffix   = $facts['os_service_default'],
  $logging_exception_prefix      = $facts['os_service_default'],
  $log_config_append             = $facts['os_service_default'],
  $default_log_levels            = $facts['os_service_default'],
  $publish_errors                = $facts['os_service_default'],
  $fatal_deprecations            = $facts['os_service_default'],
  $instance_format               = $facts['os_service_default'],
  $instance_uuid_format          = $facts['os_service_default'],
  $log_date_format               = $facts['os_service_default'],
  # DEPRECATED PARAMETERS
  $watch_log_file                = undef,
) {

  include nova::deps
  include nova::params

  oslo::log { 'nova_config':
    debug                         => $debug,
    use_stderr                    => $use_stderr,
    use_syslog                    => $use_syslog,
    use_json                      => $use_json,
    use_journal                   => $use_journal,
    log_dir                       => $log_dir,
    log_file                      => $log_file,
    watch_log_file                => $watch_log_file,
    syslog_log_facility           => $log_facility,
    logging_context_format_string => $logging_context_format_string,
    logging_default_format_string => $logging_default_format_string,
    logging_debug_format_suffix   => $logging_debug_format_suffix,
    logging_exception_prefix      => $logging_exception_prefix,
    log_config_append             => $log_config_append,
    default_log_levels            => $default_log_levels,
    publish_errors                => $publish_errors,
    fatal_deprecations            => $fatal_deprecations,
    instance_format               => $instance_format,
    instance_uuid_format          => $instance_uuid_format,
    log_date_format               => $log_date_format,
  }

}