Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

AI Problems Diagnostic Assistant

developed and maintained by initMAX and community

An AI Assistant button on every row of Monitoring -> Problems.
Click it and the assistant already knows the event, its trigger, the items behind it, their latest values and the hosts they run on. No copy-pasting a problem into a chat window, and no explaining your topology first.

Zabbix 6.0-7.4 version 2.4.3 PHP 7.4+ PRO commercial GPG signed

Features  ·  Examples  ·  Install  ·  FREE vs PRO  ·  Portal  ·  Docs


A finished diagnosis turns the selected Zabbix problem and live context into structured, actionable checks.

Why AI Problems Diagnostic Assistant

The slow part of an incident is rarely the fix. It is working out what the alert is actually telling you - which item fired it, what its value was doing, what else on that host is unhappy, and whether any of it matters.

This module puts an assistant one click away from the problem itself. It collects the event, the trigger and its expression, the items involved with their latest values and value maps, and the hosts, and hands all of it to the model with your own system role in front. You get a first read on the incident without leaving the Problems screen.

What you can build

One click from the problem An AI Assistant column next to the problem name, on the same screen your operators already live on.

Starts with the context Event, trigger, expression, items, latest values, value maps and hosts - collected server-side and sent with the first question.

Four back ends OpenAI, Google Gemini, Anthropic Claude, or any OpenAI-compatible endpoint you run yourself. Every answer is labelled with the provider and model that produced it.

Streamed, markdown answers Answers render as they arrive, with a stop button, and formatted rather than as a wall of text.

Your system role The shipped prompt is a starting point and is editable on the settings page - set the house style once, for everyone.

Answers in your language Optionally tells the model to reply in each user's own Zabbix display language.

Examples

Problem list
Problem list - The clearly marked AI Assistant action is available directly beside each supported Zabbix problem.
Follow up
Follow up - Ask a follow-up in the same dialog - the answer keeps the problem context and comes back with copy-ready commands.

Configuration

Everything lives on one page - Administration → AI general → AI Problems Diagnostic Assistant.

Pick the service (OpenAI, Gemini, Claude, or a custom OpenAI-compatible endpoint), paste the API key, choose the model, and edit the system role if you want to. Add language to system role tells the model to answer in each user's own Zabbix display language.

AI Problems Diagnostic Assistant configuration
## Install

PRO ships as GPG-signed deb / rpm packages from the initMAX repository - apt / dnf installs them and keeps them updated.

Easiest way - the guided installer on the Portal

Open the product page, pick your OS and edition, and copy the ready-made command. FREE is fully public (no login); PRO fills in your token once you sign in. There's a feedback box right there too.

Guided installer on the initMAX Portal - click to open

→ Open the installer on the Portal

Prefer a plain archive? Every release also ships as a ZIP, downloadable from the portal once you sign in - handy for offline or manual installs.

The module is enabled automatically during the package installation - verify it in Administration → General → Modules. Done.

FREE vs PRO

This product has one edition. There is no free build: the whole module is the paid capability, so there is nothing to gate and nothing to compare against.

Feature PRO
AI Assistant column on Monitoring -> Problems
Event, trigger, items, latest values and hosts sent as context
OpenAI back end, with a model you choose
Google Gemini back end, with a model you choose
Anthropic Claude back end, with a model you choose
Any OpenAI-compatible endpoint of your own
Streamed answers, rendered as markdown, with a stop button
Editable system role
Answers in each user's own Zabbix display language
One package for Zabbix 6.0 - 7.4
Localised into all 25 Zabbix display languages
High availability ready
Licence Commercial

Requirements

Zabbix 6.0 · 6.2 · 6.4 · 7.0 · 7.2 · 7.4 - one package covers all
PHP 7.4 or newer
OS Debian/Ubuntu · RHEL/Rocky/Alma/Oracle/Amazon · SUSE
Editions PRO (token-gated repo) - there is no free edition
Permissions Super admin to configure it; Admin or Super admin to use it on a problem
AI service An OpenAI, Gemini or Claude API key, or an OpenAI-compatible endpoint you run yourself
Outbound access The Zabbix frontend (PHP) calls the configured AI endpoint and optional MCP server. The browser talks only to the local Zabbix action.
Languages All 25 Zabbix display languages - the module follows each user's own language setting
High availability Ready. The configuration lives in the Zabbix database, not on the frontend node - install it on every node of an HA cluster and any node can serve it

Across Zabbix versions

One package carries both module trees and installs the right one for the frontend it finds - Zabbix accepts the older manifest format only below 6.4 and the newer one only from 6.4 up. Upgrading Zabbix under an installed module switches trees on its own; the module's settings are untouched.

Monitoring -> Problems is one of the few screens Zabbix has carried unchanged across this whole range, which is why the column, the dialog and the settings page are the same on all six versions - same fields, same labels, same order, same branding.

Two frontend differences are worth knowing about, and neither costs you a capability:

  • On Zabbix 6.0 the settings page has no documentation link in its header, because that frontend's page shell has nowhere to put one. Zabbix added it in 6.2.
  • Zabbix renamed the dialog's header wrapper in 7.0. The module styles both, so the dialog is branded on every version - it was not before 7.0.

There are no capabilities left out on any supported version.

A note on where the key goes

The assistant talks to the AI service from the Zabbix frontend (PHP). The browser sends only the conversation to the module's guarded apda.chat action and receives a normalized response stream. Provider keys, the MCP URL and the MCP bearer token are resolved and used server-side; stored secret values are not rendered back into the settings page - a saved key or MCP token shows only as a mask of its length, and the reveal eye fetches the value on an explicit super-admin click. A public AI provider therefore never connects to an internal MCP address directly: the frontend exposes selected MCP tools to the model as function definitions, executes approved calls itself and returns only the selected tool result to the model. Users below Admin are not offered the problem-list assistant.

Support & links


PRO: commercial  ·  © 2021-2026 initMAX s.r.o.

About

AI assistant that analyzes Zabbix hosts, items and events to help diagnose and resolve monitoring problems.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors