Home

16 Appendices

1. 5 5 er expressions host key HHH 2 mhhh 1o 11 1 Macros for map labels are supported since 1 8 User macros Supported in item trigger names 1 8 4 2 Since 2 0 3 macros supported in item keys will only work for types that have interfaces 9 they will not work for types Zabbix agent active Calculated etc 3 Depending on the context the macro will be expanded differently In 2 0 1 or earlier version in the context of remote command execution GUI scripts item key parameters and interface IP DNS fields only the main agent interface will be considered as the source of information Since 2 0 2 the macro will use the main agent interface however if it is not present main SNMP interface will be used If SNMP is also not present main JMX interface will be used If JMX is not present either main IPMI interface will be used In item key parameters the interface that is selected for the item will be used since 2 0 3 https www zabbix com documentation 2 0 manual appendix macros supported by location Page 8 of 10 1 Macros supported by location Zabbix 4 Only functions last avg max and min with seconds as arguments are supported in map labels 5 Supported since 2 0 3 Macro TRIGGER ID is supported in trigger URL since Zabbix 1 8 8 Additional support for user macros 12 5 13 2 12 PM In addition to the locat
2. on AIX and Solaris available and free are the same on Linux shared works only on kernel 2 4 See also 1 Detailed information about memory calculation in different OS http blog zabbix com when alexei isnt looking vm memory size 2 0 manual appendix items vm memory size params txt Last modified 2012 04 15 22 33 by zalex ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items vm memory size params Page 1 of 1 3 Passive and active agent checks Zabbix 12 5 13 2 10 PM 3 Passive and active agent checks Overview This section provides details on passive and active checks performed by Zabbix agent Zabbix uses aJSON based communication protocol for communicating with Zabbix agent There are some definitions used in the details of protocols used by Zabbix HEADER ZBXD x01 5 bytes lt DATALEN gt data length 8 bytes 1 will be formatted 01 00 00 00 00 00 00 00 eight bytes in HEX 64 bit number To not exhaust memory potentially Zabbix server is limited to accept only 128MB in one connection unlimited before Zabbix 2 0 3 when using the Zabbix protocol Passive checks A passive check is a simple data request Zabbix server or proxy asks for some data for example CPU load and Zabbix agent s
3. 0 not allowed 1 allowed Item used for setting Hostname if it is undefined Does not support UserParameters performance counters or aliases but does support system run regardless of EnableRemoteCommands value system hostname Ignored if Hostname is set This option is supported in version 1 8 6 and higher 2 error information Hostnameltem LogFileSize LogFile See also a more detailed description You may include individual file in the configuration file 0 0 0 0 Agent will listen on the specified interface 25207 10050 Agent will listen on this port for connections from the server 0 Maximum size of log file in MB 1024 0 disable automatic log rotation Name of log file Unique case sensitive hostname Required for active checks and must match hostname as by configured on the server Hostnameltem 9 Allowed characters alphanumeric and Maximum length 64 4 https www zabbix com documentation 2 0 manual appendix config zabbix agentd win Page 1 of 3 4 Zabbix agent Windows Zabbix 12 5 13 2 09 PM If not set Windows Event Log is used Enable logging of executed shell commands as warnings LogRemoteCommands 0 disabled 1 enabled Maximum number of new lines the agent will send per second to Zabbix server or proxy processing log logrt and active checks The provided value will be overridden by the paramet
4. Notes field in host inventory PROFILE NOTES lt 1 9 gt is deprecated OOB IP address field in host inventory OOB subnet mask field in host inventory Page 3 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM router field in host INVENTORY OOB ROUTER lt 1 9 gt inventory x OS field in host inventory PROFILE OS lt 1 9 gt is deprecated OS Full details field in host inventory OS Short field in host inventory Primary POC cell field in host inventory INVENTORY OS lt 1 9 gt x x Primary POC email field in host inventory Primary POC name field in host inventory Primary POC notes field in host inventory Primary POC phone A field in host inventory INVENTORY POC PRIMARY PHONE B lt 1 9 gt EIE E 20121 Primary POC phone field in host inventory INVENTORY POC PRIMARY SCREEN lt 1 9 gt Primary screen name field in host inventory host inventory host inventory EX saa a host inventory host inventory INVENTORY POC SECONDARY PHONE A lt 1 Secondary POC phone 9 gt field in host inventory INVENTORY POC SECONDARY PHONE B lt 1 Secondary POC phone field 9 gt in host inventory INVENTORY POC SECONDARY SCREEN lt 1 Secondary POC screen name 9 gt field in host inventory Serial number A field in host inventory INVENTORY SERIALNO A 1 9 X PROFILE SERIALNO lt 1 9 gt is deprecated iiid doceo a
5. expressions insofar as when referencing an item key prototype for graph prototypes in names Some low level discovery macros come pre packaged with the LLD funtion in Zabbix FSNAME FSTYPE IFNAME SNMPINDEX SNMPVALUE However adhering to these names is not compulsory when creating a custom low level discovery rule Then you may use any other LLD macro name and refer to that name 2 0 manual appendix macros supported_by_location txt Last modified 2013 10 03 12 33 by Pavels Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix macros supported by location Page 10 of 10 7 Setting time periods Zabbix 12 5 13 2 12 PM 7 Setting time periods 1 Format To set a time period the following format has to be used Maen eee eee ee ee ee ee ee eee Ee Re Re Re Re pe ms ee m in m m Ree Oe ee eee Pai pni de in m eee eee ee 2 Description Day of the week 1 Monday 2 Tuesday 7 Sunday Hours 00 24 mm Minutes 00 59 3 Default Empty time period specification equals 01 07 00 00 24 00 which is the default value The upper limit of a time period is not included Thus if you specify 09 00 18 00 the last se
6. 1 30 UnavailableDelay 1 3600 UnreachableDelay https www zabbix com documentation 2 0 manual appendix config zabbix server tmp 00 M 5 5 UnreachablePeriod 12 5 13 2 09 PM This option is supported in version 2 0 0 and higher Number of pre forked instances of ICMP pingers The upper limit used to be 255 before version 1 8 5 Number of pre forked instances of pollers for unreachable hosts including IPMI The upper limit used to be 255 before version 1 8 5 This option is missing in version 1 8 3 Number of pre forked pollers The upper limit used to be 255 before version 1 8 5 instances of Number of pre forked instances of pollers for passive proxies The upper limit used to be 255 before version 1 8 5 This option is supported in version 1 8 3 and higher If set to 1 SNMP trapper process will be started This option is supported in version 2 0 0 and higher Number of pre forked trappers Trappers accept incoming connections from Zabbix sender active agents active proxies and child nodes At least one trapper process must be running to display server availability in the frontend The upper limit used to be 255 before version 1 8 5 instances of Specifies how long we wait for agent SNMP device or external check in seconds Temporary directory Specifies how many seconds trapper may spend processing new data Size of trend cache in bytes Shared memor
7. wired memory that is marked to always stay RAM It is never moved to disk pinned same as wired anon memory not associated with a file cannot be re read from it exec executable code typically from a program file file cache for contents of recently accessed files buffers cache for things like file system metadata cached cache for various things Shared memory that may be simultaneously accessed by multiple processes used active wired memory pused active wired memory in relation to total available inactive cached free memory pavailable inactive cached free memory in relation to total The sum of vm memory size used and vm memory size available does not necessarily equal total For instance on FreeBSD active inactive wired cached memories are considered used because they store some useful information At the same time inactive cached free memories are considered available because these kinds of memories can be given instantly to processes that request more memory So inactive memory is both used and available simultaneously Because of this item vm memory size used is designed for informational purposes only while item vm memory size available is designed to be used in triggers See the See also section at the bottom of this page to find more detailed information about memory calculation in different OS Platform specific notes
8. lt 1 9 gt ei Mike INVENTORY MACADDRESS B lt 1 9 gt INVENTORY MACADDRESS B lt 1 9 gt lt 1 9 gt INVENTORY NAME lt 1 9 gt INVENTORY MACADDRESS A lt 1 9 gt INVENTORY NOTES lt 1 9 gt INVENTORY OOB NETMASK lt 1 9 gt https www zabbix com documentation 2 0 manual appendix macros supported by location Contract number field in host inventory Deployment status field in host inventory Hardware field in host inventory PROFILE HARDWARE lt 1 9 gt is deprecated Hardware Full details field in host inventory Host subnet mask field in host inventory Host networks field in host inventory Host router field in host inventory Hardware architecture field in host inventory hardware field in Date decommissioned host inventory Date hardware maintenance expires field in X host inventory Date hardware installed field in host inventory Date hardware purchased field in host inventory E name field in host pu Location field host inventory PROFILE LOCATION lt 1 9 gt 15 deprecated latitude field B inventory Location longitude field in a inventory x address A field in host inventory PROFILE MACADDRESS lt 1 9 gt is deprecated m address B field in host inventory field in host Name field in host inventory 1 9 15 deprecated
9. 0 and higher List of comma delimited IP addresses that the trapper should listen on ListenIP Trapper will listen on all network interfaces if this parameter is missing Multiple IP addresses are supported in version 1 8 3 and higher https www zabbix com documentation 2 0 manual appendix config zabbix proxy Page 2 of 4 JavaGatewayPort 2 Zabbix proxy Zabbix 12 5 13 2 09 PM 1024 32767 0 1024 10051 Listen port for trapper Maximum size of log file in MB LogFileSize 0 disable automatic log rotation Name of log file LogFile EE If not set syslog is used 0 How long a database query may take before being logged in milliseconds 0 don t log slow queries This option becomes enabled starting 3099090 with DebugLevel 3 Supported since Zabbix 1 8 2 tmp zabbix_ proxy pid Name Name of PID file PID file ListenPort LogSlowQueries Proxy will keep data locally for N hours even if the data have already been synced with the server This parameter may be used if local data will be used by third party applications Proxy operating mode 0 proxy in the active mode 1 proxy in the passive mode This option is supported in version 1 8 3 and higher ProxyLocalBuffer 0 720 ProxyMode Proxy will keep data for N hours in case if no connectivity with Zabbix server Older data will be lost Port of Zabbix trapper on Zabbix 1024 server 32767 10051 proxy in th
10. 2 011 E 71 1 7 EZECH E systemhwchassisicinfoo 85081 11111 systemhwcpul lt epu gt lt infos systemhwmacaddri lt imertaces mac V kki EEE i ee x p 992205 toa x p fystemrunteommand lt modes k a ee p keketek 0 EE systemswpackagesl lt package gt lt manager gt lt tormasy x x l E See EEE supported under Linux ype a erar underaexcepr tno e E pages wil isas X Ix device was not default undering Xx supported under Linux ype a erar underaexcepr un X e E pages wil oniywork device was not specie hages default undertinuy x x x eo eri eet den be be be supported under Linux free default Jx ee geaj aao Xx pfree eee x Jx ix jsystemuname Jx x x jx x x x jx Iystemuptime x x x p x x yx ames P e https www zabbix com documentation 2 0 manual appendix items supported by platform Page 3 of 5 xj m 1
11. 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix agentd Page 3 of 3 4 Zabbix agent Windows Zabbix 12 5 13 2 09 PM 4 Zabbix agent Windows The parameters supported in a Zabbix agent Windows configuration file Sets an alias for an item key The alias can be used instead of the full item key in item configuration For example to retrieve paging file usage percentage from the server you may use the following item key perf_counter Paging File _Total Usage However you may also define an alias by adding the following Alias no line to configuration file Alias pg_usage perf_counter Paging File _Total Usage and then use pg usage instead of the full item key in item configuration An alias can be especially useful to substitute a long and complex item key with a smaller and simpler one Multiple aliases can be defined Aliases cannot be reused in PerfCounter parameters BufferSend Do not keep data longer than seconds in buffer 2 Maximum number of values in a memory buffer The agent will BufferSize 65535 100 send all collected data to Zabbix server or proxy if the buffer is full Specifies debug level DebugLevel 0 no debug EnableRemoteCommands 1 critical information iid no 3 warnings 4 for debugging produces lots of information Whether remote commands from Zabbix server are allowed
12. How to solve this A Use a double dollar sign like 1 7 dropdowns have a scrollbar and look ugly in Opera 11 Why so It s a known bug in Opera 11 00 and 11 01 see Zabbix issue tracker https support zabbix com browse ZBX 3594 for more information 8 Q What is the structure of IDs in the database for distributed monitoring A NNNSSSDDDDDDDDDDD where NNN nodeid to which node the ID belongs to SSS source nodeid in which node was the ID created DDDDDDDDDDD the ID itself For instance ID created on source node 5 for node 14 might look like 1400500000012345 Note that in this example the length of ID is less than 17 digits because the target node number has less than three digits 9 Q How can I change graph background colour in a custom theme A See graphs colours table in the database and theming guide https www zabbix com documentation 2 0 manual appendix faq Page 1 of 2 1 Frequently asked questions Troubleshooting Zabbix 12 5 13 2 08 PM 2 0 manual appendix faq txt Last modified 2012 04 21 18 23 by zalex ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix faq Page 2 of 2 2 Installation Zabbix 12 5 13 2 08 PM 2 Installation 2 0 manual appendix install txt Last modified
13. device Available always does not depend on host being added DNS name of the discovered device Available always DISCOVERY DEVICE DNS does not depend on host being added Status of the discovered DISCOVERY DEVICE STATUS device can be either UP or DOWN Time since the last change of discovery status for a particular device DISCOVERY DEVICE UPTIME For example 1h 29m For devices with status DOWN this is the period of their downtime Name of the discovery rule that discovered the presence or absence of the device or DISCOVERY RULE NAME service Name of the service that was DISCOVERY SERVICE NAME discovered For example HTTP https www zabbix com documentation 2 0 manual appendix macros supported by location Page 1 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM Port of the service that was DISCOVERY SERVICE PORT discovered For example 80 Status of the discovered DISCOVERY SERVICE STATUS service can be either UP or DOWN Time since the last change of discovery status for a particular service DISCOVERY SERVICE UPTIME For example 1h 29m For services with status DOWN this is the period of their downtime Escalation history Log of previously sent messages Shows previously sent ESC HISTORY notifications on which escalation step they were sent and their status sent ES progress or failed ACK HISTORY EVENT ACK HEVENTACKSTATU EVENT
14. following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix triggers functions Page 4 of 4 6 Macros Zabbix 12 5 13 2 11 PM 6 Macros 2 0 manual appendix macros txt Last modified 2012 04 15 21 35 by zalex_ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix macros Page 1 of 1 1 Macros supported by location Zabbix 12 5 13 2 12 PM 1 Macros supported by location Overview The table contains a complete list of macros supported by Zabbix X means supported in that location Macros with numbers 1 9 like 1 2 9 allow to reference hosts in the order in which they appear in a trigger expression So HOST IP1 and HOST IP2 will expand to the IPs of the first and second host in the trigger expression DB monitor additional ee SSH and Telnet scripts Interface y re names expressions 2 URLs A labels DESCRIPTION Item eie s parameters GUI SE Auto a asec f notifications sree een notifications Notifications and commands and commands re format IP address of the discovered DISCOVERY DEVICE IPADDRESS
15. host name as the hostname 2 0 manual appendix install windows agent txt Last modified 2013 04 25 11 41 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix install windows agent Page 2 of 2 3 Daemon configuration Zabbix 12 5 13 2 08 PM 3 Daemon configuration 2 0 manual appendix config txt Last modified 2012 02 20 15 13 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config Page 1 of 1 1 Zabbix server Zabbix 12 5 13 2 09 PM 1 Zabbix server The parameters supported in a Zabbix server configuration file Location of custom alert scripts AlertScriptsPath no usr local share zabbix alertscripts depends on compile time installation variable datadir Size of configuration cache in bytes 128 Shared memory size for storing host CacheSize no 2 item and trigger data The upper limit used to be 1G before version 2 0 5 CacheUpdateFrequency no 1 3600 How often Zabbix will perform update of configuration cache in seconds Database host name In case of MySQL localhost or empty stri
16. martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix Page 1 of 1 6 Archive Zabbix agent UNIX Inetd version Zabbix 12 5 13 2 09 PM 6 Archive Zabbix agent UNIX Inetd version The parameters supported in a Zabbix agent UNIX Inetd version configuration file Sets an alias for an item key The alias can be used instead of the full item key in item configuration For example Ali Alias system cpu load percpu 5 system cpu load percpu avg5 ias no Item key system cpu load percpu 5 Item name Processor load 2 min average per core An alias can be especially useful to substitute a long and complex item key with a smaller and simpler one Multiple aliases can be defined include You may include individual files or all files in a directory in the configuration file Comma delimited list of IP addresses of Zabbix servers or proxies Connections Server yes from other IP addresses will be rejected Do not spend more than Timeout seconds on getting requested value 1 255 The Timeout no 3 agent does not kill timeouted user parameter processes UnsafeUserParameters ___ Allow all characters to be passed in arguments to user defined parameters User defined p
17. records 2 0 manual appendix config zabbix_agentd_win txt Last modified 2013 09 24 09 34 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix agentd win Page 3 of 3 5 Zabbix Java gateway Zabbix 12 5 13 2 09 PM 5 Zabbix Java gateway If you use Startup sh and shutdown sh scripts for starting Zabbix Java gateway then you can specify the necessary configuration parameters in file settings sh The startup and shutdown scripts source the settings file and take care of converting shell variables listed in the first column to Java properties listed in the second column If you start Zabbix Java gateway manually by running java directly then you specify the corresponding Java properties on the command line LISTEN_IP zabbix listeniP no 0000 IP address to listen on es SAND of PID file If omitted Zabbix Java EMEN tmp zabbix_java pid Gateway is started as a console application START_POLLERS zabbix startPollers 1 1000 Number of worker threads to start Port 10052 is not IANA registered http www iana org assignments service names port numbers service names port numbers txt 2 0 manual appendix config zabbix java txt Last modified 2012 04 16 16 12 by
18. 2012 02 08 16 34 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix install Page 1 of 1 1 Database creation scripts Zabbix 12 5 13 2 08 PM 1 Database creation scripts Overview A Zabbix database must be created during the installation of Zabbix server or proxy This section provides scripts for creating a Zabbix database A separate schema script is provided for each supported database The order of database file import has been changed images must be imported before data sgl now For Zabbix proxy database only 5 should be imported images sgl nor data sql schema sql images sql and data sql files can be found in the Zabbix source distribution subdirectory database If Zabbix was installed from distribution packages refer to the distribution documentation Scripts MySQL we assume that user username with password password exists and has permissions to create database objects shell mysql u lt username gt p lt password gt mysql gt create database zabbix character set utf8 collate utf8 bin mysql gt quit Shell mysql u lt username gt p lt password gt zabbix lt database mysql schema sql i 1 stop here if you are creating database for Zabbix proxy i 1 shell gt mysql
19. 5 seconds UnreachablePeriod should be several times bigger than UnreachableDelay so that items are rechecked more than once before a host becomes unavailable Unavailable host After the UnreachablePeriod ends and the host has not reappeared the host is treated as unavailable In the server log it is indicated by messages like these and in the frontend the host availability icon goes from green to red note that on mouseover a tooltip with the error description is displayed 48 10050 Template OS Linux Template App Zabbix Agent Monitored a Received empty response from Zabbix Agent at 192 168 3 132 Assuming that agent dropped connection because of Ss permissio The UnavailableDelay parameter defines how often items are checked during host unavailability By default it is 60 seconds so in this case temporarily disabling from the log message above will mean disabling checks for one minute When the connection to the host is restored the monitoring returns to normal automatically 2 0 manual appendix items unreachability txt Last modified 2013 09 23 10 55 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items unreachability Page lof 1 5 Triggers Zabbix 12 5 13 2 11 PM 5 Trigger
20. AGE of the event Useful in messages HEVENTDATE ____________ DATE Date of the event Numeric event 10 which TIME Time of the event or host DNS HOST CONN lt 1 9 gt aie on host settings Supported in trigger names since 2 0 0 HOST DNS lt 1 9 gt X DNS name Supported ps trigger names since 2 0 0 Host name HOST HOST lt 1 9 gt HOSTNAME lt 1 9 gt is tar _____________ 10 Host ID Host IP address Supported HOST IP lt 1 since 2 0 0 IPADDRESS lt 1 9 gt is deprecated EIE host name 2 HHH since 2 0 0 Host agent port HOST PORT HHOSTGROURJID 10 group ID ups HINVENTORYALIAS 1 9 ALIAS 1 9 Alias field in host inventory inventory inventory Contact field in host X inventory PROFILE CONTACT lt 1 9 gt is deprecated INVENTORY CONTACT lt 1 9 gt https www zabbix com documentation 2 0 manual appendix macros supported by location Page 2 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM INVENTORY CONTRACT NUMBER lt 1 9 gt X INVENTORY DEPLOYMENT STATUS 1 9 INVENTORY HARDWARE 1 9 gt n E RETE EDITA GM 21 71 __ INVENTORY HW DATE DECOMM lt 1 9 gt INVENTORY HW DATE EXPIRY lt 1 9 gt INVENTORY INSTALLER NAME lt 1 9 gt Wa ee ea INVENTORY LOCATION LAT
21. DU _ E E E EON Ed buffers ix x ee pE 0 2 3 0 2 5 ei gs ee moate fe x x __ _ X mE rl 12 51 ed Jx ix x __ x jx x yx jx available __ Jx jx x available ix jx jx jwebpageget host lt path gt lt port gt __ jx x webpageperflhostepath port x x x jx webpageregexplhost path port regexp length x x x 11281451678 See also a description of vm memory size parameters pa x lt x lt m 2 0 manual appendix items supported platform txt Last modified 2013 04 12 15 36 by dimir Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items supported by platform Page 5 of 5 2 vm memory size parameters Zabbix 12 5 13 2 10 PM 2 vm memory size parameters total total physical memory available memory that is readily available to any entity requesting memory active memory currently in use or very recently used and so it is in RAM inactive memory that is marked as not used
22. Items supported by platform Zabbix 12 5 13 2 10 PM 1 a ee RF fects 6 ES E operations eT Redes 225 se Teil oreen EE las EE type lt gt gt 1 V P vea erem E B E C EI 5 Eccc 7 Ene ae malesu EE compatible EE pe im sps ops Saves x Msmensenud 0 Jj p x p semitis vis leregexplfleregexpcencodingsy p utem gems E x x xx aces x x x x jx x jx x __ x x x x jx x Mefsdisvery __ Jx Jx Jx jx jx E p p P default __ x x x free de x x jx x x x x modea ued Kx X x x x jx free __ Xx x x xx used ef x jx x hk eee a https www zabbix com documentation 2 0 manual appendix items supported by platform Page 4 of 5 1 Items supported by platform Zabbix 12 5 13 2 10 PM Bun __ eee ee vm memory size lt mode gt x x Bde x e
23. SE NATIONAL CHARACTER SET UTF8 IBM DB2 shell gt db2 create database zabbix using codeset utf 8 territory us pagesize 32768 shell gt cd database ibm_db2 shell gt db2batch d zabbix schema sql stop here if you are creating database for Zabbix proxy shell gt db2batch d zabbix images sql shell gt db2batch d zabbix f data sql https www zabbix com documentation 2 0 manual appendix install db scripts Page 1 of 2 1 Database creation scripts Zabbix 12 5 13 2 08 PM shell gt cd database sqlite3 shell gt sqlite3 var lib sqlite zabbix db lt schema sql stop here if you are creating database for Zabbix proxy shell gt sqlite3 var lib sqlite zabbix db lt images sql Shell sqlite3 var lib sqlite zabbix db lt data sql If using SQLite with Zabbix proxy database will be automatically created if it does not exist Return to installation section 2 0 manual appendix install db_scripts txt Last modified 2013 06 04 10 03 by jaba Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix install db scripts Page 2 of 2 2 Zabbix Windows agent installation Zabbix 12 5 13 2 08 PM 2 Zabbix Windows agent installation Installation Installation is very simple and includes 3 steps Step 1 Create
24. Zabbix Manual Zabbix 11 21 13 4 25 PM Zabbix Manual Welcome to the user manual for Zabbix 2 0 software These pages are created to help our users successfully manage their monitoring tasks with Zabbix from the simple to the more complex 2 0 manual txt Last modified 2012 05 23 11 27 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual Page 1 of 1 16 Appendixes Zabbix 12 5 13 2 13 PM 16 Appendixes 2 0 manual appendix txt Last modified 2011 12 27 17 57 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix Page 1 of 1 1 Frequently asked questions Troubleshooting Zabbix 12 5 13 2 08 PM 1 Frequently asked questions Troubleshooting Frequently asked questions or FAQ 1 Can flush clear the queue as depicted in Administration Queue A No 2 Q How do i migrate from one database to another A Dump data only for mysql use flag t or no create info create the new database using schema files from Zabbix and import the data 3 Q would like to replace all spaces with underscores
25. a R3 ignored https www zabbix com documentation 2 0 manual appendix triggers functions Page 1 of 4 1 Supported trigger functions Zabbix 12 5 13 2 11 PM Returns day of month in range of 1 to 31 This function is supported since Zabbix 1 8 5 Returns day of week in range of 1 to 7 Mon 1 Sun 7 Returns the difference between the maximum and minimum values in a period max minus min The period is set in seconds or as a number of collected values preceded by a hash mark in the first parameter Since Zabbix 1 8 2 the function supports a second optional parameter time shift See function avg for an example of its use Returns 1 last and previous values differ 0 otherwise Returns 1 if timestamp item value does not differ from Zabbix server time for more than seconds 0 otherwise Usually used with system localtime to check that local time is in sync with local time of Zabbix server 1st string 2nd sec or str log text This function is non case sensitive analogue of regexp Last most recent value Parameter sec ignored Nth most recent value Take note that num as can be expected works differently here than with many other functions For example last 0 is always equal to last 1 last 3 third most recent value not three latest values The function also supports a second optional time shift paramete
26. a configuration file Create a configuration file c zabbix_agentd conf it has a similar syntax to the UNIX agent configuration file An example configuration file is available in Zabbix source archive as conf zabbix agentd win conf Step 2 Install agent as a Windows service On a 64 bit system a 64 bit Zabbix agent version is required for all checks related to running 64 bit processes to work correctly If you wish to use a configuration file other than c zabbix_agentd conf you should use the following command for service installation eee eee EAE EE ED AWELEeEeEMCIAALSELIENELAUCELILLELALELIUERLALELOILNRLEAEUELIUSELA LE S A full path to the configuration file should be specified Step 3 Run agent Now you can use Control Panel to start the agent service or run Configuration Hostname parameter To perform active checks on a host Zabbix agent needs to have the hostname defined Moreover the hostname value set on the agent side should exactly match the Host name configured for the host in the frontend The hostname value on the agent side can be defined by either the Hostname or Hostnameltem parameter in the agent configuration file or the default values are used if any of these parameters are not specified The default value for Hostnameltem parameter is the value returned by the system hostname agent key and for Windows platform it returns the NetBIOS host name https www zabbix com docu
27. arameter to monitor There can be several user defined parameters serParameter Format UserParameter key shell command Note that shell command must not return empty string or EOL only Example UserParameter system test who wc I 2 0 manual appendix config zabbix agent txt Last modified 2013 09 23 11 04 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix agent Page 1 of 1 4 Items Zabbix 12 5 13 2 10 PM 4 Items 2 0 manual appendix items txt Last modified 2012 02 20 15 14 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items Page 1 of 1 1 Items supported by platform Zabbix 12 5 13 2 10 PM 1 Items supported by platform The table displays support for Zabbix agent items on various platforms Items marked with X are supported the ones marked with not supported If an item is marked with it is not known whether it is supported or not If an item is marked with it means that it requires root privileges f a parameter is mark
28. arameters Source IP address for outgoing connections Number of pre forked instances of zabbix agentd that process passive checks 0 100 3 If set to 0 disables passive checks and the agent will not listen on any TCP port The upper limit used to be 16 before version 1 8 5 Spend no more than Timeout seconds on processing Allow all characters to be passed in arguments to user defined parameters Supported since Zabbix 1 8 2 User defined parameter to monitor There can be several user defined parameters Format UserParameter key shell command Note that shell command must not return empty string or EOL only Example UserParameter system test who wc l UserParameter In Zabbix agent 2 0 0 version configuration parameters related to active and passive checks have been changed See the See also section at the bottom of this page to read more details about these changes See also 1 Differences in the Zabbix agent configuration for active and passive checks starting from version 2 0 0 http blog zabbix com multiple servers for active agent sure 858 2 0 manual appendix config zabbix agentd txt Last modified 2013 09 23 09 50 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution https www zabbix com documentation 2 0 manual appendix config zabbix agentd Page 2 of 3 3 Zabbix agent UNIX Zabbix 12 5 13 2 09 PM Noncommercial Share Alike
29. artbeat messages disabled For a proxy in the passive mode this parameter will be ignored Size of history cache in bytes Shared memory size for storing history HistoryCacheSize data The upper limit used to be 1G before version 2 0 5 Size of text history cache in bytes Shared memory size for storing HistoryTextCacheSize character text or log history data The upper limit used to be 1G before version 2 0 5 Unique case sensitive Proxy name Make sure the proxy name is known to Hostname Set by Hostnameltem the server ERES Allowed characters alphanumeric Maximum length 64 Item used for setting Hostname if it is undefined this will be run on the proxy similarly as on an agent Does not support UserParameters performance counters or aliases but Hostnameltem system hostname does support system run Ignored if Hostname is set This option is supported in version 1 8 6 and higher How often Zabbix will perform housekeeping procedure in hours HousekeepingFrequency Housekeeping is removing unnecessary information from history alert and alarms tables You may include individual files or all Include files in a directory in the configuration file IP address or hostname of Zabbix Java gateway JavaGateway if Java pollers are This option is supported in version 2 0 0 and higher Port that Zabbix Java gateway listens on This option is supported in version 2 0
30. avg for an example of its use PT The minimum lowest value of a period The period is set in seconds or as a number of collected values preceded by a hash mark in the first parameter Since Zabbix 1 8 2 the function supports a second optional parameter time_shift See function avg for an example of its use nodata Returns 1 if no data received during period of time in seconds The period should not be less than 30 seconds 0 otherwise ee now ignored Returns number of seconds since the Epoch 00 00 00 UTC January 1 1970 ee Returns previous value Parameter is ignored Same as last 2 eoe UMS Ist string 2nd sec or str log text Check if last most recent value matches regular expression Parameter defines regular expression POSIX extended http en wikipedia org wiki Regular expression POSIX Extended Regular Expressions style Second optional parameter is number of seconds or number of collected values to analyse In this case more than one value will be processed This function is case sensitive Returns 1 found 0 otherwise 1st string 2nd sec or str log text Find string in last most recent value Parameter defines string to find Case sensitive Second optional parameter is number of seconds or number of collected values to analyse In this case more than one value will be processed Returns 1 found 0 otherwise Length of the las
31. cond included in the time period is 17 59 59 This is true starting from version 1 8 7 for everything while Working time has always worked this way 4 Examples Working hours Monday Friday from 9 00 till 18 00 SET IE SEE ESAE Ga TA Ga La G a Gd ks ck ERI 024303 A od GAGS Le 23630843 Ga 53502 25383 2453 535305 52055322 53 52 530213 538823 5853 53024223 68134353 Rages 5253 582853 1388 535354 58052 2888 288303 52 end 2 0 manual appendix time_period txt Last modified 2012 09 02 21 53 by dotneft Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix time period Page lof 1 8 Command execution Zabbix 12 5 13 2 12 PM 8 Command execution Zabbix uses common functionality to execute user parameters remote commands system run items without nowait flag scripts alert external and global and some internal commands The command script is executed similarly on both UNIX and Windows platforms Zabbix the parent process creates a pipe for communication Zabbix sets the pipe as the output for the to be created child process Zabbix creates the child process runs the command script A new process group in UNIX or a job in Windows is created for the child process Zabbix reads from the pipe till tim
32. dd BE qq d qd c dg en ae 2 inventory inventory inventory inventory inventory inventory Site notes field in host INVENTORY SITF NOTFS 1 9 https www zabbix com documentation 2 0 manual appendix macros supported by location Page 4 of 10 1 Macros supported by location Zabbix INVENTORY SITE RACK lt 1 9 gt INVENTORY SITE STATE lt 1 9 gt Fg INVENTORY SITE ZIP 1 9 belle INVENTORY SOFTWARE lt 1 9 gt 11 INVENTORY SOFTWARE FULL lt 1 9 gt INVENTORY TAG lt 1 9 gt INVENTORY TYPE lt 1 9 gt 081111 111111 20000 81121 perwa PI Lae LL 1213 415617 8 9 19 r ITEM DESCRIPTION lt 1 9 gt INVENTORY VENDOR lt 1 9 gt ITEM KEY lt 1 9 gt ITEM KEY ORIG lt 1 9 gt https www zabbix com documentation 2 0 manual appendix macros supported by location 12 5 13 2 12 PM inventory Site rack location field in host inventory Site state province field in host inventory Site ZIP postal field in host inventory Software field in host inventory PROFILE SOFTWARE 1 9 gt is deprecated Software application A field in host inventory Software application B field in host inventory Software application C field in host inventory Software application D field in host inventory Software application E field in host inventory Software Full details field in hos
33. dged PROBLEM events for all triggers disregarding their state Supported since 1 8 3 TRIGGER EVENTS PROBLEM ACK Number of unacknowledged PROBLEM events for all triggers disregarding their state Supported since 1 8 3 TRIGGER EVENTS PROBLEM UNACK Number of unacknowledged events for a map element in maps or for the trigger TRIGGER EVENTS UNACK which generated current event in notifications Supported in map element labels since 1 8 3 Number of acknowledged PROBLEM events for triggers in PROBLEM state Supported since 1 8 3 Number of unacknowledged PROBLEM events for triggers TRIGGER PROBLEM EVENTS PROBLEM UNACK in PROBLEM state Supported 1 8 3 expression Sorted by SQL query comma space separated list TRIGGER HOSTGROUP NAME of host groups in which the trigger is defined Supported since 2 0 6 ET trigger ID which HTRIGGERNAME WE Name of the trigger Original name with macros not expanded of the trigger Supported since 2 0 6 Numerical trigger severity Possible values 0 Not classified 1 Information 2 TRIGGER NSEVERITY Warning 3 Average 4 High 5 Disaster Supported starting from Zabbix 1 6 2 Trigger severity name Can be defined in Administration gt General gt Trigger severities Trigger state Can be either TRIGGER STATUS PROBLEM STATUS is deprecated Sorted by SQL query comma space separated list of templates in wh
34. e ones performed by network discovery and active agent auto registration All changes by the server are logged as being performed by the guest user Audit log entries are kept forever processes like housekeeper do not remove entries from it Internal audit log can be viewed at Administration gt Audit 2 0 manual appendix audit txt Last modified 2012 04 15 21 31 by zalex_ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix audit Page 1 of 1
35. e passive mode this parameter will be ignored IP address or hostname of Zabbix server Active proxy will get configuration data from the server For a proxy in the passive mode this parameter will be ignored Temporary file used for passing data from SNMP trap daemon to the proxy Must be the same as in tmp zabbix_traps tmp zabbix_trap_receiver p or SNMPTT configuration file ServerPort Server SNMPTrapperFile This option is supported in version 2 0 0 and higher Source IP address for outgoing connections SSHKeyLocation StartDBSyncers Location of public and private keys for SSH checks and actions Number of pre forked instances of DB Syncers 1 100 The upper limit used to be 64 before version 1 8 5 This option is supported in version 1 8 3 and higher Number of pre forked instances of discoverers ProxyOfflineBuffer 1 720 StartDiscoverers no 0 250 1 https www zabbix com documentation 2 0 manual appendix config zabbix proxy Page 3 of 4 2 Zabbix proxy Zabbix 12 5 13 2 09 PM The upper limit used to be 255 before version 1 8 5 Number of pre forked instances of HTTP pollers Number of pre forked instances of IPMI pollers The upper limit used to be 255 before version 1 8 5 StartHTTPPollers 0 1000 E ks StartIPMIPollers 0 1000 Number of pre forked instances of Java pollers This option is supported in version 2 0 0 and hig
36. ed with i it means that it is ignored Parameters that are included in angle brackets like this are optional Windows only Zabbix agent items are not included in this table e SHY NNN HPUX Linux 2 26 Linux 2 4 Windows 1 gt 4 5 7 8 9 r i 111 EE UU x x x x x px kernelmaxfies x jx p hk Kemekmaxproc logffile lt regexp gt lt encoding gt lt maxlines gt lt mode gt x x x logrtfile format lt regexp gt lt encoding gt lt maxlines gt lt mode gt X Inet dnsi lt ip gt izone lt type gt lt timeout gt lt count gt x x inet dns recordl lt ip gt zone lt type gt lt timeout gt lt count gt x x x x x metifcolisionsif __ _ _ Jx Jx X netifdiscovery X X x metifinitemodesl ef x x mode a facets X X x X x x eos __ x xp aoea _ x X JX p x x x fe xj X https www zabbix com documentation 2 0 manual appendix items supported by platform Page 1 of 5 net if out if lt mode gt 1 Items supported by platform Zabbix 12 5 13 2 10 PM packets eee Med ee metiftotalitsm
37. ends back the result to the server Server request For example Server opens a TCP connection Server sends agent ping n Agent reads the request and responds with HEADER DATALEN 1 Server processes data to get the value 1 in our case TCP connection is closed Active checks Active checks require more complex processing The agent must first retrieve from the server s a list of items for independent processing The servers to get the active checks from are listed in the ServerActive parameter of the agent configuration file The frequency of asking for these checks is set by the RefreshActiveChecks parameter in the same configuration file However if refreshing active checks fails it is retried after hardcoded 60 seconds The agent then periodically sends the new values to the server s Getting the list of items Agent request lt HEADER gt lt DATALEN gt request active checks i host gt https www zabbix com documentation 2 0 manual appendix items activepassive Page 1 of 3 3 Passive and active agent checks Zabbix 12 5 13 2 10 PM response success data key log home zabbix logs zabbix_agentd log delay 30 lastlogsize 0 key agent version delay 600 The server must respond with success For each returned item key and delay must exist For items having type Log the lastlogsize must exist as
38. eout occurs or no one is writing to the other end ALL handles file descriptors have been closed Note that the child process can create more processes and exit before they exit or close the handle file descriptor 6 If the timeout has not been reached Zabbix waits till the initial child process exits or timeout occurs 7 At this point it is assumed that everything is done and the whole process tree i e the process group or the job is terminated uU n n H Please note that Zabbix assumes that a command script has done processing when the initial child process has exited AND no other process is still keeping the output handle file descriptor open When processing is done ALL created processes are terminated Read more about user parameters remote commands alert scripts All double quotes and backslashes in the command are escaped with backslashes and the command is enclosed in double quotes 2 0 manual appendix command execution txt Last modified 2013 05 07 13 29 by richlv Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix command execution Page 1 of 1 9 Recipes for monitoring Zabbix 12 5 13 2 12 PM 9 Recipes for monitoring General Monitoring server availability At least three methods or combination of all meth
39. er maxlines provided in log logrt or eventlog item keys MaxLinesPerSecond Syntax parameter name perf counter path period Defines new parameter parameter name which is an average value for system performance counter perf counter path for the specified time period period in seconds For example if you wish to receive average number of processor interrupts per second for last minute you can define PerfCounter new parameter interrupts as following PerfCounter interrupts VProcessor O Mnterrupts sec 60 Please note double quotes around performance counter path Samples for calculating average value will be taken every second You may run typeperf qx to get list of all performance counters available in Windows How often list of active checks is refreshed in seconds RefreshActiveChecks Note that after failing to refresh active checks the next refresh will be attempted after 60 seconds List of comma delimited IP addresses or hostnames of Zabbix servers No spaces allowed Incoming connections will be accepted only from the hosts listed here Note that hostnames must resolve hostname address and IP address hostname If IPv6 support is enabled then 127 0 0 1 127 0 0 1 ffff 127 0 0 1 are treated equally List of comma delimited IP port or hostname port pairs of Zabbix servers for active checks No spaces allowed If port is not specified default port
40. er expression that caused a notification x lt Original name with macros not expanded of the Nth item in the trigger expression that caused a notification Supported since 2 0 6 Resolved to either 1 the latest value of the Nth item in the trigger expression if used for displaying triggers In this case works the same as ITEM LASTVALUE 2 the historical at the time of event value of the ITEM VALUE lt 1 9 gt Nth item in the trigger expression if used for displaying events and notifications Will resolve to UNKNOWN if the history value has already been deleted or has never been stored Supported since 1 4 3 2 2 9 5 2 iowmass kkel ETT E 188 Pa Proxy name of the Nth item the trigger expression PROXY NAMES ESSE that caused a notification since 1 8 4 TIME Current time in hh mm ss Trigger description Supported since 2 0 4 TRIGGER DESCRIPTION TRIGGER COMMENT is deprecated Number of acknowledged events for a map element in STDICCED EVENTS ACV v v maps or for the trigger ITEM NAME ORIG lt 1 9 gt https www zabbix com documentation 2 0 manual appendix macros supported by location Page 6 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM V LIEN which generated current event in notifications Supported since 1 8 3 Number of acknowle
41. er in non UTF8 encoding this will lead to a failed SQL query PGRES FATAL ERROR ERROR invalid byte sequence for encoding and data will not be stored An appropriate warning message will be written to the zabbix server log Relevant for at least PostgreSQL version 9 1 3 2 0 manual appendix items encoding of values txt Last modified 2012 04 12 21 23 by zalex ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items encoding of values Page 1 of 1 5 Large file support Zabbix 12 5 13 2 11 PM 5 Large file support Large file support often abbreviated to LFS is the term applied to the ability to work with files larger than 2 GB on 32 bit operating systems Since Zabbix 2 0 support for large files has been added This change affects at least log file monitoring and all vfs file items Large file support depends on the capabilities of a system at Zabbix compilation time but is completely disabled on a 32 bit Solaris due to its incompatibility with procfs and swapctl 2 0 manual appendix items large_file_support txt Last modified 2012 05 21 13 18 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org lice
42. her Number of pre forked instances of ICMP pingers The upper limit used to be 255 before version 1 8 5 StartJavaPollers Number of pre forked instances of pollers for unreachable hosts including IPMI The upper limit used to be 255 before version 1 8 5 This option is missing in version 1 8 3 Number of pre forked instances of pollers The upper limit used to be 255 before version 1 8 5 StartPollersUnreachable StartPollers If set to 1 SNMP trapper process will be started This option is supported in version 2 0 0 and higher Number of pre forked instances of trappers Trappers accept incoming connections from Zabbix sender and active agents The upper limit used to be 255 before version 1 8 5 StartTrappers Specifies how long we wait for agent SNMP device or external check in seconds tmp Temporary directory Specifies how many seconds trapper may spend processing new data How often host is checked for availability during the unavailability period in seconds TrapperTimeout UnavailableDelay 1 300 1 3600 How often host is checked for availability during the unreachability period in seconds UnreachableDelay 1 3600 After how seconds of unreachability treat a host as unavailable UnreachablePeriod 3600 StartSNMPTrapper x 2 0 manual appendix config zabbix_proxy txt Last modified 2013 10 09 22 28 by richlv Except where otherwise noted content on t
43. his wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix proxy Page 4 of 4 3 Zabbix agent UNIX Zabbix 12 5 13 2 09 PM 3 Zabbix agent UNIX The parameters supported in a Zabbix agent configuration file zabbix agentd conf Sets an alias for an item key The alias can be used instead of the full item key in item configuration For example Alias system cpu load percpu 5 system cpu load percpu avg5 Alias Item key system cpu load percpu 5 Item name Processor load 2 min average per core An alias can be especially useful to substitute a long and complex item key with a smaller and simpler one Multiple aliases can be defined Allow the agent to run as If disabled and the agent is started by the agent will try to switch to user zabbix instead Has no effect if started under a regular user 0 do not allow 1 allow AllowRoot BufferSend Do not keep data longer than N seconds in buffer 600 9 Maximum number of values memory buffer The agent will 65535 100 send all collected data to Zabbix server or proxy if the buffer is full 3 Specifies debug level 0 no debug 1 critical information 0 4 2 error information 3 warnings 4 for debugging produces lots of information Whether remote comma
44. ich the TRIGGER TEMPLATE NAME trigger is defined or UNKNOWN if the trigger is defined in a host Supported cinen TRIGGER PROBLEM EVENTS PROBLEM ACK TRIGGER NAME ORIG TRIGGER SEVERITY https www zabbix com documentation 2 0 manual appendix macros supported by location Page 7 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM J2ureve c v BERE Trigger URL Current trigger value O trigger is in OK state 1 trigger is in PROBLEM state 2 trigger UNKNOWN This macro can also be used in trigger expressions Number of unacknowledged triggers for a map element disregarding trigger state Trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged Number of unacknowledged PROBLEM triggers for a map element Trigger is considered to be unacknowledged if at least one of its PROBLEM events is unacknowledged Supported since 1 8 3 Number of acknowledged triggers for a map element disregarding trigger state Trigger is considered to be acknowledged if all of it s PROBLEM events are acknowledged Supported since 1 8 3 Number of acknowledged PROBLEM triggers for a map element Trigger is considered to be acknowledged if all of it s PROBLEM events are acknowledged Supported since 1 8 3 fk TRIGGER VALUE TRIGGERS UNACK TRIGGERS PROBLEM UNACK TRIGGERS ACK TRIGGERS PROBLEM ACK
45. in my item keys because they worked in older versions but space is not a valid symbol for item key 1 8 or any other reason to mass modify item keys How should do it and what should i beware of A You may use a database query to replace all occurrences of spaces in item keys with underscores update items set key_ replace key_ 5 Triggers will be able to use these items without any additional modifications but you might have to change any item references in these locations Notifications actions Map element and link labels Calculated item formulas 4 Q My graphs have dots instead of lines or empty areas Why so A Data is missing This can happen for a variety of reasons performance problems on Zabbix database Zabbix server network monitored devices 5 Zabbix daemons fail to start up with a message Listener failed with error socket for 10050 failed with error 22 Invalid argument A This error arises at attempt to run Zabbix agent compiled on version 2 6 27 or above on a platform with a kernel 2 6 26 and lower Note that static linking will not help in this case because it is the socket system call that does not support SOCK_CLOEXEC flag on earlier kernels ZBX 3395 https support zabbix com browse ZBX 3395 6 Q I try to set up a flexible user parameter one that accepts parameters with a command that uses a positional parameter like 1 but it doesn t work uses item parameter instead
46. ions listed user definable macros since Zabbix 2 0 are supported in numerous other locations a Hosts Interface IP DNS Interface port Passive proxy Items Interface port SNMPv3 security name SNMPv3 auth pass SNMPv3 priv pass SNMPv1 v2 community SNMP OID DB monitor additional parameters SSH username SSH public key SSH private key SSH password SSH script Telnet username Telnet password Telnet script Calculated item formula Discovery SNMPv3 security name SNMPv3 auth pass SNMPv3 priv pass SNMPv1 v2 community SNMP OID Macros used in low level discovery There is a type of macro used within the low level discovery function It is a macro that is used in an LLD rule and returns real values of file system names network interfaces and SNMP OIDs These macros can be used for creating item trigger and graph prototypes Then when discovering real file systems network interfaces etc these macros are substituted with real values and are the basis for creating real items triggers and graphs https www zabbix com documentation 2 0 manual appendix macros supported by location Page 9 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM LLD macros can be used for item prototypes in names key parameters SNMP OIDs calculated item formulas SSH and Telnet scripts database monitor item parameters for trigger prototypes names
47. is used IPv6 addresses must be enclosed in square brackets if port for that host is specified If port is not specified square brackets for IPv6 addresses are optional If this parameter is not specified active checks are disabled Number of pre forked instances of zabbix_agentd that process passive checks StartAgents no 0 100 13 If set to 0 disables passive checks and the agent will not listen on any TCP port The upper limit used to be 16 before version 1 8 5 Allow all characters to be passed in arguments to user defined parameters 0 do not allow 1 allow Server ServerActive UnsafeUserParameters User defined parameter to monitor There can be several user defined parameters Format UserParameter lt key gt lt shell command gt Note that shell command must not return empty string or EOL only Example UserParameter system test echo 1 UserParameter https www zabbix com documentation 2 0 manual appendix config zabbix agentd win Page 2 of 3 4 Zabbix agent Windows Zabbix 12 5 13 2 09 PM In Zabbix agent 2 0 0 version configuration parameters related to active and passive checks have been changed See the See also section at the bottom of this page to read more details about these changes See also 1 Differences in the Zabbix agent configuration for active and passive checks starting from version 2 0 0 http blog zabbix com multiple servers for active agent sure 858 configuration file
48. keep database tables on different hard disks history history str items functions triggers and trends are most heavily used tables for large installations keeping of MySQL temporary files in tmpfs is recommended General advice monitor required parameters only tune Update interval for all items Keeping a small update interval may be good for nice graphs however this may overload Zabbix tune parameters for default templates tune housekeeping parameters do not monitor parameters which return the same information avoid the use of triggers with long period given as function argument For example max 3600 will be calculated significantly slower than max 60 See also 1 How to configure optimal count of zabbix processes http blog zabbix com monitoring how busy zabbix processes are 457 2 0 manual appendix performance tuning txt Last modified 2013 10 26 16 15 by zalex ua Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix performance tuning Page 2 of 2 11 Version compatibility Zabbix 12 5 13 2 12 PM 11 Version compatibility Supported agents Older agents from Zabbix 1 0 Zabbix 1 1 x Zabbix 1 4 x Zabbix 1 6 x and Zabbix 1 8 x can still be used with Zabbix 2 0 It does not require a
49. le UTIL1 1 minute average CPU utilization CONNMAX max licensed connections used VFKSys bytes free on volume Sys Full list of parameters supported by the agent can be found in readme txt which is part of the software Tuxedo Tuxedo command line utilities tmadmin and qmadmin can be used in definition of a UserParameter in order to return per server service queue performance counters and availability of Tuxedo resources Informix https www zabbix com documentation 2 0 manual appendix recipes Page 2 of 3 9 Recipes for monitoring Zabbix 12 5 13 2 12 PM Standard Informix utility onstat can be used for monitoring of virtually every aspect of Informix database Also Zabbix can retrieve information provided by Informix SNMP agent HP OpenView Zabbix can be configured to send messages to OpenView server The following steps must be performed Step 1 Define new media The media will execute a script which will send required information to OpenView Step 2 Define new user The user has to be linked with the media Step 3 Configure actions Configure actions to send all or selected trigger status changes to the user Step 4 Write media script The script will have the following logic If trigger is ON then execute OpenView command opcmsg id application application msg grp msg grp object lt object gt msg_text lt text gt The command will return unique message ID which has to be stored so
50. lude JavaGatewayPort LogFileSize LogFile 1024 32767 0 1024 LogSlowQueries 3600000 https www zabbix com documentation 2 0 manual appendix config zabbix server I 12 5 13 2 09 PM Size of history cache in bytes Shared memory size for storing history data The upper limit used to be 1G before version 2 0 5 8M Size of text history cache in bytes Shared memory size for storing character text or log history data The upper limit used to be 1G before version 2 0 5 How often Zabbix will perform housekeeping procedure in hours Housekeeping 15 removing unnecessary information from history alert and alarms tables No more than MaxHousekeeperDelete rows corresponding to tablename field value will be deleted per one task in one housekeeping cycle SQLite3 does not use this parameter deletes all corresponding rows without a limit If set to 0 then no limit is used at all In this case you must know what you are doing This option is supported in version 1 8 2 and higher You may include individual files or all files in a directory in the configuration file IP address or hostname of Zabbix Java gateway Only required started This option is supported in version 2 0 0 and higher Port that Zabbix Java gateway listens on This option is supported in version 2 0 0 and higher List of comma delimited IP addresses that the trapper should listen on Trapper will lis
51. mentation 2 0 manual appendix install windows agent Page 1 of 2 2 Zabbix Windows agent installation Zabbix 12 5 13 2 08 PM The default value for Hostname is the value returned by the Hostnameltem parameter So in effect if both these parameters are unspecified the actual hostname will be the host NetBIOS name The system hostname key always returns the NetBIOS host name which is limited to 15 symbols and in UPPERCASE only regardless of the length and lowercase uppercase characters in the real host name So if both parameters are unspecified then the Zabbix agent will use NetBIOS host name to retrieve the list of active checks from the Zabbix server and to send results to it Starting from Zabbix agent 1 8 6 version for Windows the system hostname key supports an optional parameter type of the name The default value of this parameter is netbios for backward compatibility and the other possible value is host The system hostname host key always returns the full real case sensitive Windows host name So to simplify the configuration of zabbix agentd conf file and make it unified two different approaches could be used 1 leave Hostname or Hostnameltem parameters undefined and Zabbix agent will use NetBIOS host name as the hostname 2 leave Hostname parameter undefined and define Hostnameltem like this Hostnameltem system hostname host and the Zabbix agent will use the full real case sensitive Windows
52. mewhere preferrably in a new table of ZABBIX database If trigger is OFF then opcmack message id has to be executed with message ID retrieved from the database Refer to OpenView official documentation for more details about opcmsg and opcmack The media script is not given here 2 0 manual appendix recipes txt Last modified 2012 09 04 14 42 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix recipes Page 3 of 3 10 Performance tuning Zabbix 12 5 13 2 12 PM 10 Performance tuning This is a work in progress Overview It is very important to have Zabbix system properly tuned for maximum performance Hardware General advice on hardware Use fastest processor available SCSI or SAS is better than IDE performance of IDE disks may be significantly improved by using utility hdparm and SATA 15K RPM is better than 10K RPM which is better than 7200 RPM Use fast RAID storage Use fast Ethernet adapter Having more memory is always better Operating system a Use latest stable version of OS a Exclude unnecessary functionality from kernel Tune kernel parameters Zabbix configuration parameters Many parameters may be tuned to get optimal performance zabbix server StartPollers General r
53. nd higher SenderFrequency 5 3600 30 How often Zabbix will try to send unsent alerts in seconds Temporary file used for passing data to the server This option is supported in version from SNMP trap daemon Must be the same as in SNMPTrapperFile no tmp zabbix_traps tmp zabbix_trap_receiver p or SNMPTT configuration file 2 0 0 and higher SourcelP no Source IP address connections for outgoing Location of public and private keys for Number of pre forked instances of DB This option is supported in version Syncers StartDBSyncers 1 100 4 The upper limit used to be 64 before version 1 8 5 1 8 3 and higher Number of pre forked discoverers StartDiscoverers 0 250 1 The upper limit used to version 1 8 5 Number of pre forked HTTP pollers The upper limit used to version 1 8 5 StartHTTPPollers Number of pre forked IPMI pollers The upper limit used to version 1 8 5 StartIPMIPollers Number of pre forked Java pollers https www zabbix com documentation 2 0 manual appendix config zabbix server instances of be 255 before instances of be 255 before instances of be 255 before instances of Page 3 of 5 1 Zabbix server Zabbix 0 1000 Cc E id Ek E 1 5 3 4 StartJavaPollers no StartPingers 1 StartPollersUnreachable StartPollers 5 StartProxyPollers StartSNMPTrapper StartTrappers TrapperTimeout TrendCacheSize
54. nds from Zabbix server are allowed 0 not allowed 1 allowed Unique case sensitive hostname Required for active checks and must match hostname as Set by Hostnameltem configured on the server Allowed characters alphanumeric Maximum length 64 BufferSize DebugLevel EnableRemoteCommands Hostname and Item used for setting Hostname if it is undefined Does not support UserParameters performance counters or aliases but does support system run regardless of EnableRemoteCommands value Hostnameltem system hostname 0 0 0 0 Ignored if Hostname is set This option is supported in version 1 8 6 and higher You may include individual files or all files in a directory in the Include configuration file List of comma delimited IP addresses that the agent should listen on Multiple IP addresses are supported in version 1 8 3 and higher 2767 10050 Agent will listen this port for connections from the server 1 Maximum size of log file in 0 disable automatic log rotation ListenIP ListenPort Wr o A N LogFileSize Name of log file LogFile If not set syslog is used https www zabbix com documentation 2 0 manual appendix config zabbix agentd Page 1 of 3 3 Zabbix agent UNIX Zabbix 12 5 13 2 09 PM Enable logging of executed shell commands as warnings 0 disabled 1 enabled LogRemoteCommands no Maximum n
55. ng results in using a socket In case DBHost no localhost of PostgreSQL only empty string results in attempt to use socket Database name For SQLite3 path to database file must DBName YSS be provided DBUser and DBPassword are ignored Database password Ignored for SQLite DBKasSworo m Comment this line if no password is used 1024 Database port when not using local 65535 3300 socket Ignored for SQLite DBSocket Io tmp mysql sock Path to MySQL socket Specifies debug level 0 no debug 1 critical information 3 2 error information 3 warnings 4 for debugging produces lots of information DisableHousekeeping If set to 1 housekeeping is disabled Location of external scripts depends ExternalScripts no usr local share zabbix externalscripts on compile time installation variable datadir Location of fping6 Make sure that fping6 binary has root no ownership and SUID flag set Make empty Fping6Location if your fping utility is capable to process IPv6 addresses e Fping6Location usr sbin fping6 Location of fping usr sbin fping Make sure that fping binary has root ownership and SUID flag set FpingLocation https www zabbix com documentation 2 0 manual appendix config zabbix server Page 1 of 5 1 Zabbix server Zabbix 128K HistoryCacheSize 2 HistoryTextCacheSize oS N HousekeepingFrequency 1 24 0 MaxHousekeeperDelete 1000000 Inc
56. nistration settings of your monitoring system Users Add users that will have access to Zabbix assign them to user groups and grant permissions Configure media types and the ways users will receive alerts User API User group API Media type API Media API General Change certain global configuration options Icon map API Image API User macro API Proxies Manage the proxies used in your distributed monitoring setup Proxy API Scripts Configure and execute scripts to help you with your daily tasks Script API API information https www zabbix com documentation 2 0 manual appendix api api Page 3 of 4 Zabbix Zabbix 12 5 13 2 14 PM Retrieve the version of the Zabbix API so that your application could use version specific features API info API 2 0 manual appendix api api txt Last modified 2013 02 07 11 03 by Pavels Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix api api Page 4 of 4 Internal audit log Zabbix 12 5 13 2 14 PM Internal audit log quick draft Zabbix frontend AND API 28 4842 https support zabbix com browse ZBX 4842 log all changes to the configuration well currently they don t log all actions Zabbix server logs all changes to the configuration like th
57. nses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items large file support Page 1 of 1 6 Unreachable unavailable host settings Zabbix 12 5 13 2 11 PM 6 Unreachable unavailable host settings Overview Several configuration parameters define how Zabbix server should behave when an agent check Zabbix SNMP IPMI JMX fails and a host becomes unreachable Unreachable host A host is treated as unreachable after a failed agent check network error timeout From that moment UnreachableDelay defines how often items are rechecked in this unreachability situation and such rechecks will be performed already by unreachable pollers By default it is 15 seconds before the next check In the Zabbix server log unreachability is indicated by messages like these Zabbix agent item system cpu load percpu avgl on host New host failed first network error wait for 15 seconds Zabbix agent item system cpu load percpu avg15 on host New host failed another network error wait for 15 seconds Note that the exact item that failed is indicated and the item type Zabbix agent The Timeout parameter will also affect how early an item is rechecked during unreachability If the Timeout is 20 seconds and UnreachableDelay 30 seconds the next check will be in 50 seconds after the first attempt The UnreachablePeriod parameter defines how long the unreachability period is in total By default UnreachablePeriod is 4
58. ny configuration changes on agent side However to take full advantage of new and improved items improved performance and reduced memory usage use the latest 2 0 agent Supported Zabbix proxies Only Zabbix 2 0 proxies may be used with Zabbix server Zabbix 1 6 and 1 8 proxies are not supported with Zabbix 2 0 server Zabbix 2 0 proxies may only be used with Zabbix 2 0 server They will not work with 1 8 or older Zabbix server Supported distributed monitoring nodes All distributed monitoring nodes must be of the same major version 1 8 nodes are not supported together with 2 0 nodes Supported XML files XML files exported with 1 8 are supported for import in Zabbix 2 0 2 0 manual appendix compatibility txt Last modified 2012 11 14 10 00 by richlv Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix compatibility Page 1 of 1 Zabbix API Zabbix 12 5 13 2 14 PM Zabbix API The Zabbix API is a powerful tool for extending Zabbix developing apps for your favorite platform or integrating it with third party software This section provides an overview of the functions provided by the Zabbix API and will help you find your way around the available classes and methods Monitoring The Zabbix API allows you to access hist
59. ode jx x p xj ytes default KX x x x x x mode a facets X X x xx x x mors __ x x jx x p x _ x X x x x fe b net tcp listen port m Mewpponapegord k p p p p p metepsendeeser ie por bkk ee tl 1 proc mem lt name gt lt user gt lt mode gt lt cmdline gt x x proc num lt name gt lt user gt lt state gt lt cmdline gt x opes ope Be be eo Ds I al defau 1 1 x eee x p qx x sensorBdevieesenson mode __ Isystembootime X Iystemcpuintr __ ix x X x cpu load lt cpu gt lt mode gt beoe pe be x x x x x Kx xpi Jx x x x 20 Ev 0 dip aas JXx Jx jx x jx jx jx system cpu num type x ix x ix x jx systemepumum type 00000000 mx Iysemepuswithes kl systemcpuutill cpu type mode user mon windows x system Windows default um 1 https www zabbix com documentation 2 0 manual appendix items supported by platform Page 2 of 5 1 Items supported by platform Zabbix 12 5 13 2 10 PM ke
60. ods may be used in order to monitor availability of a server ICMP ping icmpping key a zabbix host agent available item trigger function nodata for monitoring the availability of hosts that use active checks only Sending alerts via WinPopUps WinPopUps maybe very useful if you re running Windows OS and want to get quick notification from Zabbix It could be good addition for email based alert messages Details about enabling of WinPopUps can be found at http www zabbix com forum showthread php t22147 http www zabbix com forum showthread php 2147 Monitoring specific applications AS 400 IBM AS 400 platform can be monitored using SNMP More information is available at http publib b boulder ibm com Redbooks nsf RedbookAbstracts sg244504 html Open http publib b boulder ibm com Redbooks nsf RedbookAbstracts sg244504 html Open MySQL Several user parameters can be used for the monitoring of MySQL in the agent configuration file usr local etc zabbix agentd conf Set of parameters for monitoring MySQL server v3 23 42 and later 3222 Change u and add if required UserParameter mysql ping mysqladmin uroot ping grep alive wc 1 UserParameter mysql uptime mysqladmin uroot status cut f2 d cut f2 d UserParameter mysql threads mysqladmin uroot status cut f3 d cut f2 d UserParameter mysql questions mysqladmin uroot status cut f4 d cut f2 d Use
61. ory and other data gathered during monitoring History Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing History API Events Retrieve events generated by triggers network discovery and other Zabbix systems for more flexible situation management or third party tool integration Event API Service monitoring Retrieve detailed service layer availability information about any IT service IT service SLA calculation Configuration The Zabbix API allows you to manage the configuration of your monitoring system Hosts and host groups Manage host groups hosts and everything related to them including host interfaces host macros and maintenance periods Host API Host group API Host interface API User macro API Maintenance API Items and applications Define items to monitor Create or remove applications and assign items to them Item Application API https www zabbix com documentation 2 0 manual appendix api api Page 1 of 4 Zabbix Zabbix 12 5 13 2 14 PM Triggers Configure triggers to notify you about problems in your system Manage trigger dependencies Trigger API Graphs Edit graphs or separate graph items for better presentation of the gathered data Graph API Graph item API Templates Manage templates and link them to hosts or other templates Template API Export and import Export and import Zabbix configuration data for configura
62. r For example last 0 86400 will return the most recent value one day ago Zabbix does not guarantee exact order of values if more than two values exist within one second in history Parameter is supported starting from Zabbix 1 6 2 Parameter time shift is supported starting from Zabbix 1 8 2 See function avg for an example of its use Check if Event ID of the last log entry matches a regular expression Parameter defines the regular expression POSIX extended http en wikipedia org wiki Regular expression POSIX Extended Regular Expressions style Returns 0 does not match 1 matches This function is supported since Zabbix 1 8 5 Returns log severity of the last log entry Parameter is ignored 0 default severity N severity integer useful for Windows event logs Zabbix takes log severity from field Information of Windows event log Check if log source of the last log entry matches parameter 0 does not match 1 matches Normally used for Windows event logs For example logsource VMWare The maximum highest value of a period The period is set in seconds or as a number of collected values preceded by a https www zabbix com documentation 2 0 manual appendix triggers functions Page 2 of 4 1 Supported trigger functions Zabbix 12 5 13 2 11 PM hash mark in the first parameter Since Zabbix 1 8 2 the function supports a second optional parameter time_shift See function
63. rParameter mysql slowqueries mysqladmin uroot status cut f5 d cut f2 d JUserParameter mysql qps mysqladmin uroot status cut f9 d cut f2 d UserParameter mysql version mysql V mysql ping Check whether MySQL is alive Result 0 not started 1 alive mysql uptime Number of seconds MySQL is running https www zabbix com documentation 2 0 manual appendix recipes Page 1 of 3 9 Recipes for monitoring Zabbix 12 5 13 2 12 PM a mysql threads Number of MySQL threads a mysql questions Number of processed queries mysql slowqueries Number of slow queries mysql qps Queries per second mysql version Version of MySQL For example mysql Ver 14 14 Distrib 5 1 53 for pc linux gnu 1686 For additional information see also the userparameter_mysql conf file in conf zabbix agentd directory Mikrotik routers Use SNMP agent provided by Mikrotik See http www mikrotik com http www mikrotik com for more information WIN32 Use Zabbix W32 agent included pre compiled into Zabbix distribution Novell Use MRTG Extension Program for NetWare Server MRTGEXT NLM agent for Novell The agent is compatible with protocol used by Zabbix It is available from http forge novell com modules xfmod project mrtgext http forge novell com modules xfmod project mrtgext Items have to be configured of type Zabbix Agent and must have keys according to the MRTGEXT documentation For examp
64. rd Ignored for SQLite Comment this line if no password is used DBSchema Schema name Used for IBM DB2 Path to MySQL socket DBSocket 3306 Database port when not using local socket Ignored for SQLite DataSenderFrequency ae 1 3600 1 Proxy will send collected data to the server every N seconds Specifies debug level 0 no debug 1 critical information DebugLevel no 0 4 3 2 error information 3 warnings 4 for debugging produces lots of information Location of external scripts depends ExternalScripts no usr local share zabbix externalscripts on compile time installation variable datadir Location of fping6 Make sure that fping6 binary has root 4 ownership and SUID flag set Fping6Location no usr sbin fping6 Make empty Eping6Location if your fping utility is capable to process IPv6 addresses Location of fping Database For SQLite3 path to database file must DBName yes be provided DBUser and DBPassword are ignored Warning Do not attempt to use the same database Zabbix server is using lj 21 22 e https www zabbix com documentation 2 0 manual appendix config zabbix proxy Page 1 of 4 2 Zabbix proxy Zabbix 12 5 13 2 09 PM FpingLocation no usr sbin fping Make sure that fping binary has root ownership and SUID flag set Frequency of heartbeat messages in seconds Used for monitoring availability of HeartbeatFrequency proxy on server side 0 he
65. s 2 0 manual appendix triggers txt Last modified 2012 02 20 15 14 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix triggers Page 1 of 1 1 Supported trigger functions Zabbix 12 5 13 2 11 PM 1 Supported trigger functions All functions supported in trigger expressions are listed here Returns absolute difference between last and previous values For strings 0 values are equal 1 values differ a a ee The average value of a period The period is set in seconds or as a number of collected values preceded by a hash mark for example 5 five latest values in the first parameter The function accepts a second optional parameter time_shift It is useful when there is a need to compare the current average value with the average value time_shift seconds back For instance avg 3600 86400 will return the average value for an hour one day ago Parameter time_shift is supported from Zabbix 1 8 2 2 eS ES ee een eS Returns difference between last and previous values For strings 0 values are equal 1 values differ The number of collected values in a period The period is set in seconds or as a number of values preceded by a hash mark in the firs
66. t most recent value in characters not bytes Parameters work the same as with last function see above in the table For example strlen O is equal to 1 strlen 3 length of the third most recent value strlen 0 86400 length of the most recent value one day ago This function is supported since Zabbix 1 8 4 5 _ _ _ The sum of collected values in a period The period is set in seconds as a number of values preceded by hash mark in the first parameter Since Zabbix 1 8 2 the function supports a second optional parameter time_shift See function avg for an example of its use Xj time Returns current time in HHMMSS format Example 123055 1 All functions return numeric values only Comparison to strings is not supported for example 2 Some of the functions cannot be used for non numeric parameters 3 String arguments should be double quoted Otherwise they might get misinterpreted https www zabbix com documentation 2 0 manual appendix triggers functions Page 3 of 4 1 Supported trigger functions Zabbix 12 5 13 2 11 PM 2 0 manual appendix triggers functions txt Last modified 2013 05 22 10 51 martins v Except where otherwise noted content on this wiki is licensed under the
67. t inventory Tag field in host inventory PROFILE TAG 1 9 is deprecated Type field in host inventory PROFILE DEVICETYPE 1 9 gt is deprecated Type Full details field in host inventory URL A field inventory in host URL B field in host inventory URL C field in host inventory Vendor field in host inventory Numeric ID of the Nth item in the trigger expression that caused a notification Supported since 1 8 12 Description of the Nth item in the trigger expression that caused a notification Supported since 2 0 0 Key of the Nth item in the trigger expression that caused a notification Supported since 2 0 0 TRIGGER KEY is deprecated Original key with macros not expanded of the Nth item in the trigger Page 5 of 10 1 Macros supported by location Zabbix 12 5 13 2 12 PM expression tnat causea a notification Supported since 2 0 6 The latest value of the Nth item in the trigger expression that caused a ITEM LASTVALUE lt 1 9 gt notification Supported since 1 4 3 t 15 alias to HOST HOST ITEM KEY last 0 iremtoc ace lt i 9 gt iremLoc pae lt i 9 gt iremLoc eventio lt i 9 gt kf J J j 1 1 5 lt 1 9 gt x J J j 1 10 5008 lt 1 5 Kf J j J J j Name of the Nth item in the ITEM NAME lt 1 9 gt trigg
68. t parameter The function accepts a second optional pattern parameter a third operator parameter and a fourth time_shift parameter For pattern integer items exact match float items match within 0 000001 Supported operators eq equal ne not equal gt greater ge greater or equal It less le less or equal like matches if contains pattern For integer and float items operators eq default ne gt ge It le are supported For string text and log items operators like default eq ne are supported Examples count 600 the number of values for last 10 minutes count 600 12 the number of values for last 10 minutes that equal 12 count 600 12 91 the number of values for last 10 minutes that are over 12 10 12 91 the number of values within last 10 values that are over 12 count 600 12 gt 86400 the number of values for preceding 10 minutes to 24 hours ago that were over 12 count 600 86400 the number of values for preceding 10 minutes up to 24 hours ago parameter is supported from Zabbix 1 6 1 time shift parameter and string operators are supported from Zabbix 1 8 2 See function avg for an example of using time shift 1 Returns current date in YYYYMMDD format For MIL X 20031025 ia ce
69. ten on all network interfaces if this parameter is missing Multiple IP addresses are supported 0 0 0 0 in version 1 8 3 and higher 10051 Listen port for trapper 1 Maximum size of log file in MB 0 disable automatic log rotation if Java pollers are 10052 16M 1 00 How long a database query may take before being logged in milliseconds 0 don t log slow queries This option becomes enabled starting with DebugLevel 3 Supported since Zabbix 1 8 2 version Unique NodelD in distributed setup Page 2 of 5 1 Zabbix server Zabbix 0 999 0 0 standalone server If set to 1 local events to master node NodeNoEvents no 0 1 This won t impact ability of this node to propagate events from its child nodes 12 5 13 2 09 PM won t be sent If set to 1 local history won t be sent to propagate history from its child to master node NodeNoHistory no 0 1 This won t impact ability of this node nodes PidFile o tmp zabbix_server pid Name of PID file server sends configuration data to a Zabbix proxy in This option is supported in version How often Zabbix 1 seconds Used only for proxies in a ProxyConfigFrequency no 604800 3600 passive mode 1 8 3 and higher history data from a Zabbix proxy in This option is supported in version How often Zabbix server requests ProxyDataFrequency 1 3600 1 seconds Used only for proxies in a passive mode 1 8 3 a
70. tion backups migration or large scale configuration updates Configuration API Low level discovery Configure low level discovery rules as well as item trigger and graph prototypes to monitor dynamic entities LLD rule API Item prototype API Trigger protototype API Graph prototype API Screens Edit global and template level screens or each screen item individually Screen API Screen item API Template screen API Template screen item API Actions and alerts Define actions and operations to notify users about certain events or automatically execute remote commands Gain access to information about generated alerts and their receivers Action API Alert API IT services Manage IT services for service level monitoring and retrieve detailed SLA information about any service IT service API https www zabbix com documentation 2 0 manual appendix api api Page 2 of 4 Zabbix API Zabbix 12 5 13 2 14 PM Maps Configure maps to create detailed dynamic representations of your IT infrastructure Map API Web monitoring Configure web scenarios to monitor your web applications and services Web scenario API Network discovery Manage network level discovery rules to automatically find and monitor new hosts Gain full access to information about discovered services and hosts Discovery rule API Discovery check API Discovery host API Discovery service API Administration With the Zabbix API you can change admi
71. u lt username gt p lt password gt zabbix lt database mysql images sql i shell mysql u lt username gt p lt password gt zabbix lt database mysql data sql shell gt psql U lt username gt psql gt create database zabbix psql gt q shell gt cd database postgresql shell gt psql U lt username gt zabbix lt schema sql stop here if you are creating database for Zabbix proxy shell gt psql U lt username gt zabbix lt images sql shell gt psql U lt username gt zabbix lt data sql Oracle we assume that user zabbix with password password exists and has permissions to create database objects in service ORCL If you are creating database for Zabbix server you need to have images somewhere on Oracle host copy directory create images old_images somewhere on Oracle server e g home oracle shell gt scp r create images old_images user host home oracle edit file database oracle images sql and set images dir variable to where you have copied them g home oracle old images CREATE OR REPLACE DIRECTORY image dir AS home oracle old images shell gt sqlplus zabbix password host ORCL Sqlplus set def off Sqlplus database oracle schema sql f stop here if you are creating database for Zabbix proxy Sqlplus database oracle images sql sqlplus gt database oracle data sql Zabbix requires a UTF 8 database character set If database is not UTF 8 it can be converted by running ALTER DATABA
72. ule keep value of this parameter as low as possible Every additional instance of zabbix server adds known overhead in the same time parallelism is increased Optimal number of instances is achieved when queue on average contains minimum number of parameters ideally O at any given moment This value can be monitored by using internal check zabbix queue See the See also section at the bottom of this page to find out how to configure optimal count of zabbix processes DebugLevel Optimal value is 3 DBSocket MySQL only It is recommended to use DBSocket for connection to the database That is the fastest and the https www zabbix com documentation 2 0 manual appendix performance tuning Page 1 of 2 10 Performance tuning Zabbix 12 5 13 2 12 PM most secure way Database engine This is probably the most important part of Zabbix tuning Zabbix heavily depends on the availability and performance of database engine use fastest database engine i e MySQL use Stable release of a database engine rebuild MySQL or PostgreSQL from sources to get maximum performance follow performance tuning instructions taken from MySQL or PostgreSQL documentation for MySQL use InnoDB table structure ZABBIX works at least 1 5 times faster Comparing to if InnoDB is used This is because of increased parallelism However InnoDB requires more CPU power tuning the database server for the best performance is highly recommended
73. umber of new lines the agent will send per second to Zabbix server or proxy when processing log and eventlog active checks 1 The provided value will be overridden by the parameter 100 1000 maxlines provided in log or eventlog item key Note Zabbix will process 4 times more new lines than set in MaxLinesPerSecond to seek the required string in log items tmp zabbix_agentd pid Name of PID file MaxLinesPerSecond aM PidFile How often list of active checks is refreshed in seconds 120 Note that after failing to refresh active checks the next refresh will be attempted after 60 seconds o l RefreshActiveChecks 3600 List of comma delimited IP addresses or hostnames of Zabbix servers No spaces allowed Incoming connections will be accepted only from the hosts listed here Note that hostnames must resolve hostname gt IP address and IP address If IPv6 support is enabled then 127 0 0 1 127 0 0 1 1ffff 127 0 0 1 are treated equally List of comma delimited IP port or hostname port pairs of Zabbix servers for active checks No spaces allowed If port is not specified default port is used IPv6 addresses must be enclosed in square brackets if port for that host is specified If port is not specified square brackets for IPv6 addresses are optional If this parameter is not specified active checks are disabled Server ServerActive UnsafeUserP
74. well If sending of some values fails on the server for example because host or item has been disabled or deleted agent will not retry sending of those values For example Agent opens a TCP connection Agent asks for the list of checks Server responds with a list of items item key delay Agent parses the response TCP connection is closed Agent starts periodical collection of data Ou Sending in collected data Agent sends lt HEADER gt lt DATALEN gt request agent data data 1 host hostname key log NV homeMV zabbixMV logsMV zabbix agentd log value 13039 20090907 184546 759 zabbix agentd started ZABBIX 1 6 6 revision 7836 lastlogsize 80 clock 1252926015 1 host hostname key agent version value 1 6 6 clock 1252926015 clock 1252926016 HEADER DATALEN i response i info Processed 2 Failed 0 Total 2 Seconds spent 0 002070 https www zabbix com documentation 2 0 manual appendix items activepassive Page 2 of 3 3 Passive and active agent checks Zabbix 12 5 13 2 10 PM For example Agent opens a TCP connection Agent sends a list of values Server processes the data and sends the status back TCP connection is closed AUNE Older XML protocol Zabbix server will take up to 16 MB of XML Base64 encoded data in one connection but a single decoded value should be no longer than 64 KB other
75. wise it will be truncated to 64 KB while decoding 2 0 manual appendix items activepassive txt Last modified 2013 05 14 16 57 martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix items activepassive Page 3 of 3 4 Encoding of returned values Zabbix 12 5 13 2 11 PM 4 Encoding of returned values Zabbix server expects every returned text value in the UTF8 encoding This is related to any type of checks zabbix agent ssh telnet etc Different monitored systems devices and checks can return non ASCII characters in the value For such cases almost all possible zabbix keys contain an additional item key parameter encoding This key parameter is optional but it should be specified if the returned value is not in the UTF8 encoding and it contains non ASCII characters Otherwise the result can be unexpected and unpredictable A description of behavior with different database back ends in such cases follows MySQL If a value contains a non ASCII character in non UTF8 encoding this character and the following will be discarded when the database stores this value No warning messages will be written to the zabbix server log Relevant for at least MySQL version 5 1 61 PostgreSQL If a value contains a non ASCII charact
76. y size for storing trends data The upper limit used to be 1G before version 2 0 5 checked for unavailability How often host is availability during the period in seconds How often host is checked availability during the unreachability period in seconds After how unreachability unavailable of as seconds a host many treat Page 4 of 5 1 Zabbix server Zabbix 12 5 13 2 09 PM 2 0 manual appendix config zabbix_server txt Last modified 2013 04 30 10 30 by martins v Except where otherwise noted content on this wiki is licensed under the following license CC Attribution Noncommercial Share Alike 3 0 Unported http creativecommons org licenses by nc sa 3 0 https www zabbix com documentation 2 0 manual appendix config zabbix server Page 5 of 5 2 Zabbix proxy Zabbix 12 5 13 2 09 PM 2 Zabbix proxy The parameters supported in a Zabbix proxy configuration file Size of configuration cache in bytes Shared memory size for storing hosts CacheSize and items data The upper limit used to be 1G before version 2 0 5 How often proxy retrieves 1 configuration data from Zabbix server ConfigFrequency 604800 3600 in seconds For a proxy in the passive mode this parameter will be ignored Database host name In case of MySQL localhost or empty localhost string results in using a socket In case of PostgreSQL only empty string results in attempt to use socket Database passwo

16 Appendices

Contents

Download Pdf Manuals

Related Search

Related Contents