Documentation

1 Frequently asked questions / Troubleshooting

1 Création de la base de données

2 Repairing Zabbix database character set and collation

2 Zabbix agent on Microsoft Windows

3 Elasticsearch setup

3 Secure connection to the database

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

4 Real-time export of events, values, trends

4 TimescaleDB setup

7 Distribution-specific notes on setting up Nginx for Zabbix

8 Running agent as root

10 SAML setup with Okta

11 Additional frontend languages

3 Daemon configuration

1 Zabbix server

2 Zabbix proxy

3 Zabbix agent (UNIX)

4 Zabbix agent (Windows)

4 Zabbix agent 2 (UNIX)

5 Zabbix Java gateway

6 Special notes on "Include" parameter

6 Zabbix agent 2 (Windows)

4 Protocols

1 Server-proxy data exchange protocol

2 Zabbix agent protocol

3 Zabbix agent 2 protocol

3 Zabbix sender protocol

4 Header and data length

4 Zabbix agent 2 plugin protocol

5 Real-time export protocol

5 Items

1 Items supported by platform

2 vm.memory.size parameters

3 Passive and active agent checks

4 Trapper items

5 Encoding of returned values

5 Minimum permission level for Windows agent items

6 Large file support

7 Sensor

8 Notes on memtype parameter in proc.mem items

9 Notes on selecting processes in proc.mem and proc.num items

10 Implementation details of net.tcp.service and net.udp.service checks

12 Unreachable/unavailable host settings

13 Remote monitoring of Zabbix stats

14 Configuring Kerberos with Zabbix

6 Triggers

1 Supported trigger functions

7 Macros

1 Macros supported by location

2 User macros supported by location

9 Setting time periods

10 Command execution

13 Version compatibility

14 Database error handling

14 Python library for Zabbix API

15 Zabbix sender dynamic link library for Windows

16 Issues with SELinux

17 Other issues

18 Agent vs agent 2 comparison

1. Introduction

1 Structure du manuel

2 Qu'est-ce que Zabbix ?

3 Fonctionnalités Zabbix

4 Aperçu de Zabbix

5 What's new in Zabbix 5.0.0

6 What's new in Zabbix 5.0.1

7 What's new in Zabbix 5.0.2

8 What's new in Zabbix 5.0.3

9 What's new in Zabbix 5.0.4

10 What's new in Zabbix 5.0.5

11 What's new in Zabbix 5.0.6

12 What's new in Zabbix 5.0.7

13 What's new in Zabbix 5.0.8

14 What's new in Zabbix 5.0.9

15 What's new in Zabbix 5.0.10

15 What's new in Zabbix 5.0.11

16 What's new in Zabbix 5.0.12

17 What's new in Zabbix 5.0.13

18 What's new in Zabbix 5.0.14

19 What's new in Zabbix 5.0.15

20 What's new in Zabbix 5.0.16

21 What's new in Zabbix 5.0.17

22 What's new in Zabbix 5.0.18

23 What's new in Zabbix 5.0.19

24 What's new in Zabbix 5.0.20

25 What's new in Zabbix 5.0.21

26 What's new in Zabbix 5.0.22

27 What's new in Zabbix 5.0.23

28 What's new in Zabbix 5.0.24

29 What's new in Zabbix 5.0.25

30 What's new in Zabbix 5.0.26

31 What's new in Zabbix 5.0.27

32 What's new in Zabbix 5.0.28

33 What's new in Zabbix 5.0.29

34 What's new in Zabbix 5.0.30

35 What's new in Zabbix 5.0.31

36 What's new in Zabbix 5.0.32

37 What's new in Zabbix 5.0.33

38 What's new in Zabbix 5.0.34

39 What's new in Zabbix 5.0.35

40 What's new in Zabbix 5.0.36

41 What's new in Zabbix 5.0.37

42 What's new in Zabbix 5.0.38

43 What's new in Zabbix 5.0.39

44 What's new in Zabbix 5.0.40

45 What's new in Zabbix 5.0.41

46 What's new in Zabbix 5.0.42

47 What's new in Zabbix 5.0.43

2. Définitions

3. Processus Zabbix

1 Serveur

2 Agent

3 Agent 2

3 Proxy

4 Passerelle Java

