Skip to content

Target: notification
Plugin name target_notification
Status supported
Since 4.6
Copyright 2008 Florian octo Forster
License GPLv2
Configuration collectd.conf(5)

Description

The Notification target can be used to create a notification with arbitrary text.

Synopsis

 <Target "notification">
   Message "Oops, the %{type_instance} temperature is currently %{ds:value}!"
   Severity "WARNING"
 </Target>

Placeholders

The following placeholders will be replaced by their respective values in the Message option:

  • %{host}
  • %{plugin}
  • %{plugin_instance}
  • %{type}
  • %{type_instance}
  • %{ds:name} Will be replaced by the current rate of the data source "name". Because counter values need to be transformed to rates, using this target in the PreCache chain may yield unexpected results.

Dependencies

  • none

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

Creates and dispatches a notification.

Available options:

Message String

This required option sets the message of the notification. The following placeholders will be replaced by an appropriate value:

%{host}
%{plugin}
%{plugin_instance}
%{type}
%{type_instance}
These placeholders are replaced by the identifier field of the same name.
%{ds:name}
These placeholders are replaced by a (hopefully) human readable representation of the current rate of this data source. If you changed the instance name (using the set or replace targets, see below), it may not be possible to convert counter values to rates.

Please note that these placeholders are case sensitive!

Severity "FAILURE"|"WARNING"|"OKAY"
Sets the severity of the message. If omitted, the severity "WARNING" is used.

Example:

<Target "notification">
  Message "Oops, the %{type_instance} temperature is currently %{ds:value}!"
  Severity "WARNING"
</Target>