tagmail.conf file configures the optional
tagmail report processor.
Note: If you use Puppet Server and want to enable and configure the
tagmailreport processor, install and use the
puppetlabs/tagmailmodule. The built-in
tagmailreport processor has a known issue with Puppet Server and was removed in open source Puppet 4.0 and Puppet Enterprise 3.8.
Puppet agent nodes can be configured to send reports to a Puppet master server. The master will then use its configured report processors to handle those reports.
tagmail report processor sends targeted emails to different admin users whenever certain resources are changed.
To enable tagmail, you must:
report = true.
reports = tagmail.
reportssetting accepts a list, so you can enable multiple report processors.
reportfromemail address and a value for either
tagmail.conffile at the location specified in the
tagmail.conf file is located at
$confdir/tagmail.conf by default. Its location is configurable with the
The location of the
confdir varies; it depends on the OS, Puppet distribution, and user account. See the confdir documentation for details.
all: email@example.com webserver, !mailserver: firstname.lastname@example.org emerg, crit: email@example.com, firstname.lastname@example.org, email@example.com
tagmail.conf file will mail any resource events tagged with
webserver but not with
mailserver to the httpadmins group; any emergency or critical events to to James, Zach, and Ben, and all events to the log-archive group.
tagmail.conf file is series of lines. Each line should consists of:
all”, which is a special value matching all events
The list of tags on a line defines the set of resources whose messages will be included in the mailing; each additional tag adds to the set, and each !negated tag subtracts from the set.