First commit, tested from command line

Author: mkgin

.gitignore

@@ -0,0 +1 @@
+*~

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Mike G
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,45 @@
+Sendgrid Zabbix Alert
+=====================
+Work in progress, basically an alertscript called by Zabbix server
+that uses sendgrid to send a message
+
+Requirements:
+-------------
+
+### Software
+* curl
+* zabbix server
+* bash
+
+### Configuration file
+
+Configuration is sourced from  /etc/zabbix/sendgrid_zabbix_alert.conf
+to set MAILFROMADDR, MAILFROMNAME and SENDGRID_API_KEY. See 
+sendgrid_zabbix_alert.conf.example for more information
+
+### Zabbix configuration
+
+Normally alert scripts are here /usr/lib/zabbix/alertscripts
+AlertScriptsPath can be set to a location for custom alert scripts
+in zabbix_server.conf
+
+Check the Zabbix documentions for Custom alert scripts.
+
+When calling the alertscript, Zabbix sets the following parameters 
+MAILTO=$1
+MAILSUBJECT=$2
+MAILBODY=$3
+
+Parameters can be customized. (See custom alert scripts)
+
+### Installation
+
+Assuming default settings:
+
+Set variables in 
+/etc/zabbix/sendgrid_zabbix_alert.conf
+
+Copy sendgrid_zabbix_alert.sh to /usr/lib/zabbix/alertscripts
+
+There is also a file to help debug your alert parameters
+test_zabbix_alert.sh

sendgrid_zabbix_alert.conf.example

@@ -0,0 +1,9 @@
+# Where the mail should be send from
+MAILFROMADDR="[email protected]"
+
+# The name of the mailer
+MAILFROMNAME="Zabbix Alert Script"
+
+# Your sendgrid api key
+SENDGRID_API_KEY="abc123"
+

sendgrid_zabbix_alert.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+#
+
+# define the following in settings in this 
+source /etc/zabbix/sendgrid_zabbix_alert.conf
+#MAILFROMADDR=
+#MAILFROMNAME=
+#SENDGRID_API_KEY=
+
+# By default alert scripts are here /usr/lib/zabbix/alertscripts
+# AlertScriptsPath can be set in zabbix_server.conf
+
+# Zabbix sets the following parameters when calling the alertscript
+MAILTO=$1
+MAILSUBJECT=$2
+MAILBODY=$3
+
+#curl --trace-ascii curltrace --request POST \
+curl --request POST \
+  --url https://api.sendgrid.com/v3/mail/send \
+  --header 'Authorization: Bearer '$SENDGRID_API_KEY'' \
+  --header 'Content-Type: application/json' \
+  --data '{"personalizations": [{"to": [{"email": "'"$MAILTO"'"}]}], \
+"from": {"email": "'"$MAILFROMADDR"'"}, \
+"subject": "'"$MAILSUBJECT"'", \
+"content": [{"type": "text/plain","value": "'"$MAILBODY"'"}], \
+"tracking_settings": { \
+"click_tracking": { "enable": false}, \
+"open_tracking": { "enable": false} \
+} \
+}'

test_zabbix_alert.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+#
+# append date and parameters to LOGFILE
+# LOGFILE must by writeable but the user running the script
+
+LOGFILE="/tmp/test_zabbix_alert.log"
+PAR_COUNT=1
+
+echo "$(date --rfc-3339=sec) Received $# parameters" >> $LOGFILE
+for PARAMETER in "$@"
+do
+    echo "Parameter# $PAR_COUNT: $PARAMETER" >> $LOGFILE
+    (( PAR_COUNT++ ))
+done