1 Setup from sources

2 Setup from RHEL/CentOS packages

3 Setup from Debian/Ubuntu packages

5 Sender

6 Get

8 JS

4. Installation

1 Obtenir Zabbix

Bonnes pratiques pour la configuration sécurisée de Zabbix

3 Installation depuis les sources

Building Zabbix agent 2 on Windows

Building Zabbix agent on macOS

Building Zabbix agent on Windows

4 Installation depuis les packages

1 Red Hat Enterprise Linux/CentOS

2 Debian/Ubuntu

3 SUSE Linux Enterprise Server

4 Windows agent installation from MSI

5 Mac OS agent installation from PKG

5 Installation depuis les containers

Installation with OpenShift

6 Procédure de mise à jour

Mise à jour depuis les packages

1 Red Hat Enterprise Linux/CentOS

2 Debian/Ubuntu

Mise à jour depuis les sources

6 Web interface installation

1 RHEL/CentOS 7 frontend installation

Updating to PHP 7.3 packages

2 Debian/Ubuntu frontend installation

7 Problèmes connus

1 Compilation issues

8 Modifications des modèles

10 Upgrade notes for 5.0.0

11 Upgrade notes for 5.0.1

12 Upgrade notes for 5.0.2

13 Upgrade notes for 5.0.3

14 Upgrade notes for 5.0.4

15 Upgrade notes for 5.0.5

16 Upgrade notes for 5.0.6

17 Upgrade notes for 5.0.7

18 Upgrade notes for 5.0.8

19 Upgrade notes for 5.0.9

20 Upgrade notes for 5.0.10

21 Upgrade notes for 5.0.11

22 Upgrade notes for 5.0.12

23 Upgrade notes for 5.0.13

24 Upgrade notes for 5.0.14

25 Upgrade notes for 5.0.15

26 Upgrade notes for 5.0.16

27 Upgrade notes for 5.0.17

28 Upgrade notes for 5.0.18

29 Upgrade notes for 5.0.19

30 Upgrade notes for 5.0.20

31 Upgrade notes for 5.0.21

32 Upgrade notes for 5.0.22

33 Upgrade notes for 5.0.23

34 Upgrade notes for 5.0.24

35 Upgrade notes for 5.0.25

36 Upgrade notes for 5.0.26

37 Upgrade notes for 5.0.27

38 Upgrade notes for 5.0.28

39 Upgrade notes for 5.0.29

40 Upgrade notes for 5.0.30

41 Upgrade notes for 5.0.31

42 Upgrade notes for 5.0.32

43 Upgrade notes for 5.0.33

44 Upgrade notes for 5.0.34

45 Upgrade notes for 5.0.35

46 Upgrade notes for 5.0.36

47 Upgrade notes for 5.0.37

48 Upgrade notes for 5.0.38

49 Upgrade notes for 5.0.39

50 Upgrade notes for 5.0.40

51 Upgrade notes for 5.0.41

52 Upgrade notes for 5.0.42

5. Démarrage rapide

1 Identification et configuration des utilisateurs

3 Nouvel élément

4 Nouveau déclencheur

5 Réception des notifications de problèmes

6 Nouveau modèle

6. Appliance Zabbix

7. Configuration

1 Hôtes et groupes d’hôtes

1 Configuration d’un hôte

2 Inventaire

3 Mise à jour groupée

1 Création d'un élément

1 Format de clé d’élément

2 Custom intervals

2 Item value preprocessing

1 Usage examples

2 Preprocessing details

3 JSONPath functionality

Escaping special characters from LLD macro values in JSONPath

4 JavaScript preprocessing

Additional JavaScript objects

5 CSV to JSON preprocessing

2 Types d'éléments

1 Agent Zabbix

Clés d'éléments spécifique à Windows

Zabbix agent 2

2 Agent SNMP

1 Index dynamiques

2 OID spéciaux

3 MIB files

3 Traps SNMP

4 Vérifications IPMI

5 Vérifications simples

1 Clés d'élément de supervision VMware

6 Supervision des fichiers journaux

7 Eléments calculés

8 Internal checks

9 SSH checks

10 Telnet checks

11 External checks

12 Aggregate checks

13 Trapper items

14 JMX monitoring

