1. Introduction

1 Manual structure

2 What is Zabbix

3 Zabbix features

4 Zabbix overview

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

48 What's new in Zabbix 5.0.44

49 What's new in Zabbix 5.0.45

50 What's new in Zabbix 5.0.46

51 What's new in Zabbix 5.0.47

3. Zabbix processes

2 Agent

4 Proxy

2 Setup from RHEL/CentOS packages

3 Setup from Debian/Ubuntu packages

Setup from sources

7 Get

8 JS

4. Installation

1 Getting Zabbix

Best practices for secure Zabbix setup

3 Installation from sources

Building Zabbix agent 2 on Windows

Building Zabbix agent on Windows

Building Zabbix agent on macOS

4 Installation from packages

1 Red Hat Enterprise Linux/CentOS

2 Debian/Ubuntu/Raspbian

3 SUSE Linux Enterprise Server

4 Windows agent installation from MSI

5 Mac OS agent installation from PKG

5 Installation from containers

Installation with OpenShift

7 Upgrade procedure

Upgrade from packages

1 Red Hat Enterprise Linux/CentOS

2 Debian/Ubuntu

Upgrade from sources

1 Compilation issues

9 Template changes

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

53 Upgrade notes for 5.0.43

54 Upgrade notes for 5.0.44

55 Upgrade notes for 5.0.45

56 Upgrade notes for 5.0.46

57 Upgrade notes for 5.0.47

6 Web interface installation

1 RHEL/CentOS 7 frontend installation

Updating to PHP 7.3 packages

2 Debian/Ubuntu frontend installation

1 Login and configuring user

5 Receiving problem notification

6. Zabbix appliance

7. Configuration

1 Hosts and host groups

1 Configuring a host

2 Items

1 Creating an item

1 Item key format

2 Custom intervals

2 Item value preprocessing

3 JSONPath functionality

Escaping special characters from LLD macro values in JSONPath

4 JavaScript preprocessing

Additional JavaScript objects

5 CSV to JSON preprocessing

1 Usage examples

2 Preprocessing details

preprocessing_details.md

Windows-specific item keys

1 Dynamic indexes

5 Simple checks

1 VMware monitoring item keys

6 Log file monitoring

7 Calculated items

8 Internal 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

18 Prometheus checks

4 History and trends

5 User parameters

1 Extending Zabbix agents

6 Loadable modules

7 Windows performance counters

9 Value mapping

10 Applications

15 Restricting agent checks

1 Configuring a trigger

2 Trigger expression

3 Trigger dependencies

4 Trigger severity

5 Customizing trigger severities

7 Predictive trigger functions

1 Trigger event generation

2 Other event sources

3 Manual closing of problems

5 Event correlation

1 Trigger-based event correlation

2 Global event correlation

6 Visualization

1 Simple graphs

2 Custom graphs

3 Ad-hoc graphs

4 Aggregation in graphs

1 Configuring a network map

2 Host group elements

3 Link indicators

1 Screen elements

1 Configuring a template

2 Linking/unlinking

8 Templates out of the box

HTTP template operation

IPMI template operation

JMX template operation

ODBC template operation

Standardized templates for network devices

Zabbix agent 2 template operation

Zabbix agent template operation

9 Notifications upon events

2 SMS

3 Custom alertscripts

Webhook script examples

1 Sending message

2 Remote commands

3 Additional operations

4 Using macros in messages

3 Recovery operations

4 Update operations

3 Receiving notification on unsupported items

1 Macro functions

3 User macros with context

4 Low-level discovery macros

11 Users and user groups

1 Configuring a user

8. Service monitoring

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. Problem acknowledgment

14. Configuration export/import

3 Hosts

1 Network discovery

1 Configuring a network discovery rule

2 Active agent autoregistration

3 Low-level discovery

1 Discovery of mounted filesystems

2 Discovery of network interfaces

3 Discovery of CPUs and CPU cores

4 Discovery of SNMP OIDs

5 Discovery of JMX objects

6 Discovery of IPMI sensors

7 Discovery of systemd services

8 Discovery of Windows services

9 Discovery of Windows performance counter instances

10 Discovery using WMI queries

11 Discovery using ODBC SQL queries

12 Discovery using Prometheus data

13 Discovery of block devices

14 Discovery of host interfaces in Zabbix

Notes on low-level discovery

16. Distributed monitoring

1 Using certificates

2 Using pre-shared keys

3 Troubleshooting

1 Connection type or permission problems

2 Certificate problems

18. Web interface

1 Menu

2 Frontend sections

1 Dashboard widgets

3 Hosts

2 Web scenarios

7 Maps

2 Hosts

1 System information

2 Availability report

3 Triggers top 100

4 Audit

6 Notifications

4 Configuration

3 Hosts

2 Items

5 Discovery rules

6 Web scenarios

6 Event correlation

5 Administration

