官术网_书友最值得收藏!

E-mailing log messages containing specific tags

If, like most sysadmins, you feel like you don't get enough e-mail, you'll be looking for a way to generate more. Another type of Puppet report is called tagmail. This will e-mail the log messages to any address you specify.

How to do it…

  1. Add tagmail to the comma-separated list of reports in puppet.conf:
    [master]
    reports = store,tagmail
  2. Add some tags and associated e-mail addresses in the file /etc/puppet/tagmail.conf. For example, this line will e-mail all log messages to me:
    all: john@example.com
  3. When Puppet runs, you will get an e-mail that looks like the following:
    From: report@cookbook.bitfieldconsulting.com
    Subject: Puppet Report for cookbook.bitfieldconsulting.com
    To: john@example.com
    Mon Jan 17 08:42:30 -0700 2011 //cookbook.bitfieldconsulting.com/Puppet (info): Caching catalog for cookbook.bitfieldconsulting.com
    Mon Jan 17 08:42:30 -0700 2011 //cookbook.bitfieldconsulting.com/Puppet (info): Applying configuration version '1295278949'

How it works…

Puppet looks at each line in tagmail.conf and sends any messages matching the tag to the e-mail address specified. The special tag all matches all messages. The tag err matches errors as shown in the following code snippet:

err: john@example.com

You can list as many rules as you like in the tagmail.conf file, and Puppet will send e-mails for all rules that match. In the following example, errors go to one address, and web server related messages go to another:

err: puppetmaster@example.com
webserver: webteam@example.com

There's more…

The tagmail reports are a powerful feature which you may need to experiment with a bit so that you can get the most out of them. I have given a few tips to help you in the following text.

What are tags?

Tags are explained in more detail later in this book, but for reporting purposes, it's enough to know that a tag can be the name of a node or a class. For example, the tag webserver is matched if a machine includes the class webserver. You can also add a tag explicitly, using the tag function as follows:

class exim {
    tag("email")
    service { "exim4":
        ensure => running,
        enable => true,
    }
}

Specifying multiple tags, or excluding tags

You can specify a comma-separated list of tags in tagmail.conf, and also exclude certain tags by using an exclamation point (!).

all, !webserver: puppetmaster@example.com

Sending reports to multiple e-mail addresses

You can send messages to multiple, comma-separated e-mail addresses as shown in the following code-snippet:

err: puppetmaster@example.com, sysadmin@example.com

See also

  • Generating reports in this chapter
  • Creating graphical reports in this chapter
  • Using tags in this chapter
主站蜘蛛池模板: 晋宁县| 平阴县| 贵阳市| 新龙县| 梨树县| 酉阳| 平乡县| 盐津县| 涞水县| 柯坪县| 邻水| 文成县| 江孜县| 江达县| 浦城县| 金平| 张家口市| 鄄城县| 固镇县| 临西县| 凌源市| 察雅县| 多伦县| 兴海县| 蓝山县| 凤城市| 红安县| 宁阳县| 即墨市| 丁青县| 保康县| 嘉禾县| 溧阳市| 南靖县| 惠安县| 鄂温| 绥德县| 康平县| 普定县| 邵阳县| 乾安县|