15 ODBC monitoring

1 Recommended UnixODBC settings for MySQL

2 Recommended UnixODBC settings for PostgreSQL

3 Recommended UnixODBC settings for Oracle

4 Recommended UnixODBC settings for MSSQL

16 Dependent items

17 HTTP agent

18 Prometheus checks

3 History and trends

4 User parameters

1 Extending Zabbix agents

5 Loadable modules

6 Windows performance counters

7 Mass update

8 Value mapping

9 Applications

10 Queue

11 Value cache

12 Check now

14 Plugins

15 Restricting agent checks

3 Triggers

1 Configuring a trigger

2 Trigger expression

3 Trigger dependencies

4 Trigger severity

5 Customising trigger severities

7 Mass update

8 Predictive trigger functions

4 Events

1 Trigger event generation

2 Manual closing of problems

3 Other event sources

5 Event correlation

1 Trigger-based event correlation

Event tags

2 Global event correlation

6 Visualization

1 Graphs

1 Simple graphs

2 Custom graphs

3 Ad-hoc graphs

4 Aggregation in graphs

2 Network maps

1 Configuring a network map

2 Host group elements

3 Link indicators

3 Screens

1 Screen elements

4 Slide shows

5 Host screens

6 Dashboard

7 Templates

1 Configuring a template

2 Linking/unlinking

3 Nesting

4 Mass update

8 Templates out of the box

1 Standardized templates for network devices

HTTP template operation

IPMI template operation

JMX template operation

ODBC template operation

Zabbix agent 2 template operation

Zabbix agent template operation

9 Notifications upon events

1 Media types

1 E-mail

2 SMS

4 Webhook

Webhook script examples

5 Custom alertscripts

2 Actions

1 Conditions

2 Operations

1 Sending message

2 Remote commands

3 Additional operations

4 Using macros in messages

3 Recovery operations

4 Update operations

5 Escalations

3 Receiving notification on unsupported items

10 Macros

1 Macro functions

2 User macros

3 Low-level discovery macros

3 User macros with context

11 Users and user groups

1 Configuring a user

2 Permissions

3 User groups

8. Supervision de service

9. Web monitoring

1 Web monitoring items

2 Real life scenario

10. Virtual machine monitoring

1 Virtual machine discovery key fields

11. Maintenance

12. Regular expressions

13. Event acknowledgement

14. Configuration export/import

2 Templates

3 Hosts

5 Screens

1 Network discovery

1 Configuring a network discovery rule

2 Active agent auto-registration

3 Low-level discovery

1 Discovery of mounted filesystems

1 Discovery of network interfaces

2 Discovery of CPUs and CPU cores

3 Discovery of SNMP OIDs

4 Discovery of JMX objects

5 Discovery using ODBC SQL queries

6 Discovery of IPMI sensors

6 Discovery of Windows services

7 Discovery of host interfaces in Zabbix

7 Discovery of systemd services

9 Discovery of Windows performance counter instances

10 Discovery using WMI queries

12 Discovery using Prometheus data

13 Discovery of block devices

Notes on low-level discovery

16. Supervision distribuée

1 Proxys

17. Chiffrement

1 Par certificat

2 Par clés pré-partagées (PSK)

1 Problèmes de type de connexion ou d'autorisation

2 Problèmes de certificat

3 Problèmes PSK

18. Interface Web

1 Menu

1 Sections de l'interface

1 Surveillance

1 Dashboard

1 Dashboard widgets

2 Problems

3 Hosts

1 Graphs

2 Web scenarios

3 Overview

5 Latest data

7 Screens

8 Maps

9 Discovery

10 Services

2 Inventory

1 Overview

2 Hosts

3 Reports

1 System information

2 Availability report

3 Triggers top 100

4 Audit

5 Action log

6 Notifications

4 Configuration

1 Host groups

2 Templates

3 Hosts

1 Applications

2 Items

3 Triggers

4 Graphs

5 Discovery rules

6 Web scenarios

4 Maintenance

5 Actions

6 Event correlation

7 Discovery

8 IT services

5 Administration

1 General

2 Proxies

3 Authentication

4 User groups

5 Users

6 Media types

7 Scripts

8 Queue

1 Global notifications

2 Sound in browsers

