Skip to content

notify_email plugin

Plugin name notify_email
Type notification
Callbacks config, init, notification, shutdown
Status supported
Since 4.5
Copyright 2008 Oleg King, 2008 Florian octo Forster
Configuration collectd.conf(5)

The Notify Email plugin uses libESMTP to send notifications to a configured email address(es).

This plugin is a generic plugin, i.e. it cannot work without configuration, because there is no reasonable default behavior. Please read the Plugin notify_email section of the collectd.conf(5) manual page for an in-depth description of the plugin's configuration.

Synopsis

 <Plugin "notify_email">
   From "collectd@somewhere"
   Recipient "admin0@somewhere"
   Recipient "admin1@somewhere"
 </Plugin>

Dependencies

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

The notify_email plugin uses the ESMTP library to send notifications to a configured email address.

libESMTP is available from http://www.stafford.uklinux.net/libesmtp/.

Available configuration options:

From Address

Email address from which the emails should appear to come from.

Default: root@localhost

Recipient Address

Configures the email address(es) to which the notifications should be mailed. May be repeated to send notifications to multiple addresses.

At least one Recipient must be present for the plugin to work correctly.

SMTPServer Hostname

Hostname of the SMTP server to connect to.

Default: localhost

SMTPPort Port

TCP port to connect to.

Default: 25

SMTPUser Username
Username for ASMTP authentication. Optional.
SMTPPassword Password
Password for ASMTP authentication. Optional.
Subject Subject

Subject-template to use when sending emails. There must be exactly two string-placeholders in the subject, given in the standard printf(3) syntax, i. e. %s. The first will be replaced with the severity, the second with the hostname.

Default: Collectd notify: %s@%s