Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

AI Preprocessing Assistant

developed and maintained by initMAX and community

Stop guessing at preprocessing steps. Show the assistant one raw value and it writes the chain for you.
It reads the item you are editing and the value the host actually returned, asks what you want out of it, and then fills the Preprocessing tab in - steps, parameters, custom-on-fail and type of information included.

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

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


The assistant works inside the Zabbix preprocessing test dialog and guides the operator from a real input value to a usable transformation.

Why AI Preprocessing Assistant

Preprocessing is where most Zabbix items are won or lost, and it is fiddly: a JSONPath here, a regex there, a multiplier, a "discard unchanged with heartbeat", and a custom-on-fail branch for the day the device answers something else. Working it out from the documentation takes longer than collecting the value did.

This module puts an assistant next to the item you are already editing. It knows the item's configuration and the raw value the host just returned, so the conversation starts from your data rather than from a blank prompt - and when you are happy with what it proposes, one button writes the steps into the form. You still review and save them yourself; nothing is stored until you press Update.

What you can build

Starts from the real value Press Get value and the assistant sees exactly what the host returned, together with the item's key, type and value type.

Asks what you want It opens by asking for the desired outcome - a unit, a range, a field out of a JSON blob - instead of assuming.

Writes the chain into the form Add preprocessing clears the existing steps and fills in the proposed ones, with parameters, custom-on-fail and error handling.

Sets the type of information A chain that turns text into a number is worthless if the item is still a character item, so the assistant sets that too.

Your model, your endpoint OpenAI with a model you pick, or any OpenAI-compatible endpoint you host yourself.

Your prompts The shipped system role and first prompt are both editable on the settings page - tune the house style once, for everyone.

Examples

Item form
Item form - The highlighted AI Preprocessing Assistant button is available directly on the item preprocessing tab.

Configuration

Everything lives on one page - Administration → AI General → AI Preprocessing Assistant.

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

AI Preprocessing 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
Assistant on the item form, started from the item's real value
Writes the proposed preprocessing steps into the form
Sets custom-on-fail and error handling per step
Sets the item's type of information to match the chain
OpenAI, or any OpenAI-compatible endpoint of your own
Editable system role and first prompt
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 an item
AI service An OpenAI API key, or an OpenAI-compatible endpoint you run yourself
Outbound access The browser calls the configured endpoint directly, so it is the operator's workstation that needs to reach it, not the Zabbix frontend host
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.

The assistant, its settings page and the dialog it opens are the same on all six versions - same fields, same labels, same order. What differs is the frontend's own furniture, and none of it costs you a capability:

  • Up to Zabbix 6.4 the item form is a page (items.php); from 7.0 it is a modal dialog. The assistant button sits with the form's own buttons either way.
  • 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.

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 browser, with the API key that is stored on the settings page. That is what makes the streamed answer and the live tool calls work without a round trip through the Zabbix frontend - and it means the key is readable by any Admin or Super admin who opens an item page, and that the request comes from their workstation. Point the module at a self-hosted or gateway endpoint if that is not what you want; the Custom service exists for exactly that.

Support & links


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

About

AI assistant for Zabbix preprocessing configuration, parsing rules, field extraction and preprocessing pipelines.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors