Description
A simple but powerful widget designed for clear matrix display of issues for specific host groups. matrixMAX can play a vital role in streamlined overview of your services or infrastructure. It works as a standalone widget, for best result combine with matrixMAX-detail and/or inventoryMAX widgets. Main idea of the widget visualization is based on tagging on trigger level in format key:value format, default is tag matrix:value ( can be customized manually ).
Usage examples
Several triggers representing services on hosts in host group ‘DEMO/matrixmax-1’ have been tagged with tag matrix and corresponding value. User uses the ‘Load tags’ to automatically load all triggers in to a matrix table. Rows represent the hosts ( if default matrix tags is used they are automatically loaded ), columns represent tagged services. In this example the host ‘DataTitan.cloudcompany.com’ is crossed because its disabled in Zabbix. Cells are visualized through colors based on the trigger severity. For more details consult documentation chapter on this page.
Installation
Repository setup on the server
Connect to your Zabbix frontend server (perform on all frontend nodes) via SSH
Navigate to the /modules folder (typically located at /usr/share/zabbix/ or /usr/share/zabbix/ui/ from Zabbix 7.2)
cd /usr/share/zabbix/modules/Clone the repository on your server
#PRO
git clone https://git:<<YOUR-TOKEN>>@git.initmax.cz/initMAX-Public/Zabbix-UI-Widgets-matrixMAX-PRO.gitChange the ownership of the directory to the user under which your Zabbix frontend is running using the chown command (cat /etc/passwd to find which user was created during installation), some examples:
chown nginx:nginx ./Zabbix-UI-Widgets-matrixMAX-PRO*chown apache:apache ./Zabbix-UI-Widgets-matrixMAX-PRO*chown www-data:www-data ./Zabbix-UI-Widgets-matrixMAX-PRO*Frontend module initialization
Navigate to the Zabbix frontend menu and select: Administration → General → Modules
Use the ‘Scan directory’ button at the top
Enable the newly discovered module/widget
The module is available in the menu
Configuration matrixMAX
The matrixMAX widget works based on tags that are present on triggers. Each trigger that you will want to include in matrixMAX visual matrix must have a tag key “matrix” with some value eg.: memory etc. for automatic flow to work ( use Load tags button ) or the tags ( key:value format ) can be specified manually.
| Field | Description |
| Type | Choose widget type – matrixMAX |
| Name | Distinctive name of the widget |
| Refresh interval | How often is data loaded into the widget |
| Host groups | Choose at least one host group or multiple |
| Exclude host groups | Specify which host groups will be excluded |
| Hosts | Select specific hosts. Note: Disabled hosts are striked through. |
| Severity | Choose which severity the widget will display |
| Problem tags | You can load tags with a tag key matrix automatically or fill them in manually |
| Host order by | Select host order logic, or choose custom and manually rearrange them |
| Show suppressed problems | Option to include suppressed problems |
Configuration matrixMAX-detail
The matrixMAX-detail will allow you to only choose the matrixMAX widget and up to three inventory fields based on their macros.
| Field | Description |
| Type | choose matrixMAX-detail |
| Name | Distinctive name for widget |
| Refresh interval | How often is data loaded into the widget |
| MatrixMAX widget | Choose which matrixMAX widget will be able to display details here |
| Inventory fields | Label and Value using the Inventory macro that will be displayed behind the host name |
Features matrixMAX
Left click
- On the host will direct you to the Monitoring => Problems section with a predefined filter using the host name to show you Recent problems
- On the trigger will direct you to the Monitoring => Problems section with a predefined filter using the trigger tag to show you Recent problems
Right clik
- Clicking on the host will show the classic Zabbix host menu
- Clicking on the trigger cell will show the classic Zabbix item menu
Feature matrixMAX-detail
Clicking on the trigger cell in matrixMax will show additional information for the trigger in the matrixMax-detail widget if configured. Information contains last three problems, event details, action log and a quick access menu. Furthermore you have possibility to use function like execute now, see history and graphs for related items or update the event itself. If the data collected by the item is in HTML format, it can also be turned into a table for a quick overview for further analysis.
For uptime feature to work in matrixMax-detail the corresponding item needs to have tag: matrix:uptime.
Where to get it?
If you’re interested in this widget, you can find it in our e-shop. There you’ll learn more about the available versions and how to get the product.