“Why on earth was I not notified?!” — ever heard that question from a fellow worker? Setting up notifications can be a challenge — and not only for beginners. Normally, debugging such cases is cumbersome, complex and requires a good understanding of how Zabbix works. Were you ever asked for a list of people who would be notified on some event? It’s hard to tell, until the event actually happens. Or at least it used to:
The Action Simulator tries to relieve you from these problems and make you and your co-workers happy again.
First off, the Action Simulator is not part of Zabbix, or at least not yet. It’s a community effort instead. It’s not mature software, but rather work in progress. It certainly has bugs and doesn’t cover every use case yet. But that should not frighten you: You can readily use it with your 2.0.4 frontend. No re-compilation, no database schema changes and it will certainly not damage your data. But let’s take a look at what it can do first!
What it does and what it looks like
The Action Simulator’s goal is to clearly answer who is notified in case of a specific event. Notifications often don’t turn out as expected, for various reasons, like permissions or mistakes in action conditions. To debug such cases, the simulator provides additional information. No events are caused and no notifications are actually sent. It’s really a simulator. The only visible change is an additional column in the trigger configuration list. It contains links that open a pop-up window. The pop-up contains a list of all notifications and collapsible debugging information.
The information in the pop-up helps you to hunt down errors in:
- Action conditions (logical errors, typos, lax conditions, …)
- Operations (forgotten users, group memberships)
- Permissions to host
- Media setup (user media not defined, severity, …)
Let’s assume you set up a trigger to fire if the checksum of sshd changes. You expect 3 actions to run, as soon as the event happens, doing the following:
- The two GNU/Linux admins are notified via SMS and e-mail
- Head of security gets an e-mail
- Network administration gets an e-mail
Turns out, it doesn’t happen! The only thing that works, is e-mail for the GNU/Linux admins. What happened to SMS? What happened to the other two e-mails?
Taking a look at the Action Simulator pop-up, things become clear:
How to try it
You can easily test the Action Simulator in a copy of the frontend in any environment. No database changes or re-compilation is necessary. You can just copy your frontend directory, apply the patch to the copy and configure web server to serve this frontend in parallel.
# Download the patch wget -O /tmp/action_simv3.2.patch http://www.geofrogger.net/review/actionsim/v3/action_simv3.2.patch # Copy your frontend cp -pr /usr/share/zabbix /usr/local/share/zabbix_actionsim # Patch it cd /usr/local/share/zabbix_actionsim patch -p0 < /tmp/action_simv3.2.patch
- Update, 24 Jan 2013: http://www.geofrogger.net/review/actionsim/v4/action_simv4.patch
- Update, 17 Feb 2013: http://www.geofrogger.net/review/actionsim/v4/action_simv4.1.patch
- Update, 17 Feb 2013: http://www.geofrogger.net/review/actionsim/v4/action_simv4.2.patch
- Update, 18 Feb 2013: http://www.geofrogger.net/review/actionsim/v4/action_simv4.3.patch
- Update, 22 Mar 2013: http://www.geofrogger.net/review/actionsim/v4/action_simv4.4.patch
Keep an eye open for later versions! All that’s left, is copying and manipulating your web server configuration to serve this directory under a different URL and reload it. You can run as many frontends in parallel as you want. The patch applies to vanilla Zabbix 2.0.4 frontend without errors.
Some known limitations
- Only works properly for Zabbix Super Admins
Only shows notifications — no commands
- Has no sense of escalation yet
- Doesn’t yet consider temporal constraints for actions and user media, as well as some other action conditions
Update, 17 Feb 2013: Commands are shown from v4 on.
Please be graceful, report bugs and share your opinion on the current design. The author is working towards escalation at the time of this writing.
For further information, known bugs and limitations, as well as future plans, please visit: https://www.zabbix.org/wiki/Docs/action_simulator
Also consider to vote on the ZBXNEXT-97 ticket!