Skip to content

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
Copy link

dthom91 commented Dec 15, 2012

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

Copy link

dsociative commented Mar 14, 2013


Copy link

e4k4 commented Nov 26, 2013

Awesome, thank you!

Copy link

darren1973 commented Nov 27, 2013

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.

Copy link

wilyoj commented Jan 8, 2014

Works flawlessly, thanks.

Copy link

steelywing commented Sep 27, 2014

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

Copy link

Geo-Gee commented Oct 8, 2014

Fantastic script! I appreciate you sharing this.

Copy link

rggassner commented Nov 6, 2014

Flawless victory! Worked perfectly.

Copy link

axel-n commented Nov 27, 2014

Thank you very much!

Copy link

Superkikim commented Dec 5, 2014

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.

Copy link

powerdrogba commented Jan 12, 2015

What an incredible script.
Thank you so much!

Copy link

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

Copy link

ramxis commented Feb 13, 2015

any help will be greatly appreciated thank you

Copy link

RJReed67 commented Feb 19, 2015

ramxis, do you have python installed?

Copy link

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"

Copy link

abandin-stratio commented Feb 22, 2015


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

Copy link

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.

Copy link

aswinKM commented Mar 6, 2015

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

Copy link

kuzmenko-evgeniy commented Mar 26, 2015

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

Copy link

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)

Copy link

DarkStorm007 commented May 25, 2015

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.

Copy link

proligde commented May 31, 2015

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

Copy link

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.

Copy link

DarkStorm007 commented Jul 6, 2015

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...

Copy link

hoseinmontazer commented Jul 12, 2015

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

Copy link

engasmaasamir commented Aug 16, 2015

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

Copy link

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?


Copy link

cygnusbandit commented Aug 27, 2015

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

Copy link

chuckxyu commented Sep 3, 2015

Anyone have tried this on Zabbix appliance?


Copy link

chuckxyu commented Sep 4, 2015

After a while the script fails returning this message:

smtplib.SMTPServerDisconnected: Connection unexpectedly closed

Help anyone?

Copy link

trinkity commented Sep 11, 2015

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...

Copy link

engasmaasamir commented Oct 6, 2015

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

Copy link

Miskude commented Jan 25, 2016

Fantastic script, thank you.

Copy link

Komorebi-E commented Feb 6, 2016

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.

Copy link

rajiv2205 commented May 11, 2016

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.

Copy link

moorthy938 commented May 23, 2016

can you post script for zabbix 3.0.2...

because it is working only till version only...

Copy link

costelolteanu commented Jun 27, 2016

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?

Copy link

bhboots commented Jul 7, 2016

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

Copy link

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

Copy link

viettd commented Aug 18, 2016

That is what i need.
Thank @bennetraja.

Copy link

abhijith0505 commented Sep 3, 2016

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'

Copy link

sdbhabal commented Sep 14, 2016

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.

Copy link

ah0khali commented Nov 21, 2016

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

Copy link

brinkdogg commented Apr 9, 2017

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

Copy link

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"

Copy link

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:
    and click Add. This is important otherwise the parameters are not passed to the script.
  • In UI add the GMail media type to your user and set up action.

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

Copy link

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" !!!

Copy link

afield1235 commented Aug 11, 2017

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.

Copy link

raghusundaram commented Oct 6, 2017

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.

Copy link

vitutc commented Jun 5, 2018

It works!!! =D
Don't forget to add the script parameters as pointed about above!!! (follow sgjava's comment)

Copy link

sgjava commented Jul 10, 2018

OK folks, my Zabbix server sharted, so I had to rebuild it. A little different this time with ODROID XU4, mainline kernel, Ubuntu 18.04, Zabbix Server 3.4.11 and Python 3 (Python 2 not installed by default). Hopefully my loss is your gain :) Since the original script doesn't work on Python 3 you'll need to edit that. I was too lazy to do a PR :)

#!/usr/bin/env python3

from email.mime.text import MIMEText
from email.header import Header
from email.utils import formatdate

print(u'requires 3 parameters (recipient, subject, body) \t$ recipient subject body')

The rest of the stuff in my previous post is still relevant.

Test with:
sudo -H -u zabbix python3 /usr/local/share/zabbix/alertscripts/ test testbody

Copy link

CESARAUGUSTOALONKA commented Mar 4, 2019

Great job. This script works fine with Zabbix 4.0.5 running on Centos 7.6.1810

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