3 Authentication

5 Users

8 Queue

1 Global notifications

2 Sound in browsers

4 Global search

5 Frontend maintenance mode

6 Page parameters

8 Creating your own theme

10 Cookies used by Zabbix

19. API

Appendix 1. Reference commentary

Appendix 2. Changes from 4.4 to 5.0

Method reference

apiinfo.version

Action

Alert

Application object

application.create

application.delete

application.get

application.massadd

application.update

Audit log object

Autoregistration

Autoregistration object

autoregistration.get

autoregistration.update

configuration.export

configuration.import

Correlation object

correlation.create

correlation.delete

correlation.get

correlation.update

Dashboard object

dashboard.create

dashboard.delete

dashboard.update

Discovered host

Discovered host object

Discovered service

Discovered service object

Discovery check

Discovery check object

Discovery rule object

Event

event.acknowledge

Graph

Graph item object

Graph prototype

Graph prototype object

graphprototype.create

graphprototype.delete

graphprototype.get

graphprototype.update

History

Host

host.massremove

host.massupdate

Host group object

hostgroup.create

hostgroup.delete

hostgroup.massadd

hostgroup.massremove

hostgroup.massupdate

hostgroup.update

Host interface object

hostinterface.create

hostinterface.delete

hostinterface.get

hostinterface.massadd

hostinterface.massremove

hostinterface.replacehostinterfaces

hostinterface.update

Host prototype object

hostprototype.create

hostprototype.delete

hostprototype.get

hostprototype.update

Icon map object

Image

Item

Item prototype object

itemprototype.create

itemprototype.delete

itemprototype.get

itemprototype.update

LLD rule object

discoveryrule.copy

discoveryrule.create

discoveryrule.delete

discoveryrule.get

discoveryrule.update

Maintenance object

maintenance.create

maintenance.delete

maintenance.get

maintenance.update

Map

map.get

Media type object

mediatype.create

mediatype.delete

mediatype.update

Problem

Proxy

Screen

Screen item object

screenitem.create

screenitem.delete

screenitem.update

screenitem.updatebyposition

Script

script.getscriptsbyhosts

Service

service.adddependencies

service.addtimes

service.deletedependencies

service.deletetimes

Task

Template object

template.create

template.delete

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

Trigger

trigger.adddependencies

trigger.deletedependencies

Trigger prototype

Trigger prototype object

triggerprototype.create

triggerprototype.delete

triggerprototype.get

triggerprototype.update

User

user.checkAuthentication

User group object

usergroup.create

usergroup.delete

usergroup.update

User macro object

usermacro.create

usermacro.createglobal

usermacro.delete

usermacro.deleteglobal

usermacro.update

usermacro.updateglobal

Value map object

valuemap.create

valuemap.delete

valuemap.update

Web scenario object

httptest.create

httptest.delete

httptest.update

Zabbix API changes in 5.0

1 Frequently asked questions / Troubleshooting

2 Installation and setup

3 Secure connection to the database

1 MySQL encryption configuration

2 PostgreSQL encryption configuration

4 TimescaleDB setup

5 Elasticsearch setup

6 Real-time export of events, item values, trends

7 Distribution-specific notes on setting up Nginx for Zabbix

8 Running agent as root

9 Zabbix agent on Microsoft Windows

10 SAML setup with Okta

11 Additional frontend languages

2 Repairing Zabbix database character set and collation

db_charset_coll.md

1 Database creation

3 Process configuration

1 Zabbix server

3 Zabbix agent (UNIX)

4 Zabbix agent 2 (UNIX)

5 Zabbix agent (Windows)

6 Zabbix agent 2 (Windows)

7 Zabbix Java gateway

1 Server-proxy data exchange protocol

2 Zabbix agent protocol

3 Zabbix agent 2 protocol

4 Zabbix agent 2 plugin protocol

5 Zabbix sender protocol

7 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 Minimum permission level for Windows agent items

6 Encoding of returned values

7 Large file support

9 Notes on memtype parameter in proc.mem items

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

11 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

1 Supported trigger functions

1 Supported macros

2 User macros supported by location

9 Time period syntax

10 Command execution

11 Version compatibility

12 Database error handling

13 Zabbix sender dynamic link library for Windows

14 Python library for Zabbix API

15 Issues with SELinux

16 Other issues

17 Agent vs agent 2 comparison

Zabbix manpages

Zabbix Manual
1. Introduction
45 What's new in Zabbix 5.0.41

On this page

45 What's new in Zabbix 5.0.41
- TimescaleDB 2.13 support
- MySQL 8.2 support

45 What's new in Zabbix 5.0.41

TimescaleDB 2.13 support

Support for TimescaleDB version 2.13 is now available.

MySQL 8.2 support

The maximum supported version for MySQL is now 8.2.X.

What’s next?

46 What's new in Zabbix 5.0.42