Cookbooks
bind
documentation
Bind Logging Channel

Back to resource list

bind_logging_channel

This resource will configure a destination for logs to be sent to. To actually send logs you need to also configure a bind_logging_category.

Actions

ActionDescription
:createCreates a BIND logging destination channel

Properties

NameTypeDefaultDescription
bind_configStringdefaultName of the bind_config resource to notify actions on
destinationString 1String containing the destination name
facilityString (Must be a valid syslog facility)String containing the syslog facility to use for the syslog destination
pathStringFile name used for the file destination
print_categorytrue, falsefalseBoolean representing if we should print the category in the output message
print_severitytrue, falsefalseBoolean representing if we should print the severity of the log message to the output channel
print_timetrue, falsefalseBoolean representing if we should print the time in the log message sent to the output channel
severityString 2dynamicString containing the minimum severity of BIND logs to send to this channel
sizeStringMaximum size of the log file used for the file destination
versionsIntegerNumber of versions of the log file used for the file destination

1 Must be one of: stderr, syslog, file, or null 2 Can be critical, error, warning, notice, info, dynamic, or debug (this must be followed by a number representing the debug verbosity).

Examples

bind_logging_channel 'querylog' do
  destination 'file'
  severity 'info'
  path '/tmp/query.log'
  versions 5
  size '10m'
  print_category true
  print_severity true
  print_time true
end
 
bind_logging_channel 'syslog' do
  destination 'syslog'
  facility 'daemon'
  severity 'info'
end