Config Files: tagmail.conf

This version of Puppet is not included in Puppet Enterprise. The latest version of PE includes Puppet 4.4. A newer version is available; see the version menu above for details.

The tagmail.conf file configures the optional tagmail report processor.

What is the Tagmail Report Processor?

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.

The tagmail report processor sends targeted emails to different admin users whenever certain resources are changed.

Enabling Tagmail

To enable tagmail, you must:

  • Enable reporting: On agent nodes (and puppet apply nodes), set report = true.
  • Enable the tagmail processor: On puppet masters (and puppet apply nodes), set reports = tagmail.
  • Configure email: On puppet masters (and puppet apply nodes), set the reportfrom email address and a value for either smtpserver or sendmail.
  • Configure tags: On puppet masters (and puppet apply nodes), create a tagmail.conf file at the location specified in the tagmap setting.

The tagmail.conf File


The tagmail.conf file is located at $confdir/tagmail.conf by default. Its location is configurable with the tagmap setting.

The location of the confdir varies; it depends on the OS, Puppet distribution, and user account. See the confdir documentation for details.


webserver, !mailserver:
emerg, crit:,,

This 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.


The tagmail.conf file is series of lines. Each line should consists of:

  • A comma-separated list of tags and !negated tags; valid tags include:
    • Explicit tags
    • Class names
    • all”, which is a special value matching all events
    • Any valid Puppet log level (debug, info, notice, warning, err, alert, emerg, crit, or verbose)
  • A colon
  • A comma-separated list of email addresses

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.

↑ Back to top