allenta / zabbix-template-for-redis

Zabbix template + script useful to monitor Redis Server & Redis Sentinel instances

This is a Zabbix template + script useful to monitor Redis Server & Redis Sentinel instances:

1. Copy zabbix-redis.py to /usr/local/bin/.

2. Add the redis_server.discovery & redis_server.stats and / or redis_sentinel.discovery & redis_sentinel.stats user parameters to Zabbix:

   UserParameter=redis_server.discovery[*],/usr/local/bin/zabbix-redis.py -i '$1' -t server discover $2 2> /dev/null
   UserParameter=redis_server.stats[*],/usr/local/bin/zabbix-redis.py -i '$1' -t server stats 2> /dev/null
   UserParameter=redis_sentinel.discovery[*],/usr/local/bin/zabbix-redis.py -i '$1' -t sentinel discover $2 2> /dev/null
   UserParameter=redis_sentinel.stats[*],/usr/local/bin/zabbix-redis.py -i '$1' -t sentinel stats 2> /dev/null

3. Import the templates. You may download the appropriate versions from the releases page or generate them using the Jinja2 skeletons:

   $ pip install jinja2-cli
   $ PYTHONPATH=. jinja2 \
       -D version={6.0,6.2,6.4} \
       [-D name='Redis Server'] \
       [-D description=''] \
       [-D release='trunk'] \
       --extension=extensions.zabbix.ZabbixExtension --strict -o template.xml template-app-redis-server.j2
   $ PYTHONPATH=. jinja2 \
       -D version={6.0,6.2,6.4} \
       [-D name='Redis Sentinel'] \
       [-D description=''] \
       [-D release='trunk'] \
       --extension=extensions.zabbix.ZabbixExtension --strict -o template.xml template-app-redis-sentinel.j2

4. Link hosts to the templates. Beware depending on the used template you must set a value for the {$REDIS_SERVER.LOCATIONS} or {$REDIS_SENTINEL.LOCATIONS} macro (comma-delimited list of Redis instances; port, host:port and unix:///path/to/socket formats are allowed). Additional macros and contexts are available for further customizations.

zabbix-template-for-redis's Issues

What if I use a password for authorization?

Can you clarify what the "eps" unit is?

Just trying to understand what I'm seeing in my graphs. I see that this is taking a Delta from the last reading. I'm assuming it's "executions per second" or something of that nature?

redis_server.info key missing?

Seems like a very well thought through template for redis. I'm a bit confused though.. the templates reference keys redis_server.info and redis_sentinel.info, that aren't defined in the zabbix agent configuration file. Is there something I don't understand here?

--redis-password not work

There should be a blank space line 195
opts += ' -a "%s"' % password

Redis 6.0 + SSL

Hi,
does your template have support for SSL option for redis server/sentinel? ( https://redis.io/topics/encryption )
thanks.

Specific instructions needed

Hi, thanks for your template, looks good! But I don't really know where should I add the parameters, server? agent ? where? Could you provide better instructions? Thanks

error running python code

Hi
when I use your script to monitor redis,I get this error:
/usr/local/bin/zabbix-redis.py -i '6379, 6380, 6381, 7000, 7001, 7002, 7003, 7004, 7005' -t server send -c /etc/zabbix/zabbix_agentd.conf -s dev

Traceback (most recent call last):
File "/usr/local/bin/zabbix-redis.py", line 380, in
main()
File "/usr/local/bin/zabbix-redis.py", line 376, in main
globals()options.command
File "/usr/local/bin/zabbix-redis.py", line 101, in send
items = stats(instance, options.redis_type)
File "/usr/local/bin/zabbix-redis.py", line 240, in stats
sys.stderr.write(output)
TypeError: write() argument must be str, not bytes

can you help me?
thanks

Password authentification

Hello,

How to use this script with password auth on redis?

Thanks you for helping

Cannot import your template for Zabbix 3.0.2

Invalid XML tag "/zabbix_export/templates/template(1)/items/item(1)": the tag "multiplier" is missing.

Can you make it compatible with Zabbix 3.0.2?