Skip to main content

Troubleshooting

Common Issues and Solutions​

Connection to Zabbix Server Failed​

If you're having trouble connecting MapZ to your Zabbix server:

  • Double-check the API URL, username, and password
  • Verify that the Zabbix API is enabled and accessible
  • Pay special attention to the URL format, ensuring it ends with api_jsonrpc.php
  • Check if your network allows connections to the Zabbix server API port
  • You must use SSL for the connection. Ensure that your Zabbix server is configured to accept SSL connections.

Hosts Not Appearing in Map​

If you can't see hosts in your map:

  • Ensure the host is correctly configured in Zabbix
  • Verify that the correct Zabbix server is selected in the MapZ map settings
  • Check that the Zabbix user has sufficient permissions to access the host data
  • Try refreshing the map or logging out and back in to MapZ

Interfaces Not Showing Up​

If host interfaces aren't appearing:

  • Make sure the "Interfaces SNMP" template is added to the host in Zabbix
  • Check the Zabbix item mappings in the interface properties
  • Verify you are connecting the interfaces correctly, using ALT+click to set the source
  • Ensure the Zabbix items for interface monitoring exist and are collecting data

Problems Not Displaying​

If problems aren't showing on your hosts:

  • Verify that Zabbix triggers are configured correctly
  • Check that the Zabbix server is sending problem events to MapZ
  • Ensure the problem is active in Zabbix
  • Try refreshing the map

Traces not working​

If you're having issues with the traceroute visualization:

  • Validate that the MTR template is loaded in Zabbix
  • Verify that the external script is configured as described in the Traces section
  • Check that the 'mtr' binary is executable on your Zabbix server

Frequently Asked Questions (FAQ)​

How do I change the icon for a host?​

Right-click on the host node, select "Properties," go to the "General" tab, and look for the icon selection option.

Can I import maps from other systems?​

Currently, MapZ doesn't support direct imports from other mapping systems. However, if you have your infrastructure already set up in Zabbix, MapZ can help you quickly recreate your maps.

Is there a mobile app for MapZ?​

MapZ is currently a web-based application optimized for desktop use. While it may work on mobile browsers, the experience is best on larger screens.

What ports does MapZ require to be open to connect to the Zabbix server?​

MapZ connects to your Zabbix server via the Zabbix API, which typically uses the same port as your Zabbix web interface (usually 80 or 443 for HTTP/HTTPS).

How frequently does MapZ update the problem statuses?​

MapZ polls the Zabbix server for updates regularly. The exact frequency depends on your subscription tier, but it's typically every 30-60 seconds.

Glossary of Terms​

Zabbix API: The Application Programming Interface that Zabbix uses to allow external applications to access and manipulate Zabbix data.

Monitored Item: A specific metric that Zabbix is collecting data on for a host (e.g., CPU usage, memory usage, disk space).

Trigger: A condition that is evaluated by Zabbix based on the values of monitored items. When a trigger's condition is met, it generates a problem event.

Host Template: A pre-defined set of monitored items, triggers, and other configurations that can be applied to a host in Zabbix. This simplifies the process of configuring monitoring for similar types of devices.