3 Global search

4 Frontend maintenance mode

5 Page parameters

7 Creating your own theme

10 Cookies used by Zabbix

19. API

Référentiel des méthodes

Action

> Action object

action.create

action.delete

action.get

action.update

Alerte

> Objet Alerte

alert.get

API info

apiinfo.version

Application

> Objet Application

application.create

application.delete

application.get

application.massadd

application.update

Audit log

> Audit log object

auditlog.get

Autoregistration

> Autoregistration object

autoregistration.get

autoregistration.update

Configuration

configuration.export

configuration.import

Corrélation

> Objet Corrélation

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard

> Dashboard object

dashboard.create

dashboard.delete

dashboard.get

dashboard.update

Discovered host

> Discovered host object

dhost.get

Discovered service

> Discovered service object

dservice.get

Discovery check

> Discovery check object

dcheck.get

Discovery rule

> Discovery rule object

drule.create

drule.delete

drule.get

drule.update

Event

> Event object

event.acknowledge

event.get

Graph

> Graph object

graph.create

graph.delete

graph.get

graph.update

Graph item

> Graph item object

graphitem.get

Graph prototype

> Graph prototype object

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

History

> History object

history.get

Host

> Host object

host.create

host.delete

host.get

host.massadd

host.massremove

host.massupdate

host.update

Host group

> Host group object

hostgroup.create

hostgroup.delete

hostgroup.get

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.update

Host interface

> Host interface object

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Host prototype

> Host prototype object

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Icon map

> Icon map object

iconmap.create

iconmap.delete

iconmap.get

iconmap.update

Image

> Image object

image.create

image.delete

image.get

image.update

Item

> Item object

item.create

item.delete

item.get

item.update

Item prototype

> Item prototype object

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

LLD rule

> LLD rule object

discoveryrule.copy

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Maintenance

> Maintenance object

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Map

> Map object

map.create

map.delete

map.get

map.update

Media type

> Media type object

mediatype.create

mediatype.delete

mediatype.get

mediatype.update

Problem

> Problem object

problem.get

Proxy

> Proxy object

proxy.create

proxy.delete

proxy.get

proxy.update

Screen

> Screen object

screen.create

screen.delete

screen.get

screen.update

Screen item

> Screen item object

screenitem.create

screenitem.delete

screenitem.get

screenitem.update

screenitem.updatebyposition

Script

> Script object

script.create

script.delete

script.execute

script.get

script.getscriptsbyhosts

script.update

Service

> Service object

service.adddependencies

service.addtimes

service.create

service.delete

service.deletedependencies

service.deletetimes

service.get

service.getsla

service.update

Task

> Task object

task.create

task.get

Template

> Template object

template.create

template.delete

template.get

template.massadd

template.massremove

template.massupdate

template.update

Template screen

> Template screen object

templatescreen.copy

templatescreen.create

templatescreen.delete

templatescreen.get

templatescreen.update

Template screen item

> Template screen item object

templatescreenitem.get

Trend

> Trend object

trend.get

Trigger

> Trigger object

trigger.adddependencies

trigger.create

trigger.delete

trigger.deletedependencies

trigger.get

trigger.update

Trigger prototype

> Trigger prototype object

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

User

> User object

user.checkAuthentication

user.create

user.delete

user.get

user.login

user.logout

user.update

User group

> User group object

usergroup.create

usergroup.delete

usergroup.get

usergroup.update

User macro

> User macro object

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.get

usermacro.update

usermacro.updateglobal

Value map

> Value map object

valuemap.create

valuemap.delete

valuemap.get

valuemap.update

Web scenario

> Web scenario object

httptest.create

httptest.delete

httptest.get

httptest.update

Appendix 1. Commentaires de référence

Appendix 2. Changes from 4.4 to 5.0

Zabbix API changes in 5.0

Zabbix manpages

Table of Contents

Screen item

Screen item

This class is designed to work with screen items.

Object references:

Screen item

Available methods:

screenitem.create - creating new screen items
screenitem.delete - deleting screen items
screenitem.get - retrieving screen items
screenitem.update - updating screen items
screenitem.updatebyposition - updating screen items in a specific screen cell

To toggle search highlight, press Ctrl+Alt+H

Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.