pe_puppet_agent_syslog

pdk
Configure Puppet Agent and rsyslog to log to a separate file

Adam Bottchen

abottchen

5,058 downloads

5,058 latest version

5.0 quality score

Version information

  • 0.1.0 (latest)
released Oct 30th 2017
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • CentOS
    ,
    OracleLinux
    ,
    RedHat
    ,
    Scientific

Start using this module

Documentation

abottchen/pe_puppet_agent_syslog — version 0.1.0 Oct 30th 2017

pe_puppet_agent_syslog

Table of Contents

  1. Description
  2. Setup - The basics of getting started with pe_puppet_agent_syslog
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Description

This module will automatically set up rsyslog and Puppet agent such that all agent logging will be directed to a file of your choosing. This file defaults to /var/log/puppetlabs/puppet-agent.log. This automates the process of splitting Puppet agent messages out from /var/log/messages to their own file.

This module assumes you are running a version of Linux that utilizes rsyslog as the logging subsystem.

This class can be applied to any node in your infrastructure where you would like to have Puppet agent, both command like invocations and automated runs, log to a separate file along with /var/log/messages.

Setup

What pe_puppet_agent_syslog affects

This module will add a new rsyslog configuration file under /etc/rsyslog.d, set to be loaded last. By default, it will log on syslog facility "local6", but this can be configured via parameter if it is already in use in your environment.

Beginning with pe_puppet_agent_syslog

Assign the class to a node group that encompasses the nodes you wish to set up.

Usage

There are two parameters, "facility" and "log_filename":

"facility": The syslog facility on which Puppet agent will log. This defaults to "local6".

"log_filename": The destination file where the Puppet agent logs will be stored. This defaults to "/var/log/puppetlabs/puppet-agent.log"

Reference

Limitations

This module currently only handles systems with rsyslog as the logging subsystem.

Development

Release Notes/Contributors/Etc. Optional