Create a gist now

Instantly share code, notes, and snippets.

What would you like to do?
Zabbix SMTP Alert script for gmail
# -*- coding: utf-8 -*-
Zabbix SMTP Alert script for gmail.
import sys
import smtplib
from email.MIMEText import MIMEText
from email.Header import Header
from email.Utils import formatdate
# Mail Account
MAIL_PASSWORD = 'your mail password'
# Sender Name
SENDER_NAME = u'Zabbix Alert'
# Mail Server
def send_mail(recipient, subject, body, encoding='utf-8'):
session = None
msg = MIMEText(body, 'plain', encoding)
msg['Subject'] = Header(subject, encoding)
msg['From'] = Header(SENDER_NAME, encoding)
msg['To'] = recipient
msg['Date'] = formatdate()
session = smtplib.SMTP(SMTP_SERVER, SMTP_PORT)
session.sendmail(MAIL_ACCOUNT, recipient, msg.as_string())
except Exception as e:
raise e
# close session
if session:
if __name__ == '__main__':
recipient = sys.argv[1]
subject = sys.argv[2]
body = sys.argv[3]
if len(sys.argv) == 4:
print u"""requires 3 parameters (recipient, subject, body)
\t$ recipient subject body

dthom91 commented Dec 15, 2012

This is great, thanks! Saved me a chunk of time and frustration.

e4k4 commented Nov 26, 2013

Awesome, thank you!

This looks great but I'm unsure as to where my alertscripts folder is, I've searched using find -name alertscripts but I don't get anything, please advise.

wilyoj commented Jan 8, 2014

Works flawlessly, thanks.

Install guide:

  • copy to AlertScriptsPath, you can check the path in /etc/zabbix/zabbix_server.conf, default path is /usr/lib/zabbix/alertscripts
  • cd /usr/lib/zabbix/alertscripts
  • chmod 755
  • Go to Zabbix web UI, Administration > Media types > Create media type
  • Enter Script name:
  • Save

Geo-Gee commented Oct 8, 2014

Fantastic script! I appreciate you sharing this.

Flawless victory! Worked perfectly.

Thank you very much!

Hey thank you for this helpful script.

Why 0755 ? 0700 should be fine enough.

I also suggest to put the password in a hidden textfile with owner zabbixsrv and mod 0600. Then you can use "cat hiddenfile" in the script to get it.

What an incredible script.
Thank you so much!

ramxis commented Feb 11, 2015

hi this script is not working for me . I placed the script in /... /zabbix/alertscripts then did the following
chmod 755
Go to Zabbix web UI, Administration > Media types > Create media type
NAME:Gmail Scripts
Enter Script name:
also created an action which sends messages Gmail Scripts when ever a trigger event fires

i didnt receive any emails on my gmail account i tried running the script directly from my terminal i get the following errors
Zabbix SMTP Alert script for gmail.
: command not found
/usr/local/share/zabbix/alertscripts/ line 9: from: command not found
/usr/local/share/zabbix/alertscripts/ line 10: from: command not found
/usr/local/share/zabbix/alertscripts/ line 11: from: command not found
/usr/local/share/zabbix/alertscripts/ line 14: MAIL_ACCOUNT: command not found
/usr/local/share/zabbix/alertscripts/ line 15: MAIL_PASSWORD: command not found
/usr/local/share/zabbix/alertscripts/ line 18: SENDER_NAME: command not found
/usr/local/share/zabbix/alertscripts/ line 21: SMTP_SERVER: command not found
/usr/local/share/zabbix/alertscripts/ line 22: SMTP_PORT: command not found
/usr/local/share/zabbix/alertscripts/ line 24: SMTP_TLS: command not found
/usr/local/share/zabbix/alertscripts/ line 26: syntax error near unexpected token (' /usr/local/share/zabbix/alertscripts/ line 26:def send_mail(recipient, subject, body, encoding='utf-8'):'
I have installed zabbix 2.4.3 in oracle linux 6.5
Please help me sort this out

ramxis commented Feb 13, 2015

any help will be greatly appreciated thank you

ramxis, do you have python installed?

ramxis commented Feb 20, 2015

@rjreed yes i have it installed . I didnt uncomment the first line of script so thats why i was getting errors but i have uncommented it now by removing the #

-- coding: utf-8 --

Zabbix SMTP Alert script for gmail.

import sys
import smtplib
from email.MIMEText import MIMEText

now the script times out in zabbix event log screen with the error "Time out while executing the shell script"


The script works perfectly from command line, but the action configured to use the script is not sending any email. I dont see any log even in debug mode. Is there something im not doing good?

Thanks a lot

onurzaim commented Mar 4, 2015

This worked with zabbix 2.4 with greatest ease. Thanks a lot for your effort.
For CentOS:
Put this script in /usr/lib/zabbix/alertscripts and modify the 14,15, 21th lines
chmod +x
chmod 775

Go to Administrator -> media and add this script as
Dont forget to enable send all alerts to administrators in config. -> actions.

aswinKM commented Mar 6, 2015

Clean script and working well. Please make sure that the file name is instead of

Enable this parameter, if you have error smtplib.SMTPAuthenticationError:

freewood commented Apr 8, 2015

Hello, friends. Need some advice. Trying to send email via command line:
"./ testmail testbody"
And it's freezes until i initerrupt it with "Ctrl+C". Then i get output:
"^CTraceback (most recent call last):
File "./", line 61, in
File "./", line 34, in send_mail
session = smtplib.SMTP(SMTP_SERVER, SMTP_PORT)
File "/usr/lib64/python2.7/", line 256, in init
(code, msg) = self.connect(host, port)
File "/usr/lib64/python2.7/", line 317, in connect
(code, msg) = self.getreply()
File "/usr/lib64/python2.7/", line 361, in getreply
line = self.file.readline(_MAXLINE + 1)
File "/usr/lib64/python2.7/", line 476, in readline
data = self._sock.recv(self._rbufsize)

Hello, i keep having problem using the script. Its appear that Zabbix sent the email but it is not... i preconfigured a 4 different emails to my user (hotmail, gmail, corporation and personal) and when i see the audit -> action log says the four were send. Does someone happened this? is there some troubleshoot debug (and how activate it) to see what im doing wrong or an extended log?, thank you in advanced.
Heres my conf:
When i execute this: the email is received

I made a test creating an script with a simple code that works without Zabbix, just executing "py" ( is the name of the script). And also change the user and group owner to zabbix.
I reconfigure media type in order to call the, chmod 777 and something i see is that the action log is registering by "sent" but it not creating the file as expected.

Exactly what I was searching for - thanks a lot! :-)

rowlandm commented Jul 6, 2015

I was using zabbix that had the files in /var/lib/zabbix

I downloaded the file and called it

I ran command line of
cd /var/lib/zabbix
python Subject Body

I had to change in

Sender Name

SENDER_NAME = u'Zabbix Alert'
to an email address when using

Hope this helps someone else.

PS. I also added this under the TLS section just to get more information for debugging.

It cannot work... is like zabbix cannot run the script... it is validated if exist when i remove it from the folder but just cannot executed it...

Changed owner to zabbix
Changed group owner to zabbix
Chmod 777
I tried with other file like a c++ program that just create a file when executed.

If i run the script manually from CLI just run easily and there's no problem...

i have problem with this script, i get this error :( anybody can i help me?

Traceback (most recent call last):
File "", line 58, in
File "", line 42, in send_mail
raise e
socket.gaierror: [Errno -2] Name or service not known

I have the same problem as dark storm 007
I did the following
1-create media type with name of (after adding the script in alertscripts path)
2- in configuration --> action , I add action to send message via all media
3- in media type I disabled email
4- I created user and added the script media type to it and in send to I added its email
5-I opened less secure apps on gmail
6- I tested manually using : python my title body
and the test succeeded and I received test message
but it can not suuceeded automatically using zabbix
what wrong ?
please help

araghav commented Aug 25, 2015

The script works very well in Ubuntu, but throws error "smtplib.smtpException: STARTTLS not supported by the server". OS is CentOS 6.4 and Python version 2.6

Struggling to get this working. Any help?


People, don't forget to uncomment the alertscripts path on the server config once you change it.

chuckxyu commented Sep 3, 2015

Anyone have tried this on Zabbix appliance?


chuckxyu commented Sep 4, 2015

After a while the script fails returning this message:

smtplib.SMTPServerDisconnected: Connection unexpectedly closed

Help anyone?

This script works well!!
I follow this steps on my ubuntu server

  1. check the value: AlertScript=blabla path into /etc/zabbiz/zabbix_server.conf
  2. put the script into blabla path
  3. chmod +x
  4. chown zabbix:zabbix
  5. go on zabbix
  6. Administration->Create Media type -> Script Name -> remember to enable and save
  7. Configuration->Action->Report problems... -> Tab Operation check values remember to enable and save
  8. Administration->Users-> Into admin account (you can filter with listbox Users menu top right page) -> Tab Media ->Add -> Type -> listbox: -> Send To -> your email -> Status -> Enable and save

Hope to help someone...

this script donot work for me although it work from command but not automatic

I used another way where I installed ssmtp and used mail command (after install mailutils on my server) to send emails using simple script

I used the following URLs to install ssmtp and add the script on my alertscript path

I used this script


export zabbixemailto="$1"
export zabbixsubject="$2"
export zabbixbody="$3"
echo "$zabbixbody" > /tmp/mymailinput
mail --subject="$zabbixsubject" $zabbixemailto < /tmp/mymailinput
rm /tmp/mymailinput

then save it as

then added this script as my media type

then configured the action and the emails send automatically

Miskude commented Jan 25, 2016

Fantastic script, thank you.

Thank you for a great script.

If you're using 2 factor auth for Gmail, then you will need to generate an App password.

admin@zabbix:/usr/lib/zabbix/alertscripts$ python ./
requires 3 parameters (recipient, subject, body)
$ recipient subject body

admin@zabbix:/usr/lib/zabbix/alertscripts$ python ./ Test-Subject Zabbix-Body

I checked my account and it was there instantly.

This script is really good. I used it for my office365 account, however, I am not able to get logs for any email sent by zabbix. I checked my mailbox "sent" but no email records are present there.

I would appreciate if anybody can suggest something.

can you post script for zabbix 3.0.2...

because it is working only till version only...

Thanks for the script.
I have been tried this script and in Actions log status is "Sent" but I don't receive the message in the email. I run this command from terminal and I receive emails: "python 'Subiect: Test Mail' 'Message: Ahoy!'"
Please someone can help me?

bhboots commented Jul 7, 2016

I have the same issue as costelolteanu on Zabbix version 3.0.3. Any help is appreciated.

bennetraja commented Jul 13, 2016

@bhboots and @costelolteanu, You would need to provide the following "Script parameters" - {ALERT.SENDTO}, {ALERT.SUBJECT} and {ALERT.MESSAGE}, while configuring the Media Type as "Script". It has been clearly documented on the Zabbix website under "Zabbix Documentation 3.0". Just follow it and you'll start receiving the Zabbix Alert mails as soon as it's done.

Franklin Bennet Raja

viettd commented Aug 18, 2016

That is what i need.
Thank @bennetraja.

The script is written in python, but named as .sh
Is this right?

And my python script isnt being executed after adding it into media types.
Audit says 'Sent'

I am getting bellow error in my /var/log/zabbix/zabbix_server.log after adding script to Media Types.

22037:20160914:052835.445 watchdog: no recipients found for database down messages

Please help.

what is suitable version for both zabbix and centos to this script

Zabbix says it "done" but never get an email I've tried .sh .py - nothing. But when I test manually I get emails without issue

rmsys commented May 29, 2017

Hi brinkdogg,

Same problem:
"Zabbix says it "done" but never get an email I've tried .sh .py - nothing. But when I test manually I get emails without issue"

sgjava commented May 30, 2017

I just set this up on Zabbix 3.2.6 built from source running on Ubuntu 16.04 using

  • I downloaded the script to /usr/local/share/zabbix/alertscripts and changed extension to .py
  • chmod +x *.py
  • chown -R zabbix:zabbix /usr/local/share/zabbix
  • In UI go to Administration, Media types, Create media type and enter Type Script, Name Gmail, Script name, add Script parameters: {ALERT.SENDTO}, {ALERT.SUBJECT}, {ALERT.MESSAGE} and click Add. This is important otherwise the parameters are not passed to the script.
  • In UI add the GMail media type to you user and set up action.

If it doesn't work then change Zabbix DebugLevel=4 and restart Zabbix server and test again. The look in log /tmp/zabbix_server.log for and after that you should see the return code and error message.

l0bz1k commented Aug 10, 2017

Works fine with Ubnt + Zabbbix 3.2.1 ))
Thanks to @bennetraja and others!
Don't forget to add "Script parameters" !!!

I followed those steps and it worked for Office365. Make sure that each script parameter is on its own line. I accidentally tried copying and pasting all of them into one parameter line which doesn't work.

I was also been experiencing the issue of not receive the alert mail.
I have done two things which solved the problem.

I have added the script parameters as suggested by @bennetraja
I have also set the media type name just as Script. not as the actual script name.

I have just created the account to share my findings here.
I am more than happy to help for those who still couldn't crack it after seeing this post.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment