inovex/zax

Zabbix frontend for Android

ZAX

ZAX is a mobile frontend for the Zabbix enterprise monitoring system. It is free and has no limits.

This app shows you not only active triggers, events and latest item data, but has a few more features:

Features

• view current problems
• view events
• view latest Items
• view screens
• mark events as acknowledged
• history for items (graphs)
• push notifications - trigger updates in realtime (using Pubnub) - for setup instructions, see http://inovex.github.io/zax/#howto_push
• HTTP auth for proxy
• two homescreen widgets
• Zabbix 2.x support

For more information and screenshots, see our homepage: http://inovex.github.io/zax/

This app uses the following libraries:

• ActionBarSherlock (http://actionbarsherlock.com/)
• ViewPagerIndicator (http://viewpagerindicator.com/)
• NineOldAndroids (http://nineoldandroids.com/)
• OrmLite (http://ormlite.com/)
• Jackson Core (https://github.com/FasterXML/jackson-core)
• GraphView for Android (https://github.com/jjoe64/GraphView)
• Pubnub (http://www.pubnub.com/) A big thank you to all developers of these great products!

zax's Issues

Alternate sound for recovery on push notifications

Can we have option for a different sound on recovery vs problem?

update pubsub system / push notifications

Filter problems shown by severity

Do you think it would be possible to add an option to filter out by severity the problems shown? For example, i have some
triggers at Information level which shows if updates are avaiable for the host. Obviously these are low priority and it would be cool if i could "hide" them and sho only triggers with severity >= High, for exmple.

Cheers

Rotation portrait -> landscape duplicates one list row

User bug report:
I'm on Nexus 7 2012 KitKat. When rotating from portrait to landscape, 1 row of item (the last row) is being added to the listview on the left. E.g, if before the listview has 3 rows, after rotate it is now contains 4 rows. Rotate back to portrait, the extra row is still there unless refresh button is pressed. Take note, also when this happened, I've 2 level of severity, 1 item is at warning severity, 2 items are at disaster severity. The extra row is the exact duplicate from 1 of the disaster severity item. Maybe a bug somewhere in your Adapter. Just guessing though. Good luck.

Hint on activating push notifications

link to documentation

Disabled items still show

When i disable a item with active trigger in the zabbix frontend it's still shown on my phone. Is this on purpose?

Acknowledgement does NOT work properly

When I ack the event from ZAX (android) it applies to wrong event

Before ACK:

[root@wi-zabbix-vm91 include]$ mysql -uroot -e "select * from zabbix.events where objectid=14831"
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+
| eventid | source | object | objectid | clock      | value | acknowledged | ns        | value_changed |
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+
|   13772 |      0 |      0 |    14831 | 1349962914 |     2 |            0 |         0 |             0 |
|   13773 |      0 |      0 |    14831 | 1349962940 |     1 |            0 | 106041000 |             1 |
.......
|   15963 |      0 |      0 |    14831 | 1350220240 |     2 |            0 |         0 |             0 |
|   15984 |      0 |      0 |    14831 | 1350220256 |     1 |            0 | 789661000 |             0 |
|   16089 |      0 |      0 |    14831 | 1350221025 |     0 |            0 | 280882000 |             1 |
|   16090 |      0 |      0 |    14831 | 1350221065 |     1 |            0 | 308530000 |             1 |
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+

after ACK

[root@wi-zabbix-vm91 include]$ mysql -uroot -e "select * from zabbix.events where objectid=14831"
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+
| eventid | source | object | objectid | clock      | value | acknowledged | ns        | value_changed |
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+
|   13772 |      0 |      0 |    14831 | 1349962914 |     2 |            1 |         0 |             0 |
|   13773 |      0 |      0 |    14831 | 1349962940 |     1 |            0 | 106041000 |             1 |
.......
|   15984 |      0 |      0 |    14831 | 1350220256 |     1 |            0 | 789661000 |             0 |
|   16089 |      0 |      0 |    14831 | 1350221025 |     0 |            0 | 280882000 |             1 |
|   16090 |      0 |      0 |    14831 | 1350221065 |     1 |            0 | 308530000 |             1 |
+---------+--------+--------+----------+------------+-------+--------------+-----------+---------------+

ACKed 13772 event instead 16090

error connecting to pubnub

I have the latest version of zax and disabled then enabled pubnub.

Can there be an option to silence this error.

Should the error occur when Internet connectivity is working. ?

Monitor HTTP service of Zabbix Server itself and Alert.

Feature Request.

Zax should be able have built-in alert notification when it cannot get a code 200 response back from Zabbix server when Zabbix server itself is not responding.

I ran into this recently as zabbix server OS has been crashing and resulting in Zabbix monitoring not responding and obviously not getting alerts as the alert system is down so didn't notice until after waking up from sleeping (we all gotta sleep!)

I have another andriod app that is separate monitoring zabbix server called 'Website Monitor' however I'd rather have just one app :) - perhaps having this app features into Zax ?

Login Incorrect

hi, I installed ZAX and it worked, but trying another zabbix apps suddenly ZAX stop to work. Now I always get login incorrect, I uninstalled all zabbix app but still get login incorrect.

Show screens from templates

I defined my screens on templates and those don't appear. It would be nice if they would also show up in the list.

Perl Script returning errors?

Hi,

I'm trying to run the perl script on FreeBSD 10 but it keeps on throwing up errors:

Use of uninitialized value in split at /usr/local/etc/zabbix22/scripts/pubnub.pl line 27.
Use of uninitialized value $ARGV[1] in concatenation (.) or string at /usr/local/etc/zabbix22/scripts/pubnub.pl line 40.
Use of uninitialized value in concatenation (.) or string at /usr/local/etc/zabbix22/scripts/pubnub.pl line 40.
Use of uninitialized value in concatenation (.) or string at /usr/local/etc/zabbix22/scripts/pubnub.pl line 40.
Use of uninitialized value in print at /usr/local/etc/zabbix22/scripts/pubnub.pl line 44.

Perl version is: 5.16.3_11

I also have all the necessary Perl packages installed and have been following this guide:

http://inovex.github.io/zax/#howto_push

Though my Zabbix version is 2.2 but that shouldn't matter..... I think.

Can anyone help?

Thanks

Battery drain using new 1x1 widget

Poor internet connectivity can lead to the widget being stuck and causing battery drain.

push notification via c2dm

replace Pushnub service with google's c2dm

disabled hosts

List items in applications vanish on rotation

In "Checks", if an item is selected in portrait mode and then the screen is rotated to landscape, all items vanish from the list. They reappear only if the app is completely killed and restarted.

Default Theme has white text on light grey background in action-menu

Include Maps from Zabbix in the App

Hello,

it would be great to view the maps defined in Zabbix on a Smartphone/Tablet for example. Maybe this feature could be integrated into ZAX?

Thank you

widget problem on galaxy s5

Hi,
on Galaxy S5 the widget 1x1 has two problems:

1. The icon is too Big (too high)
2. The list of problems is shown only if I press the refresh button.

Thank's a lot.

Show only triggers with unacknowledged events

There has been a feature request to show only triggers with unacknowledged events, especially in the widget since the list can become quite long.

There should probably be a setting for this since the change might not be desired by every user.

migrate to Android Studio/Gradle + build server

Widget missing

The widget is not displaying.

Configuration:
Samsung Galaxy S4
Android 4.3

No Alerts from PubNub Push Notifications

Unable to receive any PubNub push alerts from Zabbix (v2.4.4) to ZAX (v2.4.2). This has never worked for this installation.

Using the PubNub Debug Console I have successfully sent test notifications to ZAX.

PubNub usage statistics indicates Zabbix notifications are being sent to PubNub.

Default Subject:

{TRIGGER.ID}

Default Message:

status={STATUS}
message={HOSTNAME}: {TRIGGER.NAME}: {STATUS}

Any assistance is appreciated.

Periodically keep Pubnub connection alive

Hi,

I don't want to burst this bubble - however.......

Leaving the phone after a while pubnub notifications stopped come thru.
I was watching Zabbix dashboard on the phone and noticed a PROBLEM in dashboard but it never came thru to the Zax app.

I sent tests via pubnub dev console and they didn't arrive even via 4G/WiFi

I did however manage to diagnose and replicate this method over 5 times:

UNTICK either of the following:

• Alternative notification icons
• Enabled

then RE-TICK either of the above - then this message is displayed:
'Successfully connected to Pubnub' is displayed

Then sending a message via pubnub dev console arrives straight away and so does pubnub.pl alerts from Zabbix.

Maybe there should be an option to refresh pubnub in the background to keep the connection to pubnub ?

Zabbix2 user configuration

Zabbix2 has the following fields:

Type (I set this to the pubnub notification I added in Media)
Send To (empty)
When active (times)
Use if severity (severities)

My question: what do I put in Send to?

Zax 2.0.3 widget issue

updated to 2.0.3 added widget and showing
0 > = high
3 < = avg

In zabbix server there is 0 averages
In ZAX app AVERAGE (0)

Add support for SNI on SSL connections

Connecting to SSL secured hosts that require SNI (Server Name Indication) support is currently not possible without accepting all certificates, which is of course undesirable. It would be nice if ZAX would support SNI so proper hostname based TLS negotiation can be performed.

I've done some research and found a couple of resources indicating that SNI is possible on Android.

http://source-android.frandroid.com/libcore/luni/src/main/java/libcore/net/http/HttpsURLConnectionImpl.java

http://source-android.frandroid.com/libcore/luni/src/main/java/libcore/net/http/HttpConnection.java

http://source-android.frandroid.com/libcore/luni/src/main/java/org/apache/harmony/xnet/provider/jsse/OpenSSLSocketImpl.java

There is an setHostname() method in OpenSSLSocketImpl that if called
causes NativeCrypto.SSL_set_tlsext_host_name() to be called. That in
turn calls SSL_set_tlsext_host_name().

Hopefully, this is helpful.

add proxy support

Set a proxy (socks at least) to be used to reach the zabbix server

Dark theme

Not an issue, but a feature request. I would like to see a dark theme which is AMOLED friendly. Thanks :-)

Zabbix 3.x support

Hi

ZAX is not working with Zabbix 3.0, probably due to API changes that break it. Hoping for a new version soon.

"Internal error"

Hi,

Just installed version 2.4.1 and upon entering my credentials, I'm getting "Internal error" on my screen. I'm running Zabbix version 2.3.2 (which is alpha for 2.4), maybe the loginprocedure has changed? Otherwise, I have no idea what could cause this.

Thanks!

pubnub script

I am not sure if i missed something but what script are u using for pubnub push messages?

Crash after touch on notification alert

Reported by Adx Grave

noted that after crash, there're 2 instance of zax process running in settings-->applications-->running services

W/System.err(19480): java.io.IOException: Expected data to start with an Array
W/System.err(19480): at com.inovex.zabbixmobile.api.ZabbixService._queryStream(ZabbixService.java:397)
W/System.err(19480): at com.inovex.zabbixmobile.api.ZabbixService.importTriggers(ZabbixService.java:1246)
W/System.err(19480): at com.inovex.zabbixmobile.ZabbixContentProvider.query(ZabbixContentProvider.java:407)
W/System.err(19480): at android.content.ContentProvider$Transport.query(ContentProvider.java:187)
W/System.err(19480): at android.content.ContentResolver.query(ContentResolver.java:271)
W/System.err(19480): at android.content.AsyncQueryHandler$WorkerHandler.handleMessage(AsyncQueryHandler.java:79)
W/System.err(19480): at android.os.Handler.dispatchMessage(Handler.java:99)
W/System.err(19480): at android.os.Looper.loop(Looper.java:130)
W/System.err(19480): at android.os.HandlerThread.run(HandlerThread.java:60)
I/HK/LatinKeyboardBaseView( 1743): closing org.pocketworkstation.pckeyboard.LatinKeyboardView@405ac838
I/HK/LatinKeyboardBaseView( 1743): closing org.pocketworkstation.pckeyboard.LatinKeyboardView@405ac838
D/AndroidRuntime(19480): Shutting down VM
W/dalvikvm(19480): threadid=1: thread exiting with uncaught exception (group=0x40015560)
E/AndroidRuntime(19480): FATAL EXCEPTION: main
E/AndroidRuntime(19480): java.lang.NullPointerException
E/AndroidRuntime(19480): at com.inovex.zabbixmobile.activities.MainActivitySmartphone$3.onQueryComplete(MainActivitySmartphone.java:203)
E/AndroidRuntime(19480): at android.content.AsyncQueryHandler.handleMessage(AsyncQueryHandler.java:344)
E/AndroidRuntime(19480): at android.os.Handler.dispatchMessage(Handler.java:99)
E/AndroidRuntime(19480): at android.os.Looper.loop(Looper.java:130)
E/AndroidRuntime(19480): at android.app.ActivityThread.main(ActivityThread.java:3835)
E/AndroidRuntime(19480): at java.lang.reflect.Method.invokeNative(Native Method)
E/AndroidRuntime(19480): at java.lang.reflect.Method.invoke(Method.java:507)
E/AndroidRuntime(19480): at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:864)
E/AndroidRuntime(19480): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:622)
E/AndroidRuntime(19480): at dalvik.system.NativeStart.main(Native Method)
W/ActivityManager( 1547): Force finishing activity com.inovex.zabbixmobile/.activities.MainActivitySmartphone

License

Hi,

I have a couple of questions i was unable to find the answer to.

Is the current version here the version placed on Google Play Market? If so could new releases get a tag?
Under what license is the source code released?
Depending on the above; Could the application be included in F-Droid? https://f-droid.org/wiki/page/Inclusion_Policy.

Last but not least. Great app. Thanks for sharing!

Simple independend internal alert notification (alternative to pubnub)

Hi, I'd prefer a simple internal notification method over an external and commercial/paid service like pubnub. It does not necessarily be a real time notification, it would be just great to have an simple configurable alert (sound/vibration) for new zabbix issues within a few (configurable) minutes after appearance.

Host data occasionally not available

In the problems view, it may happen that instead of the host name, "null" is displayed. Apparently, the data for the respective host is not available.

Zabbix 2.0.4 API Change

Doesn't work with zabbix 2.0.4. I got error.

Tab Problems: show nothing.

Tab Events:
JAVA.lang.illegaleStateException: JSON API error: code32500messageApplication error.datastoring by field "clock" not allowed./JSON API errorrror: code32500messageApplication error.datastoring by field "clock" not allowed

Tabs Checks: I have some hosts showed but when i select one nothing are showed after the selection

Tab Screens: I saw my screen name, and one a selected one the Zax Application crash and restart.

No Alerts from PubNub Push Notifications

Cant receive any PubNub push alerts from Zabbix (v2.4.3) to ZAX (up to date)

Test notifications to ZAX via PubNub Debug Console are successful.

Zabbix indicates that notifications are sent to PubNub.

Default Subject:

Default Message:

status={STATUS}
message={HOSTNAME}: {TRIGGER.NAME}: {STATUS}

Скрипт = Script

support for multiple zabbix servers

Push (pubnub) notification not working after update to version 2.5

Hello,

Yesterday update my Zax to version 2.5 and after update push notification doesn't working.
After update i filled pubnub Subscribe key again, but still doesn't working.
Thanks in advance!

Push Notification not working over WiFi

Hello.

I have noticed that the Push Notifications does not work over WiFi
as soon as WiFi is switched off the Push Notifications for PROBLEM and OK get delivered to my smartphone.

I ruled out being local WiFi issues as it happens at home, work and all WiFi hotspots.

Can this be fixed so the Push Notifications work also over WiFi ?

Enable / Disable Actions

Feature Request

During the standby service we sometimes like to change the responsible person for a couple of hours or a day. So I need to enable the action (notification via Mail->SMS) of my colleague and disable my action. For this it would be very nice to do this easily with the ZAX app so we don't need to use the laptop.

I would be very happy if this feature would be installed.

Zax with Zabbix 2.4.5 not showing latest events

When i click on Events (ALL) always show "No events found for this severity". Checks and Problems menu works fine.
When I was version 2.2 everything worked.
Thanks in advance!

displayed trigger name is "null"

Trigger acknowledge?

Hello! I was able to acknowladge triggers in v.1.6, is it possible to do this in 2.4.2? I can`t find button for this.

Replace trigger severity images

Currently, the images are not consistent between the app and the widget, which is confusing for users.

Widget refresh does not update the status image

When the widget is updated, the image indicating whether the overall status is ok or not, is not updated accordingly.

update push notification documentation to prevent nested-bracket error

Requesting an update to the documentation surrounding ZAX push notifications based on an issue I recently ran across.

We changed the Action subject slightly from the documentation to reference our Zabbix server name as well as the trigger, so instead of using "{TRIGGER.ID}" as the subject we used "[zabbix01]: {TRIGGER.ID}". This prevented PubNub from pushing the trigger to our devices as PubNub complained that nested brackets were invalid, although it was a difficult one to find as neither the pubnub.pl script nor the ZAX client referenced any error; push notifications just stopped working.

You might want to mention something to this effect when crafting the Action message in the ZAX documentation.

Old notification icons

In previous versions of Zax, the notification icons were a red x or a green check. This made it possible to see whether there has been an error or not without expanding the notification area.
Since 2.0.0, the notification icon is always the app's icon while the x or dash are secondary icons only visible when the notification area is expanded.
The old notification items have their advantages and could be brought back as a second option.

Disabled triggers should not be considered in the app

User report:
I have several triggers in zabbix that were failed, but then I disabled them. However, they still show up in the app and widget.

How can I get these old stale triggers to go away in the app?

Solution: Disabled triggers should not be shown in the app at all.