Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sensu-plugins/sensu-plugins-mailer
This plugin is an email handler for Sensu.
https://github.com/sensu-plugins/sensu-plugins-mailer
email-notification sensu-handler sensu-plugins
Last synced: about 1 month ago
JSON representation
This plugin is an email handler for Sensu.
- Host: GitHub
- URL: https://github.com/sensu-plugins/sensu-plugins-mailer
- Owner: sensu-plugins
- License: mit
- Created: 2015-02-16T11:31:30.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2021-06-11T05:13:40.000Z (over 3 years ago)
- Last Synced: 2024-04-26T16:20:57.078Z (8 months ago)
- Topics: email-notification, sensu-handler, sensu-plugins
- Language: Ruby
- Homepage: http://sensu-plugins.io
- Size: 130 KB
- Stars: 17
- Watchers: 12
- Forks: 36
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
## Sensu-Plugins-mailer
[](https://travis-ci.org/sensu-plugins/sensu-plugins-mailer)
[](http://badge.fury.io/rb/sensu-plugins-mailer)
[](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mailer)
[](https://codeclimate.com/github/sensu-plugins/sensu-plugins-mailer)
[](https://gemnasium.com/sensu-plugins/sensu-plugins-mailer)
## Functionality
## Files
* bin/handler-mailer-mailgun.rb
* bin/handler-mailer-ses.rb
* bin/handler-mailer.rb
## Usage
The following three configuration variables must be set if you want mailer to use remote SMTP settings:
smtp_address - defaults to "localhost"
smtp_port - defaults to "25"
smtp_domain - defaults to "localhost.localdomain"
There is an optional subscriptions hash which can be added to your mailer.json file. This subscriptions hash allows you to define individual mail_to addresses for a given subscription. When the mailer handler runs it will check the clients subscriptions and build a mail_to string with the default mailer.mail_to address as well as any subscriptions the client subscribes to where a mail_to address is found. There can be N number of hashes inside of subscriptions but the key for a given hash inside of subscriptions must match a subscription name.
Optionally, you can specify your own ERB template file to use for the message
body. The order of precedence for templates is: command-line argument (-t),
client config called "template", the mailer handler config, default.
Optionally, you can specify your own ERB template file to use for the message
subject. The order of precedence for templates is: command-line argument (-T),
client config called "subject_template", the mailer handler config, default.
```json
{
"mailer": {
"mail_from": "[email protected]",
"mail_to": "[email protected]",
"smtp_address": "smtp.example.org",
"smtp_port": "25",
"smtp_domain": "example.org",
"template": "/optional/path/to/template.erb",
"subject_template": "/optional/path/to/subject_template.erb",
"subscriptions": {
"subscription_name": {
"mail_to": "[email protected]"
}
}
}
}
```
**handler-mailer-mailgun**
```
{
"mailer-mailgun": {
"mail_from": "[email protected]",
"mail_to": "[email protected]",
"mg_apikey": "mailgunapikeygoeshere",
"mg_domain": "mailgun.domain.com"
}
}
```
**handler-mailer-ses**
```
{
"mailer-ses": {
"mail_from": "[email protected]",
"mail_to": "[email protected]",
"aws_access_key": "myawsaccesskey",
"aws_secret_key": "myawssecretkey",
"aws_ses_endpoint": "email.us-east-1.amazonaws.com"
}
}
```
**handler-mailer**
```
{
"mailer": {
"admin_gui": "http://admin.example.com:8080/",
"mail_from": "[email protected]",
"mail_to": "[email protected]",
"smtp_address": "smtp.example.org",
"smtp_port": "25",
"smtp_domain": "example.org"
}
}
```
By default, the handler will use `plain` as the SMTP authentication type, but you may also specify `"smtp_authentication": "ntlm"` for compatible servers, e.g. Microsoft Exchange.
### Contact Based Routing
Optionally, this handler can use the same syntax as [Sensu Enterprise contact routing](https://sensuapp.org/docs/0.26/enterprise/contact-routing.html) for sending e-mails for particular checks or clients, in addition to the previous configuration. This is configured by declaring contacts:
**support.json**
```
{
"contacts": {
"support": {
"email": {
"to": "[email protected]"
}
}
}
}
```
Then, in a check definition, you can specify a contact or an array of contacts which should be notified by e-mail:
**example_check.json**
```
{
"checks": {
"example_check": {
"command": "do_something.rb",
"handler": "mailer",
"contact": "support"
}
}
}
```
Additionally, a client definition can specify a contact or an array of contacts to be notified of any check which alerts to the mailer handler. This is configured by specifying a contact value, or contacts array in the client.json configuration.
## Installation
[Installation and Setup](http://sensu-plugins.io/docs/installation_instructions.html)
Create a handler file in `/etc/sensu/conf.d` with the following content, replacing with your own configuration:
```json
{
"mailer" : {
"admin_gui" : "http://localhost:3000",
"mail_from": "[email protected]",
"mail_to": "[email protected]",
"delivery_method": "smtp",
"smtp_address": "localhost",
"smtp_port": "25",
"smtp_domain": "localhost.local_domain",
"smtp_enable_starttls_auto": "true",
"smtp_username" : "username",
"smtp_password" : "XXXXXXXX"
},
"handlers": {
"mailer": {
"type": "pipe",
"command": "/opt/sensu/embedded/bin/handler-mailer.rb"
}
}
}
```
## Notes