ZenPack:Mail Transactions

Note: This ZenPack is available in commercial versions of Zenoss. Click here to request more information about this commercial ZenPack. Click here to see all commercial ZenPacks.

Organization

Zenoss, Inc.

ZenPack name

ZenPacks.zenoss.ZenMailTx

Mail Transactions ZenPack

The ZenMailTx ZenPack allows you to monitor round-trip email delivery.

Warning

The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.

Support

This ZenPack is included with commercial versions of Zenoss and enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.

Background

The ZenPacks.zenoss.ZenMailTx ZenPack allows you to monitor round-trip email delivery.

Events

There are several situations in which this ZenPack creates events. The component will be zenmailtx, the eventGroup will be mail and the eventClass will be /Status. These situations are:

• The SMTP server name or the POP server name cannot be resolved.
• The SMTP server or the POP server is down or unavailable.
• The timeout (specified on the Data Source tab) is exceeded for the SMTP or POP server.
• Authentication (if specified) with the SMTP or POP server fails.
• A threshold defined for one of the data points in this data source is exceeded. Thresholds are defined in the monitoring template that contains the data source.

Once an email has successfully made a trip back and forth, a clear event is created that clears any failure events.

Prerequisites

Prerequisite	Restriction
Product	Zenoss platform 4.x, Zenoss 2.2 or higher
Required ZenPacks	ZenPacks.zenoss.ZenMailTx

Enable Monitoring

1. Click the device in the device list.
2. From the left panel, select the Device template under Monitoring Templates.
3. Select Add Local Template from the Action menu.
4. Enter an identifier for the template (such as ZenMailTx), and then click Submit to create the template.
5. Click the newly created ZenMailTx template.
6. In the Data Sources area, click Add to add a data source.
7. Enter a name for the data source (MailTx), select MAILTX as the type, and then click Submit.
8. Change options as needed.

   Mail Transactions Basic Data Source Options

   Option	Description
   To Address	The recipient e-mail address. This should be the same as the POP Username.
   From Address	The e-mail address that will appear in the From: field in the generated e-mail
   SMTP Host	The e-mail server used by Zenoss platform to send the email
   POP Host	The email server where you will retrieve your test message

   
   Tip: Any of the MAILTX fields can take TAL expressions, including the password fields.

9. Click Save to save your changes.
10. Navigate to Graphs and you should see some place holders for graphs. After approximately fifteen minutes you should see the graphs begin populating with information.

Daemons

Type	Name
Performance Collector	zenmailtx

Managing the Collector Daemon

The zenmailtx daemon:

• Sends the test email message via the specified SMTP server
• Retrieves the email message from the specified POP server
• Sends the following information to Zenoss platform:
  • Time taken to send
  • Time taken to fetch
  • Total time

This daemon appears on the Zenoss platform Daemons page and can be started, stopped and restarted from there.

Installation

Normal Installation (packaged egg)

1. Download the appropriate egg file for the version of Zenoss you are running.
2. Ensure you are logged in as the zenoss user:

   $ sudo su - zenoss

3. Install the ZenPack:

   $ zenpack --install ZenPacks.zenoss.ZenMailTx-*.egg

4. Restart these services:

   $ zenoss restart

Discuss

New: Don't forget to add yourself to the Zenoss User Map!

blog comments powered by Disqus