AI Problems Diagnostic Assistant

PRO

AI assistant for diagnosing Zabbix problems from events This module adds an AI Assistant action and column to Monitoring -> Problems; it collects the event, trigger and expression, the items with their latest values and the hosts, then returns a streamed, formatted diagnostic and suggested remediation. Configuration lets super admins choose the AI provider (OpenAI, Google Gemini, Anthropic Claude or a custom OpenAI-compatible endpoint), enter provider API keys, select the model, edit the system role, enable answers in each user's Zabbix display language, and configure an optional MCP server. It is intended for Zabbix administrators and operators who need faster, contextual problem diagnosis and actionable suggestions without manual context gathering.

Zabbix 6.0 - 8.0

Buy AI Problems Diagnostic Assistant Read documentation

Screenshots

How to install

Step 1 · Operating system

Step 3 · Installation

PRO repositories are protected with HTTP basic auth. You need one personal repo token, then you point your package manager at the authenticated URL. A single token unlocks every product your account is entitled to - you do not need a token per widget.

wget https://repo.initmax.com/zabbix/release/initmax-release-latest_all.deb
dpkg -i initmax-release-latest_all.deb
printf 'machine repo.initmax.com login token password %s\n' 'TOKEN_VALUE' > /etc/apt/auth.conf.d/initmax.conf
chmod 600 /etc/apt/auth.conf.d/initmax.conf
sed -i -e '/^# Types: deb/,$ s/^# //' -e 's|USER:TOKEN@||' /etc/apt/sources.list.d/initmax.sources
apt update && apt install zabbix-module-ai-problems-diagnostic-assistant

rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
sed -i -e '/#\[initmax-zabbix-pro\]/,$ s/^#//' -e 's|USER:TOKEN|token:TOKEN|' /etc/yum.repos.d/initmax.repo
chmod 600 /etc/yum.repos.d/initmax.repo
dnf clean all && dnf install -y zabbix-module-ai-problems-diagnostic-assistant

rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm
sed -i -e '/#\[initmax-zabbix-pro\]/,$ s/^#//' -e 's|USER:TOKEN|token:TOKEN|' /etc/zypp/repos.d/initmax.repo
chmod 600 /etc/zypp/repos.d/initmax.repo
zypper --gpg-auto-import-keys refresh && zypper install -y zabbix-module-ai-problems-diagnostic-assistant

One token unlocks every PRO product on your account. If you cancel one product, the same token keeps working for the rest. Rotate or revoke tokens any time from the Portal.

Step 4 · Edit your Dockerfile

Paste the block after FROM in the final Zabbix frontend stage.

# initMAX ai-problems-diagnostic-assistant - Alpine (apk) package install
USER root
RUN --mount=type=secret,id=initmax_repo_token,required=true \
    apk add --no-cache ca-certificates curl \
    && curl -fsSL https://repo.initmax.com/zabbix/release/setup-alpine.sh -o /tmp/initmax-repo.sh \
    && sh /tmp/initmax-repo.sh --edition pro \
        --token-file /run/secrets/initmax_repo_token \
        -- apk add --no-cache zabbix-module-ai-problems-diagnostic-assistant \
    && rm -f /tmp/initmax-repo.sh
USER 1997

On the last line, keep the USER from your original image.

The block installs the newest available version when the installation step runs. Docker may reuse a cached layer. To keep a fixed version, use zabbix-module-ai-problems-diagnostic-assistant=2.6.4_p2-r3

Step 5 · Build your image

Reveal or create a repo token above. Run the filled command in a terminal in the Dockerfile directory; do not save it to a file.

# initMAX ai-problems-diagnostic-assistant - Alpine (apk) package install
INITMAX_REPO_TOKEN='TOKEN_VALUE' \
docker build --secret id=initmax_repo_token,env=INITMAX_REPO_TOKEN \
    -t zabbix-web-custom .

In Compose, use image zabbix-web-custom and recreate the frontend. In Zabbix, open Administration / General / Modules, Scan directory and enable the module.

More options

PRO uses your existing repo token as a Docker build secret. Do not put the token in Dockerfile instructions or ARG/ENV.

Buying another product later? Add its install block to the same Dockerfile; keep the existing blocks and products.

How build secrets work

Step 4 · Edit your Dockerfile

For Ubuntu / Debian frontend images. Add after FROM. Keep installed modules in the image; a volume over modules/ would hide package updates.

USER root
RUN --mount=type=secret,id=initmax_repo_token,required=true \
    apt-get update \
    && apt-get install -y --no-install-recommends ca-certificates curl \
    && curl -fsSL https://repo.initmax.com/zabbix/release/initmax-release-latest_all.deb -o /tmp/initmax-release.deb \
    && dpkg -i /tmp/initmax-release.deb \
    && cp /etc/apt/sources.list.d/initmax.sources /tmp/initmax.sources \
    && printf 'machine repo.initmax.com login token password %s\n' "$(cat /run/secrets/initmax_repo_token)" > /etc/apt/auth.conf.d/initmax.conf \
    && chmod 600 /etc/apt/auth.conf.d/initmax.conf \
    && sed -i -e '/^# Types: deb/,$ s/^# //' /etc/apt/sources.list.d/initmax.sources \
    && apt-get update \
    && apt-get install -y --no-install-recommends zabbix-module-ai-problems-diagnostic-assistant \
    && mv /tmp/initmax.sources /etc/apt/sources.list.d/initmax.sources \
    && rm -f /tmp/initmax-release.deb /etc/apt/auth.conf.d/initmax.conf \
    && rm -rf /var/lib/apt/lists/*
USER 1997

On the last line, keep the USER from your original image.

Step 5 · Build your image

Reveal or create a repo token above. Run the filled command in a terminal in the Dockerfile directory; do not save it to a file.

INITMAX_REPO_TOKEN='TOKEN_VALUE' \
docker build --secret id=initmax_repo_token,env=INITMAX_REPO_TOKEN \
    -t zabbix-web-custom .

In Compose, use image zabbix-web-custom and recreate the frontend. In Zabbix, open Administration / General / Modules, Scan directory and enable the module.

PRO uses your existing repo token as a Docker build secret. Do not put the token in Dockerfile instructions or ARG/ENV.

Step 4 · Edit your Dockerfile

For CentOS Stream / Oracle Linux frontend images. Add after FROM. DNF installs the RPM package; keep installed modules in the image, not a volume over modules/.

USER root
RUN --mount=type=secret,id=initmax_repo_token,required=true \
    if ! command -v dnf >/dev/null; then microdnf install -y dnf; fi \
    && { rpm -q initmax-release >/dev/null 2>&1 || rpm -Uvh https://repo.initmax.com/zabbix/release/initmax-release-latest.noarch.rpm; } \
    && cp /etc/yum.repos.d/initmax.repo /tmp/initmax.repo \
    && sed -i -e '/#\[initmax-zabbix-pro\]/,$ s/^#//' -e 's|USER:TOKEN@||' /etc/yum.repos.d/initmax.repo \
    && printf '\nusername=token\npassword=$initmax_repo_token\n' >> /etc/yum.repos.d/initmax.repo \
    && DNF_VAR_initmax_repo_token="$(cat /run/secrets/initmax_repo_token)" dnf install -y zabbix-module-ai-problems-diagnostic-assistant \
    && mv /tmp/initmax.repo /etc/yum.repos.d/initmax.repo \
    && dnf clean all
USER 1997

On the last line, keep the USER from your original image.

Step 5 · Build your image

Reveal or create a repo token above. Run the filled command in a terminal in the Dockerfile directory; do not save it to a file.

INITMAX_REPO_TOKEN='TOKEN_VALUE' \
docker build --secret id=initmax_repo_token,env=INITMAX_REPO_TOKEN \
    -t zabbix-web-custom .

In Compose, use image zabbix-web-custom and recreate the frontend. In Zabbix, open Administration / General / Modules, Scan directory and enable the module.

PRO uses your existing repo token as a Docker build secret. Do not put the token in Dockerfile instructions or ARG/ENV.

ZIP modules in a persistent volume. You manage updates manually.

1 · Download and extract the ZIP
2 · Mount the modules volume
3 · Copy the module into the volume
4 · Enable the module in Zabbix

For manual PRO installation, sign in with an account holding an active licence.

Have thoughts about AI Problems Diagnostic Assistant? Please send us feedback.

Releases

2.6.4 Latest 2026-11-13

PRO Sign in Buy PRO licence

Fix

Added Google Gemini model Gemini 4 Hydrogen (gemini-4-hydrogen).

2.6.3 2026-11-12

PRO Sign in Buy PRO licence

Fix

Added Google Gemini model Gemini Decision 1 (gemini-decision-1).

2.6.2 2026-11-11

PRO Sign in Buy PRO licence

Fix

Added Google Gemini model Gemini 4 Carbon (gemini-4-carbon).

Older versions (23)

2.6.1 2026-11-10

PRO Sign in Buy PRO licence

Fix

Added Anthropic Claude model Claude Fable 5.2 (claude-fable-5-2).
Send MCP function declarations as JSON Schema to Gemini and report plain JSON provider errors instead of silently dropping tools.
Parse MCP host counts in provider acceptance tests without treating safety/timestamp metadata as count data.

2.6.0 2026-11-05

PRO Sign in Buy PRO licence

Feature

Publish the Alpine (apk) package for Docker based Zabbix frontends (repo.initmax.com Alpine channel).

2.5.2 2026-10-27

PRO Sign in Buy PRO licence

Fix

Added OpenAI model GPT-6.1 Terra (gpt-6.1-terra).

2.5.1 2026-10-15

PRO Sign in Buy PRO licence

Fix

Ensure showcase capture works correctly on Zabbix 8.0.

2.5.0 2026-10-15

PRO Sign in Buy PRO licence

Feature

Add support for Zabbix 8.0 and enhance dark theme accessibility.

2.4.11 2026-10-14

PRO Sign in Buy PRO licence

Fix

Added Google Gemini model Gemini 4 Argon (gemini-4-argon).

2.4.10 2026-10-12

PRO Sign in Buy PRO licence

Fix

Added Google Gemini model Gemini Nano Banana 2.1 (gemini-nano-banana-2.1).
Added Anthropic Claude model Claude Haiku 5.5 (claude-haiku-5-5).

2.4.9 2026-09-30

PRO Sign in Buy PRO licence

Fix

Added OpenAI model GPT-6.1 Sol (gpt-6.1-sol).

2.4.7 2026-09-29

PRO Sign in Buy PRO licence

Fix

Added OpenAI model GPT-6 Luna (gpt-6-luna).
Added OpenAI model GPT-6 Sol (gpt-6-sol).
Added Anthropic Claude model Claude Opus 5.5 (claude-opus-5-5).
Added Anthropic Claude model Claude Sonnet 5.5 (claude-sonnet-5-5).

2.4.8 2026-09-29

PRO Sign in Buy PRO licence

Fix

Sorted supported AI models by generation, newest first.

2.4.6 2026-09-09

PRO Sign in Buy PRO licence

Preserve AI provider credentials while editing

2.4.5 2026-09-09

PRO Sign in Buy PRO licence

Publish current supported AI models

2.4.4 2026-09-09

PRO Sign in Buy PRO licence

Sync supported AI models

2.4.3 2026-09-02

PRO Sign in Buy PRO licence

Publish canonical WordPress product URL

2.4.2 2026-08-21

PRO Sign in Buy PRO licence

the answer spans the chat line again

2.4.1 2026-08-20

PRO Sign in Buy PRO licence

Gateways answer again: the language reminder rides the last user message

2.4.0 2026-08-20

PRO Sign in Buy PRO licence

Stored-secret masks, strict answer language and settings polish

2.3.4 2026-08-20

PRO Sign in Buy PRO licence

Dialog badge without the model name, full example endpoint URL, en_GB menu casing

2.3.3 2026-08-20

PRO Sign in Buy PRO licence

Dark themes: settings cards, labels, logo and reveal-eye follow the theme

2.3.2 2026-08-16

PRO Sign in Buy PRO licence

README on the combo skeleton: portal installer, feature table, same sections everywhere

2.3.1 2026-08-16

PRO Sign in Buy PRO licence

Catalog showcase spec: a scripted diagnosis on staged problems

2.3.0 2026-08-14

PRO Sign in Buy PRO licence

Name the model that answered, and keep checklists numbered

2.2.0 2026-08-14

PRO Sign in Buy PRO licence

Re-release the rename as 2.2.0

AI Problems Diagnostic Assistant

Screenshots

How to install

Step 4 · Edit your Dockerfile

Step 5 · Build your image

Step 4 · Edit your Dockerfile

Step 5 · Build your image

Step 4 · Edit your Dockerfile

Step 5 · Build your image

Releases

Added Google Gemini model Gemini 4 Hydrogen (gemini-4-hydrogen).

Added Google Gemini model Gemini Decision 1 (gemini-decision-1).

Added Google Gemini model Gemini 4 Carbon (gemini-4-carbon).

Added Anthropic Claude model Claude Fable 5.2 (claude-fable-5-2).

Send MCP function declarations as JSON Schema to Gemini and report plain JSON provider errors instead of silently dropping tools.

Parse MCP host counts in provider acceptance tests without treating safety/timestamp metadata as count data.

Publish the Alpine (apk) package for Docker based Zabbix frontends (repo.initmax.com Alpine channel).

Added OpenAI model GPT-6.1 Terra (gpt-6.1-terra).

Ensure showcase capture works correctly on Zabbix 8.0.

Add support for Zabbix 8.0 and enhance dark theme accessibility.

Added Google Gemini model Gemini 4 Argon (gemini-4-argon).

Added Google Gemini model Gemini Nano Banana 2.1 (gemini-nano-banana-2.1).

Added Anthropic Claude model Claude Haiku 5.5 (claude-haiku-5-5).

Added OpenAI model GPT-6.1 Sol (gpt-6.1-sol).

Added OpenAI model GPT-6 Luna (gpt-6-luna).

Added OpenAI model GPT-6 Sol (gpt-6-sol).

Added Anthropic Claude model Claude Opus 5.5 (claude-opus-5-5).

Added Anthropic Claude model Claude Sonnet 5.5 (claude-sonnet-5-5).

Sorted supported AI models by generation, newest first.

Preserve AI provider credentials while editing

Publish current supported AI models

Sync supported AI models

Publish canonical WordPress product URL

the answer spans the chat line again

Gateways answer again: the language reminder rides the last user message

Stored-secret masks, strict answer language and settings polish

Dialog badge without the model name, full example endpoint URL, en_GB menu casing

Dark themes: settings cards, labels, logo and reveal-eye follow the theme

README on the combo skeleton: portal installer, feature table, same sections everywhere

Catalog showcase spec: a scripted diagnosis on staged problems

Name the model that answered, and keep checklists numbered

Re-release the rename as 2.2.0

Added Google Gemini model Gemini 4 Hydrogen (`gemini-4-hydrogen`).

Added Google Gemini model Gemini Decision 1 (`gemini-decision-1`).

Added Google Gemini model Gemini 4 Carbon (`gemini-4-carbon`).

Added Anthropic Claude model Claude Fable 5.2 (`claude-fable-5-2`).

Added OpenAI model GPT-6.1 Terra (`gpt-6.1-terra`).

Added Google Gemini model Gemini 4 Argon (`gemini-4-argon`).

Added Google Gemini model Gemini Nano Banana 2.1 (`gemini-nano-banana-2.1`).

Added Anthropic Claude model Claude Haiku 5.5 (`claude-haiku-5-5`).

Added OpenAI model GPT-6.1 Sol (`gpt-6.1-sol`).

Added OpenAI model GPT-6 Luna (`gpt-6-luna`).

Added OpenAI model GPT-6 Sol (`gpt-6-sol`).

Added Anthropic Claude model Claude Opus 5.5 (`claude-opus-5-5`).

Added Anthropic Claude model Claude Sonnet 5.5 (`claude-sonnet-5-5`).