1.

8:complete

http://www.zabbix.com/documentation/1.8/compl...

Zabbix 1.8 Manual
1. About
1.1. Overview of Zabbix
1.1.1. What is Zabbix?
Zabbix was created by Alexei Vladishev, and currently is actively developed and supported by Zabbix SIA. Zabbix is an enterprise-class open source distributed monitoring solution. Zabbix is software that monitors numerous parameters of a network and the health and integrity of servers. Zabbix uses a flexible notification mechanism that allows users to configure e-mail based alerts for virtually any event. This allows a fast reaction to server problems. Zabbix offers excellent reporting and data visualisation features based on the stored data. This makes Zabbix ideal for capacity planning. Zabbix supports both polling and trapping. All Zabbix reports and statistics, as well as configuration parameters, are accessed through a web-based front end. A web-based front end ensures that the status of your network and the health of your servers can be assessed from any location. Properly configured, Zabbix can play an important role in monitoring IT infrastructure. This is equally true for small organisations with a few servers and for large companies with a multitude of servers. Zabbix is free of cost. Zabbix is written and distributed under the GPL General Public License version 2. It means that its source code is freely distributed and available for the general public. Commercial support [http://www.zabbix.com/support.php] is available and provided by Zabbix Company.

1.1.2. What does Zabbix offer?
Zabbix offers: auto-discovery of servers and network devices distributed monitoring with centralised WEB administration support for both polling and trapping mechanisms server software for Linux, Solaris, HP-UX, AIX, Free BSD, Open BSD, OS X native high performance agents (client software for Linux, Solaris, HP-UX, AIX, Free BSD, Open BSD, OS X, Tru64/OSF1, Windows NT4.0, Windows 2000, Windows 2003, Windows XP, Windows Vista) agent-less monitoring secure user authentication flexible user permissions web-based interface flexible e-mail notification of predefined events high-level (business) view of monitored resources audit log

1.1.3. Why use Zabbix?
Open Source solution highly efficient agents for UNIX and WIN32 based platforms low learning curve high ROI. Downtimes are very expensive. low cost of ownership very simple configuration Centralised monitoring system. All information (configuration, performance data) is stored in relational database high-level service tree very easy setup support for SNMP (v1,v2). Both trapping and polling. visualisation capabilities built-in housekeeping procedure

1.1.4. Users of Zabbix
Many organisations of different size around the world rely on Zabbix as a primary monitoring platform. 0 Comments

1.2. Goals and Principles
1.2.1. Main Goals of Zabbix Development
There are several goals Zabbix is trying to achieve: become recognized Open Source monitoring tool create Zabbix user group, which helps making the software even better provide high-quality commercial support

1.2.2. Main principles of Zabbix development
be user friendly keep things simple use as few processing resources as possible

1 de 143

23/02/10 12:25

1.8:complete
react fast document every aspect of the software

http://www.zabbix.com/documentation/1.8/compl...

What's new in Zabbix 1.8
More than a year in making, Zabbix 1.8 has arrived with lots of new features, as well as improved old ones. You can introduce yourself to the changes for this new version of Zabbix in the following section.

1. Notable improvements
With so many changes it is impossible to pick 3 most notable ones - which is attempted below. For this reason, it is suggested to read on, as some generally minor feature might be very important to you. Performance improvements Full Unicode support Bar reports API technical preview

2. New features and improvements for the frontend
Zabbix web frontend is the feature that sets it apart from other solutions. Powerful, yet easy to use official GUI is shipped with the default package. It provides both non-intimidating access for novice users and large scale configuration features for sizable installations. Being most user-visible part, we will start by looking at many new features and improvements in Zabbix 1.8 for the web frontend. 2.1. Bar reports Zabbix already has easy to use simple graphs that do not require any configuration - these are provided for every numeric item. Custom graphs, along with a couple simplistic reports, allow to look at the data in context. Zabbix 1.8 brings much more powerful built-in reporting. New report category, bar reports, allows to look at the data from many different angles. Want to look at the weekly temperatures in the server room for the last two months? Have to compare webserver load for the first month of every quarter this year? All that and more is possible with this new feature.

2.2. Full Unicode support While previous Zabbix versions were multi-language friendly, providing several frontend translations, it was not a truly global thing - the most popular encoding, Unicode, was not fully supported. Zabbix 1.8 now fully supports Unicode/UTF-8, allowing for a true localised or multilanguage setup. 2.3. Improved time period navigation In Zabbix, single control is used to select time period displayed for many views, including simple and custom graphs, raw data, screens and web monitoring. Already improved in 1.6, time period selector has been improved in 1.8 further.

This scrollbar allows easy dragging and resizing of it. Additionally, links on the left hand side allow to choose some predefined, often used time periods and move displayed period forward/backward in time. And the dates on the right hand side actually work as links, popping up a calendar and allowing to set specific start/end time.

Notice the dynamic/fixed link in the lower right hand corner? It can be used to control whether time period is kept constant when you change start/end time. In addition to the screenshots you can also view the video [http://blip.tv/file/2950510] of using graph time period controls. 2.4. Improved graphs

2 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

Zabbix graphs have been improved in many ways. This includes both visual and functional improvements, like the time period selector already mentioned. For example, information about max/min/avg values is presented clearly as a table.

2.4.1. Improved timeline in charts Zabbix graphs - or charts - usually display time on x axis. And even this representation has been improved in the new version. Comparing 1.6 and 1.8:

Axis labels in 1.6.

Axis labels in trunk.

As can be seen, labels are now easier to read. Instead of prioritising some arbitrary point in time, depending on graph scale, actual points in time like change of a day are prioritised. Sometimes Zabbix will even use more “human readable” labels:

2.4.2. Gradient line support in graphs Zabbix graphs support several line styles, and 1.8 brings one more - gradient line. It's easier to understand how that works by looking at an actual example.

2.4.3. DejaVu font used for graphs DejaVu [http://dejavu-fonts.org] font is now used for graphs for nice looking text - and for Unicode capabilities. 2.5. Improved map editing Zabbix supports network maps where monitored environment can be laid out on a background image to provide user friendly overview. In previous versions, editing such network maps was not easy - coordinates of each element on the map had to be specified manually.

3 de 143

23/02/10 12:25

they are folded into host configuration section. You can even watch a video [http://blip. Background map CC-BY-SA Openstreetmap [http://www. Changed configuration layout Zabbix web frontend provides convenient way to display and visualise received data. a frontend to create triggers visually has been added.1. 2. On the other hand.8/compl. bandwidth data.8 has been greatly improved by adding drag and drop support. and complex expressions can be used for each trigger to define what is considered a problem.. Visual trigger editing frontend Usage thresholds and any other problem conditions are freely configurable by user. as well as configure all aspects of monitoring. triggers and so on. as well as selected element detail displaying in a popup.openstreetmap. host group configuration has been brought out on the configuration menu. 4 de 143 23/02/10 12:25 . Map editing in Zabbix 1.tv/file/2942525] of map editing.6.com/documentation/1.zabbix.8. Another change is general configuration being moved to administration section to avoid Zabbix administrator level users from having access to global configuration parameters. Layout of this configuration has been redone in 1. for example. These definitions are called triggers. graphs. where convenient linking allows for easy access to all of these entities and more. In addition to ability to edit trigger expressions directly. In addition to that map links may have optional text for displaying arbitrary information. Instead of separate sections for items.8:complete http://www. 2..org/].7.

Previous versions offered ways to filter this information. 2. 2. 2. and in Zabbix 1. 2. You can watch a video [http://blip. thus it is displaying quite a lot of information.2.4. this screen gained has been changed. (screenshot) 2. In version 1. Other filters improved Filters in other sections of the frontend have been improved as well. but making any significant changes was nearly impossible in some cases.com/documentation/1. Zabbix frontend records all operations in an audit log.9. It is now possible to filter this screen by freeform search against item descriptions.8/compl. but sometimes you need the real data..5.8. raw data and many others. (screenshot) After performing initial filtering. It also incorporates ability to provide test data and try out trigger behaviour.8. This includes: Drag and drop support. Latest data section in Zabbix frontend allows to see exact values for all monitored metrics.8. In 1.8. subfilter becomes available.. allowing to get to the data easier and more quickly. Improved screen editing Zabbix screens is a feature that allows to group many frontend elements. 5 de 143 23/02/10 12:25 .3. Dragging an element to empty cell will move it there. providing new features like expanding individual triggers to show their events and confirming all events for a trigger. As Zabbix frontend provides means to access all the information.8. and 1. including graphs. Items filter Item configuration section is the one where all aspects regarding data gathering are configured. and it was possible to display recent events for all the problems. limited by day count. Screen editing has been greatly improved in 1. New and improved filters http://www.1.8. Being able to quickly find desired data gathering entries is crucial to efficient configuration. dragging an element on occupied cell will switch these elements.8 improves situation in this regard by adding new filters and making existing ones more powerful.ogg video). It presents found values and results can be filtered further.8:complete There is a special mode for creating log related triggers. it can be a daunting task to find the desired one. Audit filter Accountability is important on any system with more than one user (and on many systems with single user as well). Configuring them initially was not very hard.8 audit logs now can be filtered quite extensively to find exactly the changes you are looking for.8. Latest data filter Looking at shiny graphs is tempting. Reworked "Status of triggers" view Trigger view is widely used to display list of current problems.tv/file/2941499] of this feature (site also allows to download original . network maps. rows now can be inserted and removed from arbitrary locations. 2.1.zabbix. Using icons on the screen edges. 2.8.8 there's an improved filter for items that allows for much more detailed searching.

2. host groups and templates. Selected rows are highlighted now Most of the entries in these lists can be selected for performing some operation on them.8 has many minor improvements and features that should make working more productive and pleasant. Templates can be linked to monitored hosts and they determine what and how is monitored. and that slows down frontend considerably. 2. 2.com/documentation/1.8/compl. A minor but welcome improvement in 1. Zabbix 1.for example. 2. Clicking the icon opens the popup to allow copying of the message. it is possible to edit SNMP parameters like community string.7. Minor frontend improvements For a GUI minor visual change can bring large benefits to the user. More flexible linked items Zabbix supports very powerful templating that makes large scale configuration management easy. Zabbix 1. or allowed hosts for trapper items.6. Global search There's now a search box in the upper right corner. Results allow for a quick access to found entities and their elements: 2.11.1. History strings saved by reference At the top of the frontend.11. in previous versions existing history entries would not switch language.4.3. in items that are linked in from templates. When a language is switched in frontend. Downstream linked items in Zabbix 1..8 .11.8 supports splitting long lists in multiple pages. Cleaner error displaying Error messages are now shown as icons and error text is available in a popup.8:complete http://www. items or triggers. which allows searching in hosts.whether it's a list of hosts. Paging for entity lists added Many locations of Zabbix frontend present information as lists .11.. showing recently accessed pages.11. 2.11. Configuring rows per page in user profile Entry limit in action 2.11.selected rows now are hilighted. 2.5.10. IP address becomes default option 6 de 143 23/02/10 12:25 .2. only new entries would be added in the correct language.zabbix. Entry count per page is configurable in user's profile. Now history strings change appropriately. It is also used in page title. These lists can get quite long on large installations of Zabbix.11. there's a breadcrumbs type history. Ability to display server name Setting variable ZBX_SERVER_NAME allows Zabbix server name to be displayed in the frontend upper right corner.8 are more flexible now . 2.1.

4. 4. Mostly useful for developers. While API itself might not be that exciting for casual users. 1. available in previous versions. A special internal check has been introduced.2.zabbix. as well as new methods to automate adding of new devices to monitor.11. 4.Zabbix commandline utility or Zabcon [http://www. It already allows to perform most of the configuration changes. Much more efficient polling Hundreds of pollers can be executed for greater parallelism and performance. 4.1. 3. and in Zabbix 1. all PNG images have been recompressed for optimal size.9. it enables creation of various tools. 4. as it allows easy scripting without programming skills.*] to monitor health of this cache.1.2. Debug mode can be enabled on user group basis.2. Configuration option StartDBSyncers has been removed from Zabbix server and proxy configuration files.com/wiki/doc/zabcon]..1. Note: API is currently considered to be in a technical preview state and can change in next versions. API In version 1. but can be handy when trying to determine source of a problem for others as well.8 index resolving and data retrieval is performed in a single connection now.8/manual/auto-discovery].com/documentation/1. Zabbix 1. 2. With the conversion to online documentation that again is possible.3. 4. Network discovery improvements Network discovery [http://www.8.1. 4. load on the monitoring server hardware can become a serious issue. Zabbix server has been improved greatly to allow gathering more data on the same hardware.1. reducing network load and load on the monitored devices. Increased Zabbix server and proxy performance Doing the main work behind the scenes. Debug mode added for frontend http://www.1. Automated host management improvements For larger or constantly changing environments replicating these changes in Zabbix configuration can be a challenge.1. 4.zabbix. Help icons lead to online manual Oldtime Zabbix users might remember the days when help icons from Zabbix frontend linked to the online manual. Added configuration data cache module Database cache is enabled by default and can not be disabled.1. it has benefited from these changes as well. and 1. thus enabling powerful means for automated or complex setup management.1. 2. Improvements for larger installations Zabbix is being used in larger and larger environments every day.1. Zabcon is especially exciting for users who would like to perform uncommon. large scale changes.. zabbix[wcache. 4. Zabbix provides JSON-RPC [http://json-rpc. One such tool already has been created .8 now brings both improvements to the network discovery.org/] API. The pollers do not communicate directly with the database and use very little of server CPU and memory resources. 7 de 143 23/02/10 12:25 . and surely users will come up with innovative and impressing uses for this tool.8/compl.8 first.com/documentation/1. Items with SNMP dynamic index use one connection Zabbix supports monitoring SNMP metrics that have dynamic identifiers.2.zabbix. Frontend images recompressed with pngcrush To reduce amount of data that users have to retrieve from webserver when using Zabbix frontend. Zabbix already supported network discovery.8 brings many different improvements to the performance in several key areas.11. has received multiple improvements. As Zabbix proxy shares some code with the server.8:complete In host creation form. Zabbix management from servers without GUI installed also is expected to be possible. IP address is now the default choice.1.8 release introduces several changes that are specifically useful in average and above setups.1. Performance improvements When monitoring hundreds and thousands of devices.8 most of these icons open Zabbix manual in a new browser window or tab. In version 1.

8 has been improved. Host maintenance Host and host group maintenance has been added to Zabbix. templated trigger expression would be: {ca_001:system.1. New action operations Based on discovery events. defining the following macros on a host level allows to set custom thresholds per host.0/24.8:complete http://www. SNMPv3 support Network discovery in Zabbix 1. 4.1. Auto registration for active agents Completely new in Zabbix 1. Various 5.zabbix. Starting with 1.1..2. for example system.5.1. 4. it is possible to allow active Zabbix agent auto-registration.8/compl. it would be discovered as multiple hosts in Zabbix versions before 1.1.cpu. 4. These can be defined globally for Zabbix installation..8.2.1.zabbix.avg1].3.min({$CPULOAD_PERIOD})}>{$MAX_CPULOAD} 5. after which server can start monitoring them. 4. The feature might be very handy for automatic monitoring of new Cloud nodes.2. template and host level macros Support for user definable macros [http://www. and instead of simply seeing that something has changed.8.2. for example.2.4. on template and host level.168. Support for multihomed devices If a host provides some service on multiple IP addresses. Audit log in 1.com/documentation/1. Port interval support For services where it's appropriate. 4. Hosts that are in maintenance are indicated as such in Monitoring → Triggers view. 8 de 143 23/02/10 12:25 . even if all hosts are linked against single template: In this case. 192.8/manual/config/macros#global_and_host_level_macros] (or variables) has been added.com/documentation/1.load[. For example.8 supports SNMPv3 with all the corresponding functionality.3. thus increasing available operation count for network discovery to 10. it is possible to use different uniqueness criteria for some services. IP mask support Industry standard network mask notation can now be used in network discovery. As soon as you have a new node in the Cloud Zabbix will automatically start collection of performance and availability data of the host.1. Improved audit log Zabbix provides accontability by recording all user logins and changes to the Zabbix configuration in the audit log.2.8. port interval support has been added. 4.2. This allows to add new hosts for monitoring without any manual server configuration for each individual host. Support for global. 5. many entities will have exact changes recorded. notification is generated after maintenance period ends.2.1. Enable host Disable host 4. two new operations have been added. If a problem happens during the maintenance and is not resolved.uname returned by Zabbix agent or any OID returned by SNMP capable host.2.1.

zabbix.STATUS} {EVENT.9]} {HOST.2. 5.CONN[1.03 and last release with security fixes in 2008. but for somebody one of these might be the biggest change in Zabbix 1.9]} {TRIGGER.2..DNS[1. It is now possible to define complex regular expression with easy to use interface and reuse them with simple reference. 6.01. IPv6 support for SNMP monitoring In addition to the SNMP related improvements for network discovery.08.UNACK} 5.3.called macros .NAME[1.3.8:complete http://www.2. 5.1. 6.9]} {EVENT. as well as making some macros usable in more locations.ACK.to be used in item names. Advanced regular expression editor Advanced regular expression editor was added to Zabbix with ability to test regular expressions.0 was out for some time to require support of Zabbix frontend. 6. Support for PHP 5..LASTVALUE[1.9]} {HOST. In notifications Along with existing macros new ones can be used in notifications that are sent out. CPU switches support on Linux Key system.HISTORY} {TRIGGER.LOG.*[1. Support for PHP 4 dropped Last bugfix release in 2008. Zabbix 1. Minor improvements We call these minor. PHP 5. It can be configured per scenario.9]} {ITEM.9]} {PROFILE.1. 6.. Added Windows services key 9 de 143 23/02/10 12:25 .EVENTS. 5. {NODE.UNACK} 5.30.4. 5. 5.9]} {IPADDRESS[1.dns.8.1. 6.. IPv6 support has been implemented for SNMP monitoring.. New macros Zabbix provides very useful variables .1..1..9]} {HOSTNAME[1.3.. Since the last stable Zabbix release there have been major changes in PHP versions.1.VALUE[1.9]} {ITEM.06.1.8 requires PHP 5. icmppingloss net. built-in checks require less resources and are easier to use...KEY[1. Exact changes made to item preserved Exact changes made to trigger preserved 5.VALUE} and {ITEM. Basic authentication support in web monitoring Web monitoring now supports basic HTTP authentication.9]} {ITEM.ACK.5.2..3.6. and Zabbix frontend has been changed accordingly..07.1.*[1. PHP4 was not receiving bugfixes anymore.net]. Zabbix 1.2. New items Several completely new items have appeared. {TRIGGERS.0 or later.6.cpu. New and improved monitored metrics While Zabbix can be extended.2.8 introduces several new checks and improves old ones.6.3 added Released in 2009.tcp.2. Supported PHP version changes Zabbix frontend is based on PHP [http://php. notifications and elsewhere.*[1.8/compl. Zabbix 1. In map labels Map labels allow using handy macros like the current value of some item..8 increases the amount of available macros.switches can be used for Linux hosts.query 6.9]} {ITEM.com/documentation/1.

. are documented.6. 10 de 143 23/02/10 12:25 . timeout . LVM swap devices support LVM devices are now supported as swap devices on Linux. appliances and servers without use of Zabbix Agent. 6. as well as allowed ranges..100] This would send five 128 byte packets to host with IP 10.com/documentation/1. Logfile filtering on agent and server side To avoid storing in the database unneeded logfile entries. Improved sample configuration files Sample configuration file layout was changed.2.packet size in bytes. 6.4. Positive sign for decimal values supported If incoming decimal (float) value is preceded by a + sign.10 with 300 ms interval between them.4.maxlines. that was not easy enough. 6. source and event ID on the agent side or on the server side. they can also be filtered on agent side. Zabbix ICMP items now are much more flexible.2. 6.5.one of min. 6.host IP or DNS name. It makes possible very effective remote monitoring of network devices. and one additional: mode .zabbix. Octal Hexadecimal 6.10.3. 6. 6.10. they can be filtered on server side. 'maxlines' parameter for log items Item keys log and eventlog now have new parameter . it is supported as a positive number now.5. and use 100 ms timeout.number of packets. For fast growing file the number can be increased using the new parameter. Item icmpping has gained the following parameters: target . this functionality will be available in future releases. Now it is possible to use a key like this: icmpping[10.2.6.10.8:complete Added services key for Windows which can return services in a particular state. Now all parameters are included. which is consistent with other operating systems. 6. ICMP items have new parameters http://www.3.2. SSH and telnet checks Now SSH and telnet can be used for direct. By default. interval . 6.5.8/compl. First CPU number changed on Linux First CPU on Linux is now referred to as 0. New input data types While different base values could be monitored before with user parameters.2.300.2.2. 6.8 natively supports two new input data types. Item icmppingsec has gained all the above parameters. max. count . Zabbix 1. and their default values. avg. New Windows eventlog filters Windows eventlog entries now can be filtered by type.10. SSH supports both password and key authentication methods.7. agent-less monitoring. Default mode is avg.1.2. Zabbix agent does not send more than 100 log lines per second per log file. Client utilities moved to bin Zabbix client utilities zabbix_get and zabbix_sender were moved from sbin to bin. Currently SSH and telnet cannot be used in actions. size .8.time between successive packets in milliseconds. To avoid sending over the network unneeded logfile entries. It specifies maximum number of new lines per second the agent will send to Zabbix server or Proxy.timeout in milliseconds. sometimes found on devices like printers.128.10.

Older Zabbix proxies of version 1.8 frontend three different monitoring methods have their status displayed .13.8. Timestamp support for zabbix_sender Support for -T parameter in zabbix_sender has been added.wikipedia. 6. 1. Oracle support is now implemented using native Oracle Call Interface [http://en.3. Version compatibility Older agents from Zabbix 1..0. as it is now possible to specify regular expressions in logfile monitoring. It does not require any configuration changes on agent side. Installation and Upgrade Notes 1. Native support of Oracle Previous version of Zabbix had a dependency on a third party library called sqlora8.x can be used with Zabbix 1.com/documentation/1. The library is not actively developed any more. 6. and version 1.for example. Offline documentation can still be obtained with ODT [http://en.7.wikipedia.8 improves it further. Installation See the installation section for full details.12. Added manpages Manpages for all Zabbix processes have been added. Manual user unblocking Ability to manually unblock users who have been locked out by bruteforce protection was added.2. all critical messages can be delivered by using SMS messaging. 6. 6. Clicking on the Blocked link will unblock this user. Rotated logfile monitoring Zabbix supports logfile monitoring.6. 6.8. 6.14.Zabbix agent. Online documentation Documentation from an inflexible PDF file has been converted to online format where anybody can comment on individual pages. For example.8:complete http://www. while other messages using both email and SMS without creating multiple actions.3.8. Host status propagation from proxies If a host is monitored by a proxy. Detailed availability information displaying Instead of simply displaying generic host status.3.3.org/wiki/Oracle_Call_Interface]. Important notes 11 de 143 23/02/10 12:25 . Zabbix 1.1.3.8/compl.6. which allows to set timestamp for each value. 1.. if logfile name includes date . Before upgrading. while Black&blue theme uses blue colour. read important notes. See upgrading section if upgrading from an older Zabbix release.11. Notification media can be chosen in action operations It means that it's possible to define messages that will be sent to one or several medias only.9. 6.10. Errors related to each method are stored separately and can be obtained by moving mouse cursor over the error icon. Installation and upgrade See the installation section for new installations. SNMP and IPMI. which greatly improves performance and stability of Zabbix setups using Oracle as a back-end database. 6. Zabbix 1. 1.zabbix. in 1.x can't be used with Zabbix 1.4. they should be upgraded.15. status of the host will be correctly displayed and updated in Zabbix front-end.x and Zabbix 1.org/wiki/OpenDocument] export functionality.1.it is much easier to monitor with Zabbix 1. If an application is writing to a new logfile with varying name .8. Default theme uses green to denote availability. The option can be used to migrate older historical data from other monitoring tools to Zabbix database for graphing and long-term analysis. 6.1.x.

httptest_3.3.4.8. CPU index for system. history_log_2..3. 1..8. services drop index services_1. actions drop index actions_1. Known problems PHP mbstring check may fail with PHP < 5.8/compl. Make sure database.6.3.com/documentation/1. XML export includes SNMP and other information for all items.conf. 1. It will help if upgrade procedure fails (lack of disk space.6. Backup existing Zabbix database This is very important step.x to 1.2. Make sure that you have backup of your database.2. dservices_1. Stop Zabbix server Stop Zabbix server to make sure that no new data is inserted into database. To avoid this issue. actions_1. Hostnames with spaces do not work when sending data from a file with zabbix_sender. http://www. Key vfs. new parameters added. 1. 1. 1. Maximal PHP POST size should be at least 16MB (option post_max_size). graphs_items drop index graphs_items_2. Backup configuration files.3.8. You may want to review them.6.example file to zabbix. power off.size returns data in bytes for all operating systems now.cpu. Ignore any warning messages about non-existent indexes! Database upgrade scripts are located in directory upgrades/dbpatches/1.3.6. Upgrade database Before running upgrade scripts drop the following indexes: MySQL alter alter alter alter alter alter alter alter alter alter alter table table table table table table table table table table table dhosts drop index dhosts_1. Review Server configuration parameters Some parameters of zabbix_server.3.util key on Linux now starts with 0. services_1. Sorting in frontend is not performed for entities with positional variables (like item names with $1 etc). Upgrade procedure The following steps have to be performed for successful upgrade from Zabbix 1.fs.3. history_log drop index history_log_2. Maximal PHP memory size should be at least 128MB (option memory_limit). copy zabbix.4.5. 1. httptest drop index httptest_2.6. Configuration option StartDBSyncers has been removed from Zabbix server and proxy configuration files.2 in Zabbix 1. PHP files and Zabbix binaries Make a backup copy of Zabbix binaries.1. System requirement changes Additional or increased system requirements: Support for PHP 4 dropped. configuration files and PHP files. including database access parameters. Oracle or PostgreSQL drop drop drop drop drop drop drop drop drop drop drop index index index index index index index index index index index dhosts_1.5. tables and fields are set to UTF-8 encoding.6. Install new server binaries You may use pre-compiled binaries or compile your own.1.6. graphs_items_1. httptest_2. graphs_items drop index graphs_items_1.8/<db engine>: 12 de 143 23/02/10 12:25 . graphs_items_2.6. 1.3. Key vfs.zabbix.3.conf were changed in 1.8:complete All hosts now are required to belong to at least one group. Comment at the end of a configuration file line is not allowed anymore (this worked for numeric parameters only before).fs. The whole upgrade procedure may take several hours depending on size of Zabbix database. history_text_2. any unexpected problem). dservices drop index dservices_1.3.6. Uploading of images for network maps may fail if database is not configured properly. history_text drop index history_text_2. escalations_2. For IPMI support you need a recent OpenIPMI version .13 and later is known to work.size now takes into account reserved diskspace for root user.0.php and modify parameters. escalations drop index escalations_2.conf. httptest drop index httptest_3.php. 1. 1.

2003.2.8/mysql/patch. 2.sql Oracle: upgrades/dbpatches/1.6.2.2. 2.zabbix. Zabbix is distributed as a source package. Hardware requirements 2.x. UNIX is the only operating system that can consistently deliver the necessary performance. for PostgreSQL it may take several hours or more because of conversion of existing historical data.x to 1.7. Make sure that you have enough permissions (create table. CPU Requirements Zabbix and especially Zabbix database may require significant CPU resources depending on number of monitored parameters and chosen database engine.8. It is highly recommended to run the database on a separate box for large installations. Amount of memory allocated for the connection depends on configuration of the database engine.8/oracle/patch.1.com/documentation/1.1. If you are converting the database to UTF-8.3. you should be thinking of at least a couple of gigabytes to have enough space to store the history in the database. 128 MB of physical memory and 256 MB of free disk space could be a good starting point.1. The more physical memory you have.8/postgresql/patch. 2.2.2.6. drop index).. 1.2. Install new Zabbix GUI Follow installation instructions.sql PostgreSQL: upgrades/dbpatches/1.6.8/compl.2. however it is also included into number of OS distributions pre-compiled.1. 2 Comments 2. XP.1.8 only! For upgrade from earlier versions use also upgrade scripts from Zabbix 1.2. 2. How to Get Zabbix Check the Zabbix Home Page at http://www. If you're planning to keep a long history of monitored parameters.6. drop table. Zabbix is tested on the following platforms: AIX FreeBSD HP-UX Linux Mac OS/X NetBSD OpenBSD SCO Open Server Solaris Windows 2000.. Also make sure that you have enough free disk space.3.4. fault tolerance and resilience. it can take many hours.8:complete MySQL: upgrades/dbpatches/1. Supported Platforms Due to security requirements and mission-critical nature of monitoring server. 1.zabbix.1. Requirements 2.com] for information about the current version and for downloading instructions. It is recommended to test the upgrade procedure in a non-production environment. However. create index. the faster the database (and therefore Zabbix) works! 2. Other hardware A serial communication port and a serial GSM Modem required for using SMS notification support in Zabbix. Vista (only Zabbix agent) 13 de 143 23/02/10 12:25 . Check log files to see if the binaries have started successfully.com [http://www.2. Zabbix operates on market leading versions.1.3. Each Zabbix daemon process requires several connections to a database server. Database upgrade should take around 10-15 minutes.zabbix. Installation 2. Start new Zabbix binaries Start new binaries. These scripts are for upgrade from Zabbix 1. the amount of required disk memory obviously depends on the number of hosts and parameters that are being monitored.1.sql http://www. Memory Requirements Zabbix requires both physical and disk memory. Examples of hardware configuration The table provides several hardware configurations: Name Small Medium Large Platform Ubuntu Linux CPU/Memory PII 350MHz 256MB MySQL MyISAM Database Monitored hosts 20 500 Ubuntu Linux 64 bit AMD Athlon 3200+ 2GB MySQL InnoDB Ubuntu Linux 64 bit Intel Dual Core 6400 Intel Xeon 2xCPU 8GB 4GB RAID10 MySQL InnoDB or PostgreSQL >1000 Fast RAID10 MySQL InnoDB or PostgreSQL >10000 Very large RedHat Enterprise Actual configuration depends on number of active items and refresh rates very much.

Oracle. Required if SQLite is used as Zabbix back-end database.5 or later 3. MySQL.3. integers.8:complete Zabbix may work on other Unix-like operating systems as well.3. The following software is required to run Zabbix: Software Apache PHP PHP modules: php-gd PHP bc support PHP XML support PHP socket support MySQL php-mysql Oracle php-oci8 PostgreSQL php-pgsql SQLite php-sqlite3 7. Required for user script support. –enable-bcmath php-xml. Server requirements Requirement OpenIPMI libssh2 Description Required for IPMI support Required for SSH support. it means that 130M of values will require 130M * 50 bytes = 6. Consider using PostgreSQL 8. type of received values (floats.2. we may assume that Zabbix generates one event per second.8/compl. Normally 10MB or less. if we would like to keep 30 days of history and we receive 50 values per second. 3000 values will require (3000/1800)*(24*3600*365)* 128 = 6.5.0. Each new value required certain amount of disk space for data and index.zabbix. 14 de 143 23/02/10 12:25 .0 or higher. which define amount of stored historical data: Number of processed values per second This is average number of new values Zabbix server receives every second. Zabbix database size mainly depends on these variables. and the PHP scripting language. Cookies and Java Script must be enabled. Depending on used database engine. It is hard number of events generated by Zabbix daily.0 or later GD 2. For example. 2. number of values per seconds is calculated as 3000/60 = 50.x or later for much better performance.2.4. –enable-sockets. 2.5GB of disk space.12 or later 5. or about 130M of values..3GB per year. Required if PostgreSQL is used as Zabbix back-end database. Latest versions of Mozilla Firefox. or 31. if we have 3000 items for monitoring with refresh rate of 60 seconds.com/documentation/1. depending on database type. It means that 50 new values are added to Zabbix database every second. Choice of database engine ZABBIX Server and Proxy support four database engines: MySQL Oracle PostgreSQL SQLite 2. Software Requirements Zabbix is built around modern Apache WEB server. Normally it is around 50 bytes per value. php-bcmath. Opera and Konqueror are supported. leading database engines.22 or later Version 1. So.2.2 or later 3.6. It means that if we want to keep 3 years of events. Other browsers (Google Chrome.1. Comments Zabbix may work on previous versions of Apache. log files. total number of values will be around (30*24*3600)* 50 = 129. normally several weeks or months. Apple Safari) may work with Zabbix as well. 2. http://www. Housekeeper settings for events Each Zabbix event requires approximately 130 bytes of disk space.000.3. this would require 3*365*24*3600* 130 = 11GB The table contains formulas that can be used to calculate disk space required for Zabbix system: Parameter Formula for required disk space (in bytes) Zabbix configuration Fixed size. In worst case scenario.2. etc). Version 1. The data is used for trending and long period graphs.2. disk space for keeping a single value may vary from 40 bytes to hundreds of bytes.5GB for 5 years. Required if Oracle is used as Zabbix back-end database. Zabbix database.1. Microsoft Internet Explorer. Housekeeper settings for history Zabbix keeps values for a fixed period of time.3. In our case.0 or later PHP GD module must support PNG images. Suppose we would like to keep trend data for 5 years.600. WEB browser on client side Support for HTML and PNG images is required. Housekeeper setting for trends Zabbix keeps 1 hour max/min/avg/count statistics for each item in table trends. requires about 128 bytes per each total. if provided as a separate package by the distributor php-net-socket. and PostgreSQL as well. Database size Zabbix configuration data requires fixed amount of disk space and does not grow much.. Required if MySQL is used as Zabbix back end database. strings. 2.

Zabbix Agent In order to actively monitor local resources and applications (such as harddrives. 15 de 143 23/02/10 12:25 . days : number of days to keep history bytes : number of bytes required to keep single trend. Software requirements Building of Zabbix server or agents from sources requires additional software. The Zabbix Agents are extremely efficient because of use of native system calls for gathering statistical information. the Web-based Interface is provided. Zabbix Proxies can also be used to distribute load of a single Zabbix Server.3. processor statistics etc. branches. Zabbix Server This is the centre of the Zabbix software. and report these data to the Zabbix for further processing. Oracle Headers and Libraries Sqlora8 headers and libraries are required. History days*(items/refresh rate)*24*3600*bytes items : number of items days : number of days to keep history refresh rate : average refresh rate of items bytes : number of bytes required to keep single value. or a crashed service process).4.1. In case of failures (such as a harddisk running full. In this case. normally 128 bytes. the Zabbix Server can actively alert the administrators of the particular machine that reported the failure.) on networked systems. those systems must run the Zabbix Agent.3.22 or later required. days*events*24*3600*bytes events : number of event per second. 2.4. Components 2. but this also depends on a total number of child nodes linked to a node. statistical and operational data are stored. Disk space requirements for nodes in distributed setup are calculated in a similar way.8:complete http://www. The following software is required to compile Zabbix: One of the following database engines: MySQL Headers and Libraries Version 3. The Agent will gather operational information from the system on which it is running. The Interface is a part of the Zabbix Server. The Server can remotely check networked services (such as web servers and mail servers) using simple service checks.org/] the most popular daemon that synchronizes the host's time with the time of other machines. All collected data is buffered locally and transferred to Zabbix Server the Proxy belongs to. Database size will grow then it will stop growing at some point. The WEB Interface In order to allow easy access to the monitoring data and then configuration of Zabbix from anywhere and from any platform.com/documentation/1.7. Zabbix Components Zabbix consists of several major software components. and is usually (but not necessarily) run on the same physical machine as the one running the Zabbix Server.zabbix. ntpd [http://www. only Proxies collect data thus making processing on the Server less CPU and disk I/O hungry. which depends on hosekeeper settings.1. The Server is the central repository in which all configuration. depends on database engine. the total required disk space can be calculated as: Configuration + History + Trends + Events The disk space will NOT be used immediately after Zabbix installation. memory. Zabbix can also perform agent-less monitoring and also monitor network devices using SNMP agents.. Time synchronisation It is very important to have precise system date on server with Zabbix running. days*(items/1800)*24*3600*bytes items : number of items days : number of days to keep history bytes : number of bytes required to keep single trend. Zabbix front-end must run on the same physical machine if SQLite is used. 2..1.3.3. normally 50 bytes. Zabbix Proxy is an ideal solution for a centralized monitoring of remote locations.3.3. 2. 2.2. One (1) event per second in worst case scenario.2. the responsibilities of which are outlined below. Installation from Source 2. The Proxy collects performance and availability data on behalf of Zabbix Server.8/compl. and it is the entity in the Zabbix software that will actively alert administrators when problems arise in any of the monitored systems.ntp. depends on database engine. depends on database engine. 2. 2. 2.3. normally 130 bytes. Trends Events So. networks having no local administrators. Zabbix Proxy The Proxy is an optional part of Zabbix deployment.4. but it is also the central component to which the Agents will report availability and integrity information and statistics.5.

2. include The directory contains include Zabbix files. create The directory contains SQL script for initial database creation. Other (HP.1. Libcurl library and header files Version 7. Iksemel library and header files Required to enable Jabber messaging. SQLite Headers and Libraries Version 3. src/zabbix_get The directory contains Makefile and sources for zabbix_get.3.com/documentation/1..5 or later required. create/data Data for initial database creation.4. src/zabbix_agent The directory contains Makefile and sources for zabbix_agent and zabbix_agentd. Optional.d The directory contains start-up scripts for different platforms. Running Zabbix as 16 de 143 23/02/10 12:25 . Optional. upgrades The directory contains upgrade procedures for different versions of Zabbix.3. src/zabbix_server The directory contains Makefile and sources for zabbix_server.2 or later required.8/compl..13.4. NET-SNMP (or UCD-SNMP) library and header files Required for SNMP support. sqlite3-dev packages. Consider using PostgreSQL 8. GNU C compiler is the best choice for open platforms. Structure of Zabbix distribution docs The directory contains this Manual in PDF format src The directory contains sources for all Zabbix processes except frontends. create/schema Database creation schemas. misc misc/init.0. For production use you should create a dedicated unprivileged account ('zabbix' is commonly used). Usually provided as part of mysql-dev.8:complete PostgreSQL Headers and Libraries http://www. frontends frontends/php The directory contains files of PHP frontend.1 or higher required for WEB monitoring module.zabbix. src/zabbix_sender The directory contains Makefile and sources for zabbix_sender. Optional. Version 7. GNU Make GNU make is required to process Zabbix Makefiles. IBM) C compilers may be used as well. 2. 2. Zabbix Server Server side Step 1 Create the Zabbix superuser account This is the user the server will run as.x for much better performance. C Compiler C compiler is required. postgresql-dev.

8:complete 'root'. If you plan to distribute compiled binaries among different servers.8/compl./data shell> cat data.tar http://www.db cd .sql | sqlite3 /var/lib/sqlite/zabbix. or any other account with special rights is a security risk. both –with-net-snmp and –with-ucd-snmp may be skipped. Step 2 Untar Zabbix sources shell> gunzip zabbix-1. Oracle.db The database will be automatically created if it does not exist. Do not do it! Zabbix server process (zabbix_server) is protected from being run under root account.'bin'.sql | psql -U <username> zabbix shell> cd .sql | mysql -u<username> -p<password> zabbix cat images_mysql./data cat data. Step 5 Make and install everything shell> make install By default. psql> \q shell> cd create/schema shell> cat postgresql.. run: shell> .sql sqlplus> @data/images_oracle. The libary is required for Oracle support.8. For MySQL: shell> mysql> mysql> shell> shell> shell> shell> shell> mysql -u<username> -p<password> create database zabbix character set utf8. –enable-static does not work under Solaris.db cat images_sqlite3. you must use this flag to make these binaries work without required libraries.sql sqlplus> @data/data. If no SNMP support required.1./configure --enable-server --with-pgsql --with-net-snmp --with-jabber --with-libcurl # for PostgreSQL + Jabber + WEB monitoring or shell> .com/documentation/1..tar. Step 3 Create the Zabbix database Zabbix comes with SQL scripts used to create the required database schema and also to insert a default configuration.sql | mysql -u<username> -p<password> zabbix For Oracle (we assume that user zabbix with password password exists and has permissions to create database objects): shell> cd create shell> sqlplus zabbix/password sqlplus> set def off sqlplus> @schema/oracle. you must specify which database will be used. cd create/schema cat mysql. shell> ./configure --enable-server --enable-agent --with-mysql --with-net-snmp --with-jabber --with-libcurl Parameter –enable-static may be used to force static linkage.8.sql | sqlite3 /var/lib/sqlite/zabbix.sql | mysql -u<username> -p<password> zabbix cd ..sql | psql -U <username> zabbix For SQLite: shell> shell> shell> shell> shell> cd create/schema cat sqlite../configure --enable-server --with-mysql --with-net-snmp --with-jabber --with-libcurl # for MySQL + Jabber + WEB monitoring or shell> .gz && tar -xvf zabbix-1. make install 17 de 143 23/02/10 12:25 . if you want to compile client binaries along with server binaries. The library can be found at libsqlora8 homepage Use flag –enable-static to statically link libraries. quit.sql sqlplus> exit For PostgreSQL: shell> psql -U <username> psql> create database zabbix. To configure the source for the server. There are separate scripts for MySQL..zabbix.sql | sqlite3 /var/lib/sqlite/zabbix. Flag –with-ucd-snmp can be used instead of –with-net-snmp. PostgreSQL and SQLite./data cat data. Step 4 Configure and compile the source code for your system The sources must be compiled for both the server (monitoring machine) as well as the clients (monitored machines). However./configure --enable-server --with-oracle=/home/zabbix/sqlora8 --with-net-snmp --with-jabber --with-libcurl # for Oracle + Jabber + WEB monitoring Use flag –with-oracle to specify location of sqlora8 library.sql | psql -U <username> zabbix shell> cat images_pgsql.

You can specify an installation prefix other than /usr/local using –prefix.tar 18 de 143 23/02/10 12:25 . It is not required to run the process.conf If you plan to use zabbix_agent instead of the recommended zabbix_agentd.3600 zabbix /opt/zabbix/bin/zabbix_agent Restart inetd shell> killall -HUP inetd Modify default settings in configuration files Step 8 Configure /etc/zabbix/zabbix_agent.zabbix.4.8:complete http://www. while utilities under <prefix>/bin.. The file should contain the IP address of the Zabbix server.conf as example. will install all the files in /usr/local/bin./zabbix_agentd 2. However.8/compl. Step 1 Create the Zabbix superuser account This is the user the Proxy will run as.8. /usr/local/lib etc.conf For small installations (up to ten monitored hosts). Do not do it! Zabbix Proxy process (zabbix_proxy) is protected from being run under root account.conf as example.1. Connections from other hosts will be denied. You may take misc/conf/zabbix_agentd. or any other account with special rights is a security risk.4. it is recommended.8. Make sure that you have enough permissions. Step 2 Untar Zabbix sources shell> gunzip zabbix-1. Step 10 Configure /etc/zabbix/zabbix_server. You may take misc/conf/zabbix_agent. shell> cd bin shell> .tar.conf You need to configure this file for every host having zabbix_agent installed. default parameters are sufficient. You may take misc/conf/zabbix_server. Step 11 Run server processes Run zabbix_server on server side. Zabbix Proxy Zabbix Proxy is a special process. The file should contain IP address of Zabbix server. Step 7 Configure /etc/inetd.. For production use you should create a dedicated unprivileged account ('zabbix' is commonly used). Step 6 Configure /etc/services The step is optional. In this case daemon binaries will be installed under <prefix>/sbin.gz && tar -xvf zabbix-1. add the following lines to /etc/services: zabbix-agent zabbix-agent zabbix-trapper zabbix-trapper 10050/tcp 10050/udp 10051/tcp 10051/udp Zabbix Zabbix Zabbix Zabbix Agent Agent Trapper Trapper Note that the port numbers are offical Zabbix ports registered in IANA.conf You need to configure this file for every host with zabbix_agentd installed.com/documentation/1.'bin'. However. On the client (monitored) machines. Connections from other hosts will be denied./zabbix_server Step 12 Run agents Run zabbix_agentd where necessary. the following line must be added: zabbix_agent stream tcp nowait.conf as example. Man pages will be installed under <prefix>/share. Step 9 Configure /etc/zabbix/zabbix_agentd. See section [Performance tuning] for more details. you should change default parameters to maximize performance of Zabbix. shell> cd sbin shell> . Running Zabbix Proxy as 'root'. for example –prefix=/home/zabbix.

There are separate scripts for MySQL. However. the following line must be added: 19 de 143 23/02/10 12:25 . If you plan to distribute compiled binaries among different hosts. Step 3 Create the Zabbix database. The libary is required for Oracle support. Optional. For MySQL: shell> mysql> mysql> shell> shell> mysql -u<username> -p<password> create database zabbix character set utf8../configure --enable-proxy --with-pgsql --with-net-snmp –with-libcurl # for PostgreSQL + WEB monitoring or shell> .. Zabbix Proxy process will create database automatically on the first run if it does not exist.8:complete http://www.8/compl.zabbix.sql | psql -U <username> zabbix For SQLite: shell> cd create/schema shell> cat sqlite./configure --enable-proxy --enable-agent --with-mysql –with-net-snmp –with-libcurl Parameter —enable-static may be used to force static linkage.log for any error messages.sql | sqlite3 /var/lib/sqlite/zabbix. To configure the source for the Proxy./configure --enable-proxy --with-oracle=/home/zabbix/sqlora8 --with-net-snmp –with-libcurl # for Oracle + WEB monitoring Use flag –with-oracle to specify location of sqlora8 library.com/documentation/1. shell> . –enable-static does not work under Solaris.sql | sqlplus zabbix/password >out. /usr/local/lib etc. Step 5 Make and install everything shell> make install By default. Step 4 Configure and compile the source code for your system The sources must be compiled to enable compilation of Zabbix Proxy process. It will use existing database otherwise. make install will install all the files in /usr/local/bin.conf If you plan to use zabbix_agent instead of the recommended zabbix_agentd. However. The library can be found at libsqlora8 homepage./configure --enable-proxy --with-mysql --with-net-snmp –with-libcurl # for MySQL + WEB monitoring or shell> .sql | mysql -u<username> -p<password> zabbix For Oracle (we assume that user ‘zabbix’ with password ‘password’ exists and has permissions to create database objects): shell> cd create/schema shell> cat oracle. You can specify an installation prefix other than /usr/local using –prefix Step 6 Configure /etc/services The step is optional. Flag –with-ucd-snmp can be used instead of –with-net-snmp. Zabbix comes with SQL scripts used to create the required database schema. quit. psql> \q shell> cd create/schema shell> cat postgresql. both –with-net-snmp and –with-ucd-snmp may be skipped. run: shell> .log Check file out. Use flag –enable-static to statically link libraries. If no SNMP support required. For PostgreSQL: shell> psql -U <username> psql> create database zabbix. it is recommended. if you want to compile client binaries along with proxy binaries. add the following lines to /etc/services: zabbix_agent 10050/tcp zabbix_trap 10051/tcp Step 7 Configure /etc/inetd.1. Database auto-creation is supported for SQLite only. you must specify which database will be used. you must use this flag to make these binaries work without required libraries.db The database will be automatically created if it does not exist. cd create/schema cat mysql. PostgreSQL and SQLite. Oracle. On the client (monitored) machines.

For production use you should create a dedicated unprivileged account (“zabbix” is commonly used).8:complete http://www.gz && tar xvf zabbix-1.6. Zabbix agents have protection against running under root account..5.8/compl. Zabbix Agent Client side Step 1 Create the Zabbix account This is the user the agent will run as.. To configure the source for the client: shell> .3600 zabbix /opt/zabbix/bin/zabbix_agent Restart inetd shell> killall -HUP inetd Step 7 Configure /etc/zabbix/zabbix_agent.conf For small installations (up to ten monitored hosts).zabbix. Make sure you have correct Hostname and Server parameters set.6.conf If you plan to use zabbix_agent instead of the recommended zabbix_agentd. you should change default parameters to maximize performance of Zabbix Proxy. you must use this flag to make these binaries work without required libraries./configure --enable-agent Use flag –enable-static to statically link libraries. On the client (monitored) machines. If you plan to distribute compiled binaries among different hosts.tar Step 3 Configure and compile the source code for your system The sources must be compiled for the client only. However. Other common directories are /usr/local/bin or /usr/local/zabbix/bin. Connections from other hosts will be denied. Step 4 Build agent shell> make Copy created binaries from bin/ to /opt/zabbix/bin or any other directory. The file should contain IP address of Zabbix server.3600 zabbix /opt/zabbix/bin/zabbix_agent Restart inetd shell> killall -HUP inetd Modify default settings in configuration files Step 8 Configure /etc/zabbix/zabbix_proxy. 20 de 143 23/02/10 12:25 ./zabbix_proxy 2.4.1. add the following lines to /etc/services: zabbix_agent 10050/tcp zabbix_trap 10051/tcp Step 6 Configure /etc/inetd. Step 9 Run Proxy processes Run zabbix_proxy: shell> cd sbin shell> .conf You need to configure this file for every host having zabbix_agent installed. Step 2 Untar Zabbix sources shell> gunzip zabbix-1. it is recommended. You may take misc/conf/zabbix_proxy. Note. However. that no end of line character should present in the file.com/documentation/1. Step 5 Configure /etc/services The step is not real requirement.tar. zabbix_agent stream tcp nowait. the following line must be added: zabbix_agent stream tcp nowait. default parameters are sufficient.conf as example.

1.8:complete
You may take misc/conf/zabbix_agent.conf as example. Step 8 Configure /etc/zabbix/zabbix_agentd.conf

http://www.zabbix.com/documentation/1.8/compl...

You need to configure this file for every host with zabbix_agentd installed. The file should contain IP address of Zabbix server. Connections from other hosts will be denied. You may take misc/conf/zabbix_agentd.conf as example. Step 9 Run zabbix_agentd on all monitored machines
shell> /opt/zabbix/bin/zabbix_agentd

You should not run zabbix_agentd if you have chosen to use zabbix_agent! Make sure that your system allows allocation of 2MB of shared memory, otherwise the agent may not start and you will see “Can't allocate shared memory for collector.” in agent's log file. This may happen on Solaris 8.

2.4.6. Zabbix WEB Interface
Step 1 Point your browser to Zabbix URL.

Step 2 Read and accept GPL v2.

21 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

Step 3 Make sure that all software pre-requisites are met.

Pre-requisite PHP version PHP Memory limit PHP post max size 5.0 8MB 8MB

Minimum value

Description

In php.ini: memory_limit = 128M In php.ini: post_max_size = 8M In php.ini: max_execution_time = 300 One of the following modules must be installed: php-mysql, php-sqlora8, php-pgsql, php-sqlite3 Compiled in PHP5. Module php-gd. Module php-gd.

PHP max execution time 300 seconds PHP database support PHP BC math GD Version Image formats One of: MySQL, Oracle, PostgreSQL, SQLite Any 2.0 or higher At least PNG

Step 4 Configure database settings. Zabbix database must already be created.

22 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

Step 5 Enter Zabbix Server details.

Step 6 See summary of settings.

23 de 143

23/02/10 12:25

Step 7 Download configuration file and place it under conf/.com/documentation/1..8/compl.1. 24 de 143 23/02/10 12:25 ..8:complete http://www.zabbix.

com/documentation/1./zabbix_server –n 1 This will convert database data for use with Node ID '1' and also adds a local node. Step 9 For distributed monitoring only! If used in a distributed environment you have to run: shell> .8/compl. password zabbix. 25 de 143 23/02/10 12:25 .1. Step 8 Finishing installation. Step 10 Zabbix frontend is ready! Default user name is Admin./zabbix_server –n <nodeid> where Node ID is an unique Node identificator..zabbix.8:complete http://www.. For example: shell> .

Known problems PHP mbstring check may fail with PHP < 5. Uploading of images for network maps may fail if database is not configured properly.x.5.php and modify parameters.1. Key vfs. Zabbix 1.5. Comment at the end of a configuration file line is not allowed anymore (this worked for numeric parameters only before). 2. Older Zabbix proxies of version 1.fs. Stable branch releases For stable branch release upgrades (upgrading 1.5.6.0. Maximal PHP memory size should be at least 128MB (option memory_limit)..2 in Zabbix 1. 2.fs.5.2.6.5. Hostnames with spaces do not work when sending data from a file with zabbix_sender.8.zabbix.8:complete http://www.1.conf.5. including database access parameters. For IPMI support you need a recent OpenIPMI version . copy zabbix. Key vfs. Upgrading 2. optional indexes may be added to the database to improve performance.4 to 1.8/compl. 2.1.cpu. XML export includes SNMP and other information for all items..13 and later is known to work.3. Maximal PHP POST size should be at least 16MB (option post_max_size).8. Sorting in frontend is not performed for entities with positional variables (like item names with $1 etc).8.conf. they should be upgraded.3 can be performed in single step.5. If mentioned in release notes.8. System requirement changes Additional or increased system requirements: Support for PHP 4 dropped.com/documentation/1.4.5. Make sure database. CPU index for system.example file to zabbix.8.8) in addition to binary and frontend upgrade database patch is usually required.7. tables and fields are set to UTF-8 encoding.size returns data in bytes for all operating systems now. 2.x and Zabbix 1.2. The whole upgrade procedure may take several hours depending on size of Zabbix database. It does not require any configuration changes on agent side.x to 1.x can be used with Zabbix 1.x can't be used with Zabbix 1. 2.8.6. Upgrading can be easily performed over several versions. 26 de 143 23/02/10 12:25 .6 or 1. To avoid this issue.6.4.5.0. Version compatibility Older agents from Zabbix 1.6 to 1. 2. Change level releases For change level releases only upgrading of server binary and frontend is required. 2. for example. upgrading from 1.php. Important notes All hosts now are required to belong to at least one group. Zabbix 1.util key on Linux now starts with 0. Upgrade procedure The following steps have to be performed for successful upgrade from Zabbix 1.size now takes into account reserved diskspace for root user.1 to 1.

sql 2. These scripts are for upgrade from Zabbix 1. Ignore any warning messages about non-existent indexes! Database upgrade scripts are located in directory upgrades/dbpatches/1.5. It will help if upgrade procedure fails (lack of disk space. Install new server binaries You may use pre-compiled binaries or compile your own.5. history_log drop index history_log_2.6. drop index). Check log files to see if the binaries have started successfully. history_text_2.7.7. all Zabbix processes must be stopped.3. escalations_2. You may want to review them.5..com/documentation/1.7. create index. psql -U <username> zabbix < patch. Example usage: shell> cd mysql.7.sql PostgreSQL: upgrades/dbpatches/1.8 only! For upgrade from earlier versions use also upgrade scripts from Zabbix 1. Stop Zabbix server Stop Zabbix server to make sure that no new data is inserted into database. actions drop index actions_1.sql Database upgrade should take around 10-15 minutes. Review Server configuration parameters Some parameters of zabbix_server. httptest drop index httptest_3.5. Install new Zabbix GUI Follow installation instructions.x. configuration files and PHP files.1. Configuration option StartDBSyncers has been removed from Zabbix server and proxy configuration files.conf were changed in 1. drop table. for PostgreSQL it may take several hours or more because of conversion of existing historical data. new parameters added.4. PHP files and Zabbix binaries Make a backup copy of Zabbix binaries. Also make sure that you have enough free disk space.5.7.8/mysql/patch. actions_1. history_log_2.8/<db engine>: MySQL: upgrades/dbpatches/1. Backup configuration files. 2.. 2.8:complete http://www.zabbix. any unexpected problem). mysql zabbix -u<username> -p<password> < patch. Before running upgrade scripts drop the following indexes: MySQL alter alter alter alter alter alter alter alter alter alter alter table table table table table table table table table table table dhosts drop index dhosts_1. 2.5. escalations drop index escalations_2. 2. graphs_items drop index graphs_items_2.7.6. Start new Zabbix binaries Start new binaries. history_text drop index history_text_2.8/postgresql/patch.8. services drop index services_1. httptest drop index httptest_2. services_1. 3 Comments 3. Zabbix Processes 27 de 143 23/02/10 12:25 .8/oracle/patch.x to 1.2. httptest_2.8. 2. Make sure that you have backup of your database. Upgrade database Before applying database patches. dservices drop index dservices_1.6. graphs_items_1. Make sure that you have enough permissions (create table. dservices_1. It is recommended to test the upgrade procedure in a non-production environment.7. If you are converting the database to UTF-8. Oracle or PostgreSQL drop drop drop drop drop drop drop drop drop drop drop index index index index index index index index index index index dhosts_1. 2.5.7.1. 2. power off. Backup existing Zabbix database This is very important step.sql or shell> cd postgresql. graphs_items_2.8/compl.sql Oracle: upgrades/dbpatches/1.5. graphs_items drop index graphs_items_1. Make sure to have a valid database backup before starting database upgrade.5.7. it can take many hours. httptest_3.

3 . Zabbix Server can be started by executing: shell> cd sbin shell> .no debug 1 . Ignored for SQLite.warnings EVENTLOG_WARNING_TYPE (LOG_LEVEL_WARNING) 4 .for debugging (LOG_LEVEL_DEBUG) debug-level messages (LOG_DEBUG) For syslog configuration consult the corresponding literature.8/compl.conf -h --help give this help -v --version display version number In order to get this help run: shell> zabbix_server -h Example of command line parameters: shell> zabbix_server -c /usr/local/etc/zabbix_server. Database password. Comments All messages are skipped. Database name. Supported parameters: Parameter AlertScriptsPath CacheSize CacheUpdateFrequency DBHost DBName DBPassword DBPort DBSocket DBUser Mandatory no no no no yes no no no no 1024-65535 3306 /tmp/mysql. The mapping between Zabbix logging levels and syslog levels is as follows: Zabbix log level 0 .critical information 2 . Description DebugLevel no 0-4 3 DisableHousekeeping ExternalScripts no no 0-1 0 /etc/zabbix/externalscripts Location of external scripts 28 de 143 23/02/10 12:25 . socket is used for MySQL. EVENTLOG_ERROR_TYPE Error 3 . in bytes.com/documentation/1..1.zabbix. DBUser and DBPassword are ignored. If this parameter is left empty (LogFile=). Zabbix agent under Windows uses Event Log if “LogFile” configuration parameter is provided empty. disables housekeeping. in seconds.critical information (LOG_LEVEL_CRIT) 2 . Database port when not using local socket. The file must exist and it should have read permissions for user 'zabbix'.for debugging (LOG_LEVEL_DEBUG) EVENTLOG_INFORMATION_TYPE Warning Information 3.empty (LOG_LEVEL_EMPTY) 1 . Specifies debug level 0 .empty (LOG_LEVEL_EMPTY) 1 .warnings warning conditions (LOG_LEVEL_WARNING) (LOG_WARNING) 4 . default is /etc/zabbix/zabbix_server.error information (LOG_LEVEL_ERR) Windows Event Log entry type Event Log is not used.1. Database host name.error information 3 . Individual processes 1. Ignored for SQLite.8:complete http://www. critical conditions (LOG_CRIT) error conditions (LOG_ERR) Comments All messages are skipped.for debugging (produces lots of information) If set to 1.1. How often Zabbix will perform update of configuration cache.. 3. Logging For logging configuration of Zabbix daemons “LogFile” configuration parameter is used. Database user.error information (LOG_LEVEL_ERR) syslog log level syslog is not used. For SQLite3 path to database file must be provided. Zabbix Server accepts the following command line parameters: -c --config <file> specify configuration file. All Zabbix daemons on Unix-like platforms log their messages from “Daemon” environment.critical information (LOG_LEVEL_CRIT) 2 ./zabbix_server Zabbix Server runs as a daemon process. syslog logging facilities are used. Path to MySQL socket. Ignored for SQLite. Shared memory size for storing hosts and items data.sock 128K-1G 1-3600 Range Default /home/zabbix/bin/ 8M 60 localhost Location of custom alert scripts Size of configuration cache.conf shell> zabbix_server --help shell> zabbix_server -v The configuration file contains parameters for zabbix_server. Comment this line if no password is used. If set to localhost.2.warnings 4 . Mapping between Zabbix log levels (messages of corresponding type) and Windows Event Log entries type is provided below: Zabbix log level 0 . Zabbix Server Zabbix Server is a central process of Zabbix software.

8:complete http://www. Shared memory size for storing character. Number of pre-forked instances of IPMI pollers. FpingLocation HistoryCacheSize HistoryTextCacheSize no no no 128K-1G 128K-1G /usr/sbin/fping 8M 16M HousekeepingFrequency no Include ListenIP ListenPort LogFileSize LogFile LogSlowQueries no no no no no no 1-24 1 0. socket is used for MySQL. This won't impact ability of this node to propagate events from its child nodes.conf -h --help give this help -v --version display version number In order to get this help run: shell> zabbix_proxy -h Example of command line parameters: shell> zabbix_proxy -c /usr/local/etc/zabbix_proxy. You shouldn't run more than 30 pollers normally. Number of pre-forked instances of HTTP pollers. Source IP address for outgoing connections. default is /etc/zabbix/zabbix_proxy. This won't impact ability of this node to propagate history from its child nodes. Make empty (“Fping6Location=”) if your fping utility is capable to process IPv6 addresses. If set to '1' local history won't be sent to master node. Number of pre-forked instances of pollers. in bytes. How often proxy retrieves configuration data from Zabbix Server in seconds. in bytes. Housekeeping is removing unnecessary information from history. If PostgreSQL is used. alert.disable automatic log rotation. as it performs VACUUM. Size of text history cache. How often Zabbix will perform housekeeping procedure (in hours).. If set to localhost.conf shell> zabbix_proxy --help shell> zabbix_proxy -v The configuration file contains parameters for zabbix_proxy. Shared memory size for storing history data.0.standalone server If set to '1' local events won't be sent to master node. and alarms tables. in seconds.. Name of PID file. Trapper will listen on all network interfaces if this parameter is missing. Shared memory size. 0-3600*24*7 3600 localhost 29 de 143 23/02/10 12:25 . Zabbix Proxy accepts the following command line parameters: -c --config <file> specify configuration file. 0 ./zabbix_proxy Zabbix Proxy runs as a daemon process.2 and higher.0. 0-3600000 0 If a query takes longer than this many milliseconds.pid 5-3600 30 How often Zabbix will try to send unsent alerts (in seconds). 0-255 0-255 0-255 0-255 0-255 0-255 0-255 1-30 1 1 0 1 1 5 5 3 /tmp Number of pre-forked instances of discoverers. for storing hosts and items data.0 1024-32767 10051 0-1024 1 Listen interface for trapper. Make sure that fping binary has root ownership and SUID flag set! Size of history cache. 0 . How often Zabbix will perform update of configuration cache. DBUser and DBPassword are ignored. the query is logged to the log file. Make sure that fping6 binary has root ownership and SUID flag set. Zabbix Proxy can be started by: shell> cd sbin shell> .com/documentation/1. Maximum size of log file in MB. Shared memory size for storing trends data. Listen port for trapper.disable log slow queries This option is supported in version 1. Temporary directory.8/compl. Database host name. Number of pre-forked instances of trappers Specifies how long we wait for agent.2. You may include individual files or all files in a directory in the configuration file. Specifies how many seconds trapper may spend processing new data. Name of log file. Location of fping. Number of pre-forked instances of ICMP pingers. For SQLite3 path to database file must be provided. 0 .1. text or log history data. in bytes. Unique NodeID in distributed setup. How often host is checked for availability during the unavailability period. The file must exist and it should have read permissions for user 'zabbix'.zabbix. Size of trend cache. Location of public keys for SSH checks NodeID NodeNoEvents NodeNoHistory PidFile SSHKeyLocation SenderFrequency SourceIP StartDiscoverers StartHTTPPollers StartIPMIPollers StartPingers StartPollersUnreachable StartPollers StartTrappers Timeout TmpDir TrapperTimeout TrendCacheSize UnavailableDelay UnreachableDelay UnreachablePeriod no no no no no no no no no no no no no no no no no no no no no 0-999 0-1 0-1 0 0 0 /tmp/zabbix_server. SNMP device or external check (in seconds). Number of pre-forked instances of pollers for unreachable hosts. Fping6Location no /usr/sbin/fping6 Location of fping6.8. Supported parameters: Parameter CacheSize CacheUpdateFrequency ConfigFrequency DBHost DBName Mandatory no no no no yes Range 128K-1G 1-3600 8M 60 Default Description Size of configuration cache. Database name. suggested value is 24. in bytes. How often host is checked for availability during the unreachability period After how many seconds of unreachability treat a host as unavailable 1-300 128K-1G 1-3600 1-3600 1-3600 300 4M 60 15 45 3. Zabbix Proxy Zabbix Proxy is a process which collects performance and availability data from one or more monitored devices and sends the information to a Zabbix Server.

0-3600000 0 /tmp/zabbix_proxy. Comment this line if no password is used.3. Name of log file.2 and higher. Trapper will listen on all network interfaces if this parameter is missing. You may include individual files or all files in a directory in the configuration file. SNMP device or external check (in seconds)..com/documentation/1. Used for monitoring availability of Proxy on server side. Name of PID file. Number of pre-forked instances of IPMI pollers. 0 . 0 . Number of pre-forked instances of ICMP pingers. alert. If not set. Make sure the Proxy name is known to the server! System hostname is used if undefined. Temporary directory. Location of fping. Number of pre-forked instances of HTTP pollers.no debug 1 .8:complete http://www.for debugging (produces lots of information) If set to 1. How often host is checked for availability during the unreachability period After how many seconds of unreachability treat a host as unavailable FpingLocation no /usr/sbin/fping HeartbeatFrequency no 0-3600 60 HistoryCacheSize HistoryTextCacheSize Hostname no no no 128K-1G 128K-1G 8M 16M HousekeepingFrequency no Include ListenIP ListenPort LogFileSize LogFile no no no no no LogSlowQueries PidFile ProxyLocalBuffer ProxyOfflineBuffer SSHKeyLocation ServerPort Server SourceIP StartDiscoverers StartHTTPPollers StartIPMIPollers StartPingers StartPollersUnreachable StartPollers StartTrappers Timeout TmpDir TrapperTimeout TrendCacheSize UnavailableDelay UnreachableDelay UnreachablePeriod no no no no no no yes no no no no no no no no no no no no no no no 3. Shared memory size for storing character. Database user.0. in bytes. default is /etc/zabbix/zabbix_agentd. Size of text history cache. Make sure that fping binary has root ownership and SUID flag set! Frequency of heartbeat messages in seconds. Shared memory size for storing history data. DBPassword DBSocket DBUser DataSenderFrequency no no 3306 Database password. Number of pre-forked instances of pollers for unreachable hosts. Maximum size of log file in MB. text or log history data. no 0-3600 1 Proxy will send collected data to the Server every N seconds. Number of pre-forked instances of trappers Specifies how long we wait for agent.heartbeat messages disabled. suggested value is 24. Make sure that fping6 binary has root ownership and SUID flag set.0 1024-32767 0-1024 10051 1 Listen interface for trapper. How often host is checked for availability during the unavailability period. IP address (or hostname) of Zabbix server. in bytes. Database port when not using local socket. Housekeeping is removing unnecessary information from history. DebugLevel no 0-4 3 DisableHousekeeping ExternalScripts Fping6Location no no no 0-1 0 /etc/zabbix/externalscripts Location of external scripts /usr/sbin/fping6 Location of fping6. disables housekeeping. Location of public keys for SSH checks 1024-32767 10051 Port of Zabbix trapper on Zabbix server. 0-255 0-255 0-255 0-255 0-255 0-255 0-255 1-30 1 1 0 1 1 5 5 3 /tmp 1-300 128K-1G 1-3600 1-3600 1-3600 300 4M 60 15 45 Number of pre-forked instances of discoverers. 1-24 1 How often Zabbix will perform housekeeping procedure (in hours). Unique Proxy name.8/compl. Proxy will keep data locally for N hours.error information 3 .disable log slow queries This option is supported in version 1. Ignored for SQLite. 0.zabbix. If PostgreSQL is used.. Zabbix Agent accepts the following command line parameters: -c -h -v -p --config <file> specify configuration file. Number of pre-forked instances of pollers. Proxy will keep data for N hours in case if no connectivity with Zabbix Server.1. Shared memory size for storing trends data. The agent provides host's performance and availability information for Zabbix Server. Proxy will get configuration data from the server. Older data will be lost.conf --help give this help --version display version number --print print supported metrics and exit 30 de 143 23/02/10 12:25 . This parameter may be used if local data will be used by third party applications. Specifies debug level 0 .0. Zabbix Agent (UNIX. Zabbix Agent processes items of type 'Zabbix Agent' or 'Zabbix Agent (active)'. the query is logged to the log file.critical information 2 . 0 . Listen port for trapper. in bytes.pid 0-720 0-720 0 1 If a query takes longer than this many milliseconds. Zabbix Agent can be started by executing: shell> cd sbin shell> . as it performs VACUUM. Ignored for SQLite. Size of trend cache.8. Make empty (“Fping6Location=”) if your fping utility is capable to process IPv6 addresses. You shouldn't run more than 30 pollers normally. Size of history cache. syslog is used. Ignored for SQLite. Source IP address for outgoing connections. Path to MySQL socket. Standalone daemon) Zabbix UNIX Agent runs on a host being monitored. Specifies how many seconds trapper may spend processing new data. and alarms tables.warnings 4 .disable automatic log rotation./zabbix_agentd Zabbix Agent runs as a daemon process.

Supported parameters: Parameter BufferSend BufferSize Mandatory no no Range 1-3600 1-65535 5 100 Default Description Do not keep data longer than N seconds in buffer. Step 2 31 de 143 23/02/10 12:25 .warnings 4 . The file must exist and it should have read permissions for user 'zabbix'. The agent does not kill timeouted User Parameters processes! User-defined parameter to monitor. Do not spend more than Timeout seconds on getting requested value (1-255). There can be several user-defined parameters. Zabbix Agent (Windows) Installation Installation is very simple and includes 3 steps: Step 1 Create configuration file.disable automatic log rotation.error information 3 .4. Required for active checks and must match hostname as configured on the server. You may include individual files or all files in a directory in the configuration file.0 1024-32767 10050 0-1024 1 Agent will listen on the specified interface. The file must exist and it should have read permissions for user 'zabbix'. The agent will work in passive mode listening for server.cpu.not allowed 1 .conf (it has the same syntax as UNIX agent).zabbix.. Inetd version) The file contains configuration parameters for zabbix_agent. Server port for retrieving list of and sending active checks. No spaces allowed. 0. Agent will listen on this port for connections from the server. 120 10051 How often list of active checks is refreshed.com/documentation/1. Connections from other IP addresses will be rejected.who UserParameter wc -l 3.for debugging (produces lots of information) Disable active checks.enabled Maximum number of new lines the agent will send per second to Zabbix Server or Proxy processing 'log' and 'eventlog' active checks.who|wc -l UserParameter No 3. There can be several user-defined parameters. 0 Enable logging of executed shell commands as warnings 0 . Only active checks will be processed.do not disable 1 .8/compl.load[all. 0 . Zabbix Agent (UNIX.8:complete -t --test <metric> test specified metric and exit http://www.test. syslog is used. Disable passive checks. The agent will send all collected data to Zabbix Server or Proxy if the buffer is full. Note that hostnames must resolve hostname→IP address and IP address→hostname.disabled 1 . Example:UserParameter=users.pid Name of PID file.conf --help --print -t "system.disable Whether remote commands from Zabbix server are allowed. Maximum number of values in a memory buffer. The agent will not listen on any TCP port. provided in 'log' or 'eventlog' item key. Maximum size of log file in MB. 0 . If not set.uname LogRemoteCommands no MaxLinesPerSecond no 1-1000 100 PidFile RefreshActiveChecks ServerPort Server SourceIP StartAgents Timeout no no no yes no no no 1-16 1-30 60-3600 /tmp/zabbix_agentd. List of comma delimited IP addresses (or hostnames) of Zabbix servers. Specifies debug level 0 . Source IP address for outgoing connections. In order to get this help run: shell> zabbix_agentd -h Example of command line parameters: shell> shell> shell> shell> zabbix_agentd zabbix_agentd zabbix_agentd zabbix_agentd -c /usr/local/etc/zabbix_agentd.. 3 3 Number of pre-forked instances of zabbix_agentd that process passive checks.no debug 1 . in seconds.allowed Unique hostname. The provided value will be overridden by the parameter 'maxlines'.0. Spend no more than Timeout seconds on processing User-defined parameter to monitor. 0 . Example: UserParameter=system.1.critical information 2 .5. DebugLevel no 0-4 3 DisableActive no 0 DisablePassive no 0 EnableRemoteCommands no 0 Hostname Include ListenIP ListenPort LogFileSize LogFile no no no no no system.avg1]" The configuration file contains configuration parameters for zabbix_agentd. Create configuration file c:/zabbix_agentd.0. Format: UserParameter=<key>. Supported parameters: Parameter Server Timeout Mandatory Default value Yes No 3 Description Comma-delimited list of IP addresses of ZABBIX Servers or Proxies.<shell command> Note that shell command must not return empty string or EOL only. Name of log file. First entry is used for receiving list of and sending active checks.

The parameter has no effect. you may use parameter “perf_counter[\Paging File(_Total)\% Usage]”.com /default. You can specify as many “Alias” records as you wish.0. For example: Include=c:\user_parameters. Debug level. The parameter has no effect.zabbix. Comma-delimited list of IP addresses of ZABBIX servers. Value has form <key>. Do not use spaces around pipe ('|') characters! Example:UserParameter=test.<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). The configuration file (c:/zabbix_agentd. Uninstall ZABBIX agent service.conf).exe --start Windows NT 4. You may run typeperf –qx to get list of all performance counters available in Windows. you should use the following command for service installation: zabbix_agentd.”\Processor(0)\Interrupts/sec”. Display help information. If not set. Windows Event Log is used. Samples for calculating average value will be taken every second.conf. Zabbix Sender can be started by executing: shell> cd bin shell> .exe. 3 – warnings.echo 1 Alias No - DebugLevel Include ListenPort LogFile LogUnresolvedSymbols No No No No No 3 10050 100 - MaxCollectorProcessingTime No NoTimeWait No PerfCounter No - PidFile Server SourceIP StartAgents UserParameter No Yes No No No - 6. Supported parameters: Parameter Mandatory Default value Description Sets the alias for parameter. Please note that aliases cannot be used for parameters defined in “PerfCounter” configuration file records.exe [-Vhp] [-idsx] [-c <file>] [-t <metric>] Zabbix Windows Agent accepts the following command line parameters: Options: -c -h -V -p -t --config <file> --help --version --print --test <metric> Specify alternate configuration file (default is c:\zabbix_agentd. If processing time will exceed specified value. For example. 2 – errors.conf Port number to listen.1. Sets maximum acceptable processing time of one data sample by collector thread (in milliseconds).microsoft. Display version number. so PDH.en-us. Controls logging of unresolved symbols during agent startup. Test single check (metric) and exit. Functions: -i -d -s -x --install --uninstall --start --stop Install ZABBIX agent as a service.8/compl.. Values can be strings ‘yes’ or ‘no’ (without quotes). Connections from other IP addresses will be rejected. so you need to download and install it by yourself.60 Please note double quotes around performance counter path.com/documentation/1. User-defined parameter to monitor. if you wish to retrieve paging file usage in percents from the server.connections -o 43 See Zabbix Sender manpage for more information.”<perf_counter_path>”.en-us. zabbix_agentd. The parameter has no effect. There can be several user-defined parameters. Set source IP address all connections established by the process..exe uses PDH (Performance Data Helper) API to gather various system information. For example. Stop ZABBIX agent service. Zabbix Sender (UNIX) Zabbix UNIX Sender is a command line utility which may be used to send performance data to Zabbix Server for processing. <parameter_name>. Number of parameters Include is not limited.284996 [http://support.DLL is needed.exe --install http://www. Name of log file.aspx?scid=kb. Print list of supported checks (metrics) and exit. Start ZABBIX agent service. Zabbix_agentd.7. If you wish to use configuration file other than c:\zabbix_agentd. one of: 0 – none.0 note. Microsoft Knowledge Base article number 284996 describes this in detail and contains a download link. 4 – debug Use this parameter to include a file into the configuration file.<shell command>.8:complete Install agent as a Windows service.conf) contains configuration parameters for zabbix_agentd. or you may define an alias by adding the following line to configuration file: Alias = pg_usage:perf_counter[\Paging File(_Total)\% Usage] After that you can use parameter name “pg_usage” to retrieve the same information.aspx?scid=kb. Zabbix Get (UNIX) 32 de 143 23/02/10 12:25 . Now you can use Control Panel to start agent's service or run: zabbix_agentd. you can define new parameter “interrupts” as following: PerfCounter = interrupts.com/default. This DLL is not supplied with Windows NT 4. The utility is usually used in long running user scripts for periodical sending of availability and performance data. 3.microsoft.exe --config <your_configuration_file> --install Full path to configuration file should be specified. 1 – critical. warning message will be written to the log file. Step 3 Run agent.284996] Usage Command line syntax: zabbix_agentd./zabbix_sender -z zabbix -p 10051 -s LinuxDB3 -k db. You can find this article at http://support. It can be useful to substitute long and complex parameter name with a smaller and simpler one. if you wish to receive average number of processor interrupts per second for last minute.

Default notification message. Compare with Trigger Severity. It may contain macros. Event source: Triggers – action will be executed for events generated by triggers Discovery – action will be executed for discovery events Default notification subject. Action attributes: Parameter Name Unique action name. otherwise remedy events can become escalated as well. in – event time matches the time period. Default is 10050.event came from a trigger inherited from this Host Template <> ./zabbix_get -s127. = .less or equal to trigger severity Compare with Trigger Value.hh:mm-hh:mm.1.events generated by new active agents Enable escalations. = . Configuration 1. If enabled.. Time period for increase of escalation step. make sure to add “Trigger value = PROBLEM” condition to the action.dd-dd. = . --source-address <ip address> Specify source IP address -key <key of metric> Specify metric name (key) we want to retrieve. The subject may contain macros. In order to get this help run: shell> zabbix_get -h 4. It may contain macros. Currently three sources are supported: Triggers – events generated by trigger status changes Discovery – events generated by auto-discovery module Auto registration . Recovery subject Subject of the recovery message.zabbix. --version Display version number. Case sensitive.com/documentation/1. Time period is given in format: dd-dd.more or equal to trigger severity <= . The messages will be send to those who received any message for this problem before.event did not come from this Host Compare against Trigger which generated event.… Host group Host template Host Trigger Trigger description (name) Trigger severity Trigger value Time period in 33 de 143 23/02/10 12:25 . Zabbix will send a recovery message after an original problem is resolved.event did not come from this Host Group Compare against Host Template the trigger belongs to..event came from Trigger.hh:mm:hh:mm.equal to trigger severity <> . Action conditions An action is executed only in case if an event matches defined set of conditions. Status Action status: Enabled – action is active Disabled – action is disabled Warning: before enabling recovery messages or escalations. which is part of the Application containing the String not like .event generated by other Trigger Compare against Trigger Name which generated event. The utility is usually used for troubleshooting of ZABBIX Agents. = .event generated by this Trigger <> . -host <host name or IP> Specify host name or IP address of a host. which is part of the Application not containing the String Compare against Host Group having a trigger which generated event.0. like – String can be found in Trigger Name.0.event came from this Host <> . Case sensitive. which is part of the Application like .equal to trigger value (OK or PROBLEM) Event is within time period. Recovery message Recovery message. = . The following conditions can be defined for Trigger based events: Condition type Application Supported operators = like not like = <> = <> = <> = <> like not like = <> >= <= = in Description = .1 -p10050 -k"system.not equal to trigger severity >= . Zabbix Get can be started by executing: shell> cd bin shell> . Description Event Source Enable escalations Period (seconds) Event Source Default subject Default message Recovery message If enabled.cpu.event came from this Host Group <> . The message may contain macros.event came from Trigger.8/compl. the action will be escalated according to operation steps defined for operations. --help Give this help.load[all. not like – String cannot be found in Trigger Name. An action can be defined for any event or set of events generated by Zabbix.event came from Trigger. = . Zabbix UNIX Get is a process which communicates with Zabbix Agent and retrieves required information. Actions Zabbix reacts to events by executing set of operations.event did not come from a trigger inherited from this Host Template Compare against Host having a trigger which generated event. Source of event.avg1]" Zabbix Get accepts the following command line parameters: -p -s -I -k -h -v --port <port number> Specify port number of agent running on the host.8:complete http://www.

more or equal to the value <= . since ”:” (colons) are not allowed in host names. Type of action: Send message – send message to user Execute command – execute remote command Step Operation type Event Source Send message to Default message Subject Message Send message to: Single user – a single user User group – to all members of a group If selected. The subject may contain macros.less or equal to the value like – has a substring not like – does not have a substring. String comparison. its name is decided by standard gethostbyname function.service port is out of the range Up – matches Host Up and Service Up events Down – matches Host Down and Service Down events Downtime for Host Down and Service Down events. = . 0 – use default period. If performing discovery by a proxy. versions of Zabbix prior to 1. Trigger value: Trigger changes status from FALSE to TRUE (trigger value is TRUE) Trigger changes status from TRUE to FALSE (trigger value is FALSE) Status change FALSE→UNKNOWN→TRUE is treated as FALSE→TRUE. The following conditions can be defined for Discovery based events: Condition type Supported operators Host IP = <> = <> = <> = >= <= = <> >= <= like not like Description Check if IP address of a discovered Host is or is not in the range of IP addresses. Parameter is given in seconds.Host IP is out of the range Check if a discovered service. 34 de 143 23/02/10 12:25 .zabbix.not equal to the value >= . Zabbix supports the following operations: Send message Remote command(s). = .. Maintenance status = <> Check if host is in maintenance.8/compl.. >= . where N is increasing number. = . The message may contain macros. <> . and TRUE→UNKNOWN→FALSE as TRUE→FALSE. escalation settings: From – execute for each step starting from this one To – till this (0. starting with 2.8:complete http://www.8 would add another host with the same name. = . Parameter Description If escalation is enabled for this action. currently hostname lookup still takes place on Zabbix server. then all ”:” (colons) are replaced by “_” (underscores).event came from a different service Check if TCP port number of a discovered service is or is not in the range of ports. IP address is used. If the host can be resolved. If not. Uptime for Host Up and Service Up events.uptime/downtime is less or equal.com/documentation/1. for all steps starting from From) Period – increase step number after this period. including IPMI.uptime/downtime is more or equal <= .matches discovered service <> . default message will be used. if IPv6 address must be used for a host name.Host is in maintenance mode.1 and latter adds _N to the hostname.Host IP is in the range <> . Service type Service port Discovery status Uptime/Downtime Received value For example this set of conditions (calculation type: AND/OR): Host group = Oracle servers Host group = MySQL servers Trigger name like 'Database is down' Trigger name like 'Database is unavailable' is evaluated as (Host group = Oracle servers or Host group = MySQL servers) and (Trigger name like 'Database is down' or Trigger name like 'Database is unavailable') Operations Operation or a set of operations is executed when event matches conditions. Subject of the message. Besides.Host is not in maintenance mode.service port is in the range <> . Parameter is given as a string.1. The message itself. Remote command List of remote commands. SNMP).equal to the value <> . = .8. Additional operations available for discovery events: Add host Remove host Enable host Disable host Add to group Delete from group Link to template Unlink from template When adding a host. resolved name is used. Compare with value received from an agent (Zabbix. If a host exists in Zabbix configuration with the same name as a newly discovered one. Zabbix 1.

last(0)} Escalation history.com: ON’ Example 2 Message: Processor load is: {zabbix.min(900)} The message will be replaced by something like: Latest value: 1. Effective use of macros allows to save time and make Zabbix configuration more transparent.6. IP and host DNS name depending on host settings. Numeric event ID which triggered this action.RULE. It is alias to {{HOSTNAME}:{TRIGGER.com/documentation/1.DEVICE. Log of previously sent messages. Host DNS name.SERVICE.mm.LOG.NAME}: {TRIGGER.cpu.STATUS} {DISCOVERY. Example 1 Subject: {TRIGGER. format. Useful in escalated messages. Time of the event.SERVICE.CONN<1-9>} {HOST.DEVICE.last(0)} MAX for 15 minutes: {{HOSTNAME}:{TRIGGER.zabbix.STATUS} Message subject will be replaced by something like: ‘Processor load is too high on server zabbix.load[.last(0)} The message will be replaced by something like: 'Processor load is: 1.HISTORY} {EVENT.IPADDRESS} {DISCOVERY.dd.KEY}.PORT} {DISCOVERY.com:system.avg1].3. Zabbix sends notifications only to those users.45 MAX for 15 minutes: 2.ACK..UPTIME} {DISCOVERY.TIME} {HOSTNAME<1-9>} {HOST.2.UPTIME} {ESC. Starting from 1. At least one host of a trigger expression must be accessible.33 MIN for 15 minutes: 1. List of supported macros The table contains complete list of macros supported by Zabbix. Macros Zabbix supports number of macros which may be used in various situations.8/compl.zabbix. IP address of first item of the trigger which caused a notification.NAME} {DISCOVERY. Notifications and commands X Discovery notifications X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X Age of the event.zabbix. Date of the event.HISTORY} {EVENT..max(900)} MIN for 15 minutes: {{HOSTNAME}:{TRIGGER.DATE} {EVENT.NAME} {DISCOVERY.DNS<1-9>} {IPADDRESS<1-9>} DESCRIPTION Current date in yyyy. which have read permissions to a host (trigger). Auto registration notifications X GUI Scripts Item key's parameters Map labels Trigger expressions Trigger names MACRO {DATE} {DISCOVERY.8:complete http://www. which generated the event.AGE<1-9>} X 35 de 143 23/02/10 12:25 .LASTVALUE<1-9>} X X {ITEM.STATUS} {EVENT.ID} {EVENT. Host name of first item of the trigger which caused a notification.1.4.KEY}. Supported from Zabbix 1.STATUS} {DISCOVERY.45' Example 3 Message: Latest value: {{HOSTNAME}:{TRIGGER.KEY}.KEY}.SERVICE.ACK. Macros for messages and remote commands The macros can be used for more efficient reporting.01 1 Comment 2.DEVICE. The latest value of first item of the trigger expression which caused a notification.SERVICE.AGE} {EVENT. {ITEM.

HARDWARE<1-9>} {PROFILE.3 Average.6.SEVERITY<1-9>} {ITEM. 1 – trigger is in ON state. Average.. Location from host profile.DEVICETYPE<1-9>} {PROFILE. Warning.TAG<1-9>} {STATUS} {TIME} {TRIGGER.UNACK} {TRIGGER. Mac Address from host profile.OS<1-9>} {PROFILE.NSEVERITY<1-9>} {ITEM. Hardware from host profile. If still not found. Numerical trigger severity.if trigger is in FALSE state.VALUE} X X {TRIGGERS. OS from host profile. {ITEM. file names. These macros have a special syntax: {$MACRO}. Serial No from host profile. Alias for {TRIGGER. X X Current time in hh:mm.URL} X X {TRIGGER. ON .com/documentation/1.ID<1-9>} {NODE.if trigger is in TRUE state.STATUS}.zabbix. global macros for global one-click configuration changes and fine tuning Example 1 Use of host macro in item “Status of SSH daemon” key: 36 de 143 23/02/10 12:25 . 2 – trigger UNKNOWN. {STATUS} {TRIGGER.LOCATION<1-9>} {PROFILE.func(param)} {$MACRO} X X X X Macros for host labels are supported starting from 1. Sotware from host profile. In case if Zabbix is unable to find a macro.Information. Name (description) of the trigger..ID} {TRIGGER. if a macro does not exist for a host. 4 .LOG. Supported starting from Zabbix 1. 3.SERIALNO<1-9>} {PROFILE.LOG. the macro will not be substituted. The global and host level macros is an excellent way of making maintenance of Zabbix configuration much easier. Current trigger value: 0 . Device type from of host profile. Historical (when event happened) value of Nth item of the trigger expression if used for displaying events.COMMENT} {TRIGGER. {STATUS} is deprecated. Key of first item of the trigger which caused a notification. 1 .8:complete http://www. See next chapter for details.STATUS}. Name from host profile. _ .LOG.NAME} X X X X X X X X X X X X X X X X X X X X X X X X Contact from host profile. Supported from Zabbix 1.LOG. Disaster. Trigger URL.4. Number of unacknowledged PROBLEM events for a trigger which generated event Numeric trigger ID which triggered this action.trigger is in OFF state.KEY<1-9>} {TRIGGER.SOFTWARE<1-9>} {PROFILE. Possible values: 0 Not classified.EVENTS.MACADDRESS<1-9>} {PROFILE. . Trigger comment. Trigger severity.2. Number of unacknowledged PROBLEM triggers for a map element.DATE<1-9>} {ITEM.VALUE<1-9>} X X {NODE.NSEVERITY} X {TRIGGER. Zabbix supports global and host-level macros as well as template-level macros.3. The latest value of Nth item of the trigger expression if used for displaying triggers.TIME<1-9>} {ITEM. global macros (checked last) In other words. OFF .ss.SEVERITY} X {TRIGGER.1.UNACK} {host:key. High. host macros (checked first) 2.8.NAME<1-9>} X X X X X X X Name of first item of the trigger which caused a notification. Zabbix substitutes macros according to the following precedence: 1. Zabbix will try to find it in host templates. taking advantage of templates with host specific attributes: passwords. The following characters are allowed in the macro names: A-Z . a global template will be used. {ITEM. Possible values: Not classified.LOG. Notes from host profile. Global and host level macros. port numbers. This macro can also be used in trigger expressions.LOG.Warning. regular expressions.8/compl. {TRIGGER. X X Simple macros as used in trigger expressions. etc 2.CONTACT<1-9>} {PROFILE.SOURCE<1-9>} {ITEM.NAME<1-9>} {PROFILE. Information. 2 .EVENTID<1-9>} {ITEM. 5 . Unknown Trigger state.High.NAME<1-9>} {PROFILE. if exists. The macros can be used in items keys and trigger expressions. Most common use cases of global and host macros: 1. Tag from host profile. 0-9 .NOTES<1-9>} {PROFILE. Global and host level macros For a greater flexibility. macros defined for templates of the host.Disaster. Zabbix will check templates of deeper level taking into account template inheritance.

1.8:complete
ssh,{$SSH_PORT} Example 2 Use of host macro in trigger “CPU load is too high”: {ca_001:system.cpu.load[,avg1].last(0)}>{$MAX_CPULOAD} Example 3 Use of two macros in trigger “CPU load is too high”:

http://www.zabbix.com/documentation/1.8/compl...

{ca_001:system.cpu.load[,avg1].min({$CPULOAD_PERIOD})}>{$MAX_CPULOAD} Note that a macro can be used as a parameter of trigger function, in this example function min(). Currently user macros are not supported in SNMP OID field. 5 Comments

4.3. Applications
Application is a set of host items. For example, application 'MySQL Server' may contain all items which are related to the MySQL server: availability of MySQL, disk space, processor load, transactions per second, number of slow queries, etc. An item may be linked with one or more applications. Applications are used in Zabbix front-end to group items. Currently a host cannot be linked to different templates having same application. 1 Comment

4.4. Graphs
User-defined graphs allow the creation of complex graphs. These graphs can be easily accessed via the menu item “Graphs”.

4.5. Medias
Media is a delivery channel for Zabbix alerts. None, one or more media types can be assigned to user.

Email
Email notification.

Jabber
Notifications using Jabber messaging.

Script
Custom script. Zabbix passes three command line parameters to the script: Recipient, Subject and Message.

GSM Modem
Zabbix supports sending of SMS messages using Serial GSM Modem connected to Zabbix Server's serial port. Make sure that: Speed of a serial device (normally /dev/ttyS0 under Linux) matches GSM Modem. Zabbix does not set speed of the serial link. It uses default settings. The serial device has read/write access for user zabbix. Run commans ls –l /dev/ttyS0 to see current permission of the serial device. GSM Modem has PIN entered and it preserves it after power reset. Alternatively you may disable PIN on the SIM card. PIN can be entered by issuing command AT+CPIN=“NNNN” (NNNN is your PIN number, the quotes must present) in a terminal software, such as Unix minicom or Windows HyperTerminal. Zabbix has been tested with the following GSM modems: Siemens MC35 Teltonika ModemCOM/G10

4.6. Host templates
Use of templates is an excellent way of making maintenance of Zabbix much easier. A template can be linked to a number of hosts. Items, triggers and graphs of the template will be automatically added to the linked hosts. Change definition of a template item (trigger, graph) and the change will be automatically applied to the hosts. Host template attributes:
Parameter Name Groups New group Description Unique template (host) name. The name must be unique within ZABBIX Node. List of host groups the template belongs to. Assign new host group to the template.

Link with template Used to create hierarchical templates.

7. Host groups

37 de 143

23/02/10 12:25

1.8:complete
Host group may have zero, one or more hosts. Host group attributes:
Parameter Description

http://www.zabbix.com/documentation/1.8/compl...

Group name Unique host group name. The name must be unique within Zabbix Node. Hosts List of hosts of this group.

8. Host and trigger dependencies
Zabbix does not support host dependencies. Host dependencies can be defined using more flexible option, i.e. trigger dependencies. How it works? A trigger may have list of one or more triggers it depends on. It means that the trigger will still change its status regardless of state of the triggers in the list, yet the trigger won't generate notifications and actions in case if one of the trigger in the list has state TRUE.

Example 1
Host dependency Suppose you have two hosts: a router and a server. The server is behind the router. So, we want to receive only one notification if the route is down: “The router is down” instead of: “The router is down” and “The host is down” In order to achieve this, we create a trigger dependency:
"The host is down" depends on "The router is down"

In case if both the server and the router is down, Zabbix will not execute actions for trigger “The host is down”.

19. Items
Item is a single performance or availability check (metric).

19.1. Item key
19.1.1. Flexible and non-flexible parameters Flexible parameter is a parameter which accepts argument. For example, vfs.fs.size[*] is a flexible parameter. * is any string that will be passed as argument to the parameter. Correct definition examples: vfs.fs.size[/] vfs.fs.size[/opt] 19.1.2. Allowed characters The following characters are allowed: 0-9a-zA-Z_. Support of Novell parameters will be maintained. 19.1.3. Available encodings The parameter “encoding” is used to specify encoding for processing corresponding item checks, so that data acquired would not be corrupted. For a list of supported encodings (code page identifiers), please, consult respective documentation, such as documentation for libiconv [http://www.gnu.org/software/libiconv/] (GNU Project) or Microsoft Windows SDK documentation for “Code Page Identifiers”. If empty “encoding” parameter is passed, then ANSI with system specific extension (Windows) or UTF-8 (default locale for newer Unix/Linux distributions, see your system's settings) is used by default.

19.2. Unsupported items
An item can become unsupported if its value can not be retrieved for some reason. Such items are still rechecked at a fixed interval, configurable in Administration section.

19.3. Supported by Platform
Parameter / system agent.ping agent.version kernel.maxfiles kernel.maxproc log[file<,regexp><,encoding><,maxlines><,mode>] logrt[file_format<,regexp><,encoding><,maxlines><,mode>] Windows Linux 2.4 Linux 2.6 FreeBSD Solaris HP-UX AIX Tru64 Mac OS/X OpenBSD X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X -

eventlog[name<,regexp><,severity><,source><,eventid><,maxlines><,mode>] X net.if.collisions[<if>] net.if.in[<if><,mode>] mode bytes packets errors dropped X X X X X

38 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

net.if.list net.if.out[<if><,mode>] mode bytes packets errors dropped net.tcp.dns[<ip,>zone] net.tcp.dns.query[<ip>,zone,<type>] net.tcp.listen[port] net.tcp.port[<ip,>port] net.tcp.service.perf[service<,ip><,port>] net.tcp.service[service<,ip><,port>] proc.mem[<name><,user><,mode><,cmdline>] mode sum avg max min proc.num[<name><,user><,state><,cmdline>] state all sleep zomb run system.boottime system.cpu.intr system.cpu.load[<cpu><,mode>] mode avg1 avg5 avg15 system.cpu.num[<type>] type online max system.cpu.switches system.cpu.util[<cpu><,type><,mode>] type user nice idle system kernel iowait interrupt softirq steal mode avg1 avg5 avg15 system.run[command<,mode>] mode wait nowait system.hostname system.localtime system.swap.in[<swap><,type>] type count sectors pages system.swap.out[<swap><,type>] type count sectors pages system.swap.size[<swap><,type>] mode free total used pfree pused system.uname system.uptime system.users.num vfs.dev.read[device<,type><,mode>] type sectors operations bytes ops bps

X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X -

X X X X X X X X -

X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X -

39 de 143

23/02/10 12:25

.file.Code Page identifier maxlines .version Description Check the agent availability.100] Description can be found here: log_file_monitoring logrt[file_format<.1. skip (skipping processing of older data) This parameter will be supported starting from version 2.zabbix.file. Description can be found here: log_file_monitoring 40 de 143 23/02/10 12:25 .cksum[file] vfs. Return value Always return ‘1’.memory. Example: logrt[“\home\zabbix\logs\^logfile[0-9]{1.encoding>] vfs. Must be Active Check..3.exists[file] vfs.size[<mode>] mode total free shared buffers cached X X X X X X X X X X X X X X X X X - X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X - X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X X - X - - 19.0.mode>] Monitoring of log file.type><.encoding><.. mode avg1 avg5 avg15 vfs.encoding>] vfs.mode>] mode total free used pfree pused vm.size[file] vfs.regexp><.file.mode>] mode total free used pfree pused vfs. String Number of files.fs.fs.:. Integer.file.regmatch[file.()_/[space] List of supported parameters Key agent.maxproc log[file<. file – full file name regexp – regular expression for pattern encoding .8/compl..conf mode . Log.regexp><. Example: log[\home\zabbix\logs\logfile. Version of ZABBIX Agent.mode>] type sectors operations bytes ops bps mode avg1 avg5 avg15 vfs.Maximum number of new lines per second the agent will send to Zabbix Server or Proxy.4. Maximum number of processes supported by OS.file.3}$”.inode[fs<.Code Page identifier maxlines .write[device<.file. This parameter overrides the 'MaxLinesPerSecond' option in zabbix_agentd. file_format – full file name in format [absolute path][filename format as regexp] regexp – regular expression for pattern encoding .file.encoding> <. This parameter overrides the 'MaxLinesPerSecond' option in Parameters Comments Can be used as a TCP ping.size[fs<. Example of returned value: 1.maxfiles kernel.maxlines> <.com/documentation/1.mode>] mode modify access change vfs.dev.regexp<.regexp[file.8:complete http://www. Integer.2 kernel..Maximum number of new lines per second the agent will send to Zabbix Server or Proxy. Number of processes.md5sum[file] vfs.maxlines><.100] Log rotation is based on last modification times of files.one of all (default).. Zabbix Agent String between [] may contain the following characters: 0-9a-zA-Z. Log.regexp<.mode>] Monitoring of log file with log rotation support.time[file<. Maximum number of opened files supported by OS. Must be Active Check.ping agent.

port number service . Check. user proc.perf[ssh] can be used to test speed of initial response from SSH server. http.IP address of DNS server On success returns (ignored) a character string zone .one of all (default). skip (skipping processing of older data) This parameter will be supported starting from version 2. MF.8:complete http://www.query[127. if .service[ftp.tcp.tcp.tcp.service[service <.ntp. CNAME.IP address of DNS server (ignored) zone .boottime Device interrupts.zone to test the DNS Examples: net. if it is possible to make TCP connection to port number port.perf[service <.list List of network interfaces: Type Status IPv4 Description String net. nntp.listen[80] Example: net.num Old naming: system[switches] system.cpu.one of avg.one of all (default).Source identifier eventid . Integer. tcp ip .switches Number of CPUs.port[<ip>. “Success Audit” source .max.cpu.1.80] can be used to test availability of WEB server running on port 80.0.num[.process name user . ftp.out[eth0. tcp ip .1) port .memory used by most memory hungry process running under oracle having oracleZABBIX in its command line Example: proc.0. Integer.1) port . MD. smtp.maxlines><.DNS is down 1 . Context switches.mem[. “Error”. pop.zabbix. Example: net. Integer.if. TXT Example: net. 0 . MG.one of all (default). zabbix_agentd.mode>] Network interface incoming statistic. avg15 Time is seconds.state> <.user name (default is all users) state .tcp.mode>] CPU(s) load. ip . system.0.number of seconds spent while connecting to the service port . SOA.collisions[if] Out-of-window collision.ip> <.load[] Note that returned value is not percentage.oracleZABBIX] .user> <. Switches count.DNS is up net. Integer.tcp. MINFO. NULL.avg5 (average within 5 minutes).ntp. MX. “Failure Audit”. zone] Checks if DNS service is up.listen[port] Checks if this port is in LISTEN state.service is running 2 . 41 de 143 23/02/10 12:25 . MR.user name (default is all users) mode .dns.cpu.cmdline>] Memory used by process name Memory used by running under user process.1. Old naming: check_service[*] Example: proc.out[eth0] You may use this key with Delta (speed per second) in order to get bytes per second statistics.0.tcp.0.num[.num[<type>] system. HINFO.root] .CPU number (default is all CPUs) mode .mode> <. imap. ldap. Processor load. Log.memory used by all processes zabbix_server running under user zabbix proc.0.if.tcp. name – event log name regexp – regular expression severity – regular expression The parameter accepts the following values: “Information”.it is not 1 .loadX Example: system.tcp.service is down sec . proc. smtp.oracle. sum (default) cmdline .. cpu . net.mysql] .if.user> <.one of ssh.load[<cpu> <.oracleZABBIX] .num[apache2. (default is SOA) 0 . Old naming: check_port[*] Example: net.interface if .port>] net.zabbix] .in[if <.mem[. ldap.tcp.service.out[if <.eventid><. min.if.one of avg1 (default).cpu.oracle.query[<ip>.cpu.number of processes in sleep state running under oracle having oracleZABBIX in its command line proc.interface mode – bytes number of bytes (default) packets number of packets errors number of errors dropped number of dropped packets ip .port number net. skip (skipping processing of older data) This parameter will be supported starting from version 2. if . zabbix.zabbix.errors] net. Number of collisions.0.ip> <.port[. PTR.memory used by all processes running under user “root”. <type>] Performs a query for the supplied DNS record type. net.one of ssh.0.filter by command line net.cmdline>] Number of processes name Number of having state processes.mode>] Monitoring of event logs.Maximum number of new Example: lines per second the agent will send eventlog[Application] to Zabbix Server or Proxy. http.tcp. zomb cmdline . MB. MX] type can be one of: A.service.IP address (default is 127.port>] Check performance of service Example: net.source><.if. net.0.8/compl. maxlines . nntp. ftp. Integer..sleep.service is down 1 .timeout connecting to the service 0 .port number (by default standard service port number is used) name .1.com.com/documentation/1.severity> <. sleep. Old naming: check_service[*] net.tcp.intr system. Example: system.it is in LISTEN state 0 .0. zone. “Warning”.filter by command line system.if.mem[zabbix_server.cpu. port] ip .regular expression Must be Active Check.port number (by default standard service port number is used) service .IP address (default is 127. run.dns[<ip>.number of apache2 running under user www-data proc.0. Float.dns[127. running under user user name .interface mode – bytes number of bytes (default) packets number of packets errors number of errors dropped number of dropped packets eventlog[name<. max proccessors..process name user .www-data] . service.0. Number of available type .mem[<name> <.can connect 0 .dns.one of online (default). pop.com] Example: net. WKS.conf mode .number of processes running under user mysql proc.mode>] Network interface outgoing statistic. net. Timestamp of system boot.1) port .conf mode . service.Record type to be queried type of information.IP address(default is 127. max. Check if service is running and accepting TCP connections.cpu. Old naming: system.45] can be used to test availability of FTP server on TCP port 45.regexp><. NS.tcp. This parameter overrides the 'MaxLinesPerSecond' option in zabbix_agentd. imap.cannot connect 1 .zone to test the DNS with the required type .num[<name> <.

one of modify (default.perf[www.swap. <port>.operations] Old naming: io[*] exactly which parameter to use.size[/tmp.uptime system.time[/etc/passwd.fs. Swap statistics system.file. percentage) system. regexp .size[<device> <.free[*].8:complete http://www. 0 .command for execution mode .inode[fs <. Processor load in percents cpu . percentage) mode .hostname path .one of free (default.full path to file mode .port number (default is 80) web.cpu. file .one of idle.found Size in bytes. system. <regexp>.total system. system.regexp[file.file. vm.type> <. operations. type . system.full path to file system.com.FreeBSD.page. free.fs.dev.hostname system. pfree (free swap space.in[<device> <.swap device (default is all). percentage) fs .file.inode[/.index.path to HTML document (default is /) port .8/compl. avg15 command .file.<path>.total[*].cpu.total[*] (used.swap.get[host. pfree (free. system.file.memory. softirq. access . <length>] Get first occurence of regexp in WEB page Matched string Returns EOF on fail (no match).modify] vfs.zabbix.free.size[file] File size vfs. percentage).memory.size[<mode>] Memory size Memory size in bytes web. ops.inode.file does not exist 1 .time[file<. bytes.Code Page identifier file .last change time Example: vfs.swap.fs.fs.out[.size[fs <.80 [http://www. nice.file.port number (default is 80) host .get[www. number Example: system.one of total (default). used.GNU regular expression encoding .mode>] Number of inodes Numeric value fs .uname Returns detailed host information. user (default).md5sum[/etc/zabbix/zabbix_agentd.page. bytes.pages] Old naming: swap[out] of swapouts). change . wait end of execution).size[/var/log/syslog] vfs. kernel.GNU regular expression encoding .hostname path .exists[file] Check if file exists file .regmatch[/var/log/app.pid] Example of returned value: b5052decb577e0fffd622d6ddc017e82 Example: vfs.path to HTML document text (default is /) port .regexp[host. vfs. Can be used only for files less than 64MB. String value Example of returned value: FreeBSD localhost 4.file. pused (used swap space. Matched string or EOF if expression not found 0 .<port>] Get content of WEB page host .filesystem Example: vfs. system.full path to file.pfree] Old naming: mode . 2] 42 de 143 23/02/10 12:25 .swap device (default is all). nowait (do no wait) Old naming: system.regexp[/etc/passwd. steal mode .num System's uptime in Number of seconds seconds.fs.com/documentation/1.php. Example: type .type>] Swap in.inode.log. pused (used. Example: vfs.file exists MD5 hash of the file.read[device <.fs.zabbix. 80. OK.cpu.disk device (default is all) type .80]] web. unsupported otherwise. vfs.php.80]] vfs.percentage of free swap space Old naming: system.userX Example: system. free..avg5 (average within 5 minutes). agent configuration file must have EnableRemoteCommands=1 option.index.fs. bps (must specify Example: vfs.zabbix.user. shared.file. vfs.pfree[*].buffers.util[0. device .one of sectors.pused[*] Old naming: vm.mode>] Disk space Disk space in bytes vm.get[www.exists[/tmp/application.page.swap.swap. type . Number of users vfs.com] system.file.file.pfree] .total Returns EOF on fail.zabbix.<port>] Get timing of loading full WEB page Time in seconds Example: web.one of sectors.full path to file vfs.com.type>] Disk read statistics. pused vfs.one of count (default.md5sum[file] File's MD5 check sum vfs.localtime Return host name. String value System local time.zabbix.one of total (default).com. percentage).run[command<.regexp<. file . Example of returned value www.free[*].full path to file regexp . operations.swap device (default is all).regmatch[file. buffers.one of wait (default.cpu.hostname WEB page source as path .users.index.operations] Old naming: io[*] exactly which parameter to use. percentage).Code Page identifier file . Command who is used on agent side.conf] file .CPU number (default is all CPUs) type . since defaults are different under various OSes) device .disk device (default is all) type .dev.memory. vfs. total (total swap space).zabbix.page.util[<cpu> <. Time in seconds.run[ls -l /] . Text result of the command Example: system.cpu.mode>] CPU(s) utilisation.size[. sps.free.swap.encoding>] Find string in a file Example: vfs. vm.zabbix] vfs. pages (pages swapped Old naming: swap[in] in) device . system.swap.full path to file vfs.org: /usr/src/sys/compile/GENERIC i386 Use Units s or uptime to get readable values. free swap space).idleX.cached.perf[host.zabbix.write[. vm. sps.fs.file. Note: To enable this functionality. Swap statistics device . Numeric value vfs.read[. vm.error] File must have read permissions for user zabbix Example: vfs. pfree (free.<path>.port number (default is 80) host .encoding>] Find string in a file Example: vfs.mode>] Run specified command on the host.php. iowait.fs.page.index. free.one of avg1 (default).cksum[/etc/passwd] Example: vfs.detailed file list of root directory.file.php.systemX. Number of bytes or percentage Example: system. modification time).inode. used.zabbix. interrupt. index.one of total (default).in[.free] Old naming: vfs.com [http://www.regexp<.page.write[device <. <path>.bytes] of swapins). number system.memory. Numeric value vfs.4-RELEASE #0: Tue Sep 18 11:57:08 PDT 2001 murray@builder.mode>] Swap space. pages (pages swapped out) device . Example: web. Number of seconds.type>] Disk write statistics.avg5] system.out[<device> <. disk space for local file system is returned.com]. Example: web.niceX.cpu.last access time.. bps (must specify Example: vfs. ops.fs.file. cached In case of a mounted volume.filesystem mode .fs.swap.type>] Swap in.1.fs.memory.com.used[*].dev.zabbix.shared.com [http://www.php. mode>] File time information. since defaults are different under various OSes) Example of returned value: 1938292000 Example: vfs.memory.file. Number of users connected.path to HTML document (default is /) port . system.80 [http://www.dev.pfree[*].cksum[file] Calculate file check sum File check sum calculated by algorithm used by UNIX cksum.one of count (default.expression not found 1 . vfs.4-RELEASE FreeBSD 4. vfs.

stopped. Kernel patches from www. Key agent[avg_collector_time] Description Return value Comments Average time spent by collector thread on each sample Time in milliseconds processing for last minute.GNU regular expression..0. userobj . Valid values are: min . But since 1. In order to get the amount of physical memory taken by all Internet Explorer processes. This parameter is supported starting from version 1.<type>] Different information about specific process(es). and “interval” is the time period for storing the average value. It will not work as expected for counters that require more that one sample . separated by comma.Number of USER objects used by process <type> . stopped.Number of bytes read by process during I/O operations io_read_op . SNMP Agent Zabbix must be configured with SNMP support in order to be able to retrieve data provided by SNMP agents.org] limit access rights of non-privileged users. “service1.start pending 3 .8/compl. continue_pending.Size of process virtual memory in Kbytes wkset .minimal value among all processes named <process> max . separated by a newline or 0. excluding services with names service1. that should be run services[automatic.Number of write operation performed by process io_other_b . regexp .avg] Note: All io_xxx.Number of read operation performed by process io_write_b .list of started services services[automatic.number of characters to return Linux-specific note.pause pending 4 . These requests generated ZBX_ERROR return code These requests generated ZBX_UNSUPPORTED return code Performance Monitor can be used to obtain list of available counters. Value of any performance counter.sum] 2.Number of bytes written by process during I/O operations io_write_op .6 “interval” is used. Maximum time spent by collector thread on each sample processing for last minute. start_pending. perf_counter[counter.like CPU utilisation.6 this parameter will return correct value only for counters that require just one sample (like \System\Threads).grsecurity.one of all (default).Number of GDI objects used by process attribute. stop_pending. Parameter must be real service name as it seen in service properties under “Name:” or name of EXE file.list of stopped services. Until version 1. so the check returns an average value for last “interval” seconds every time. <attribute>.unknown 255 – no such service type . for “interval” is 1. Total number of requests for unsupported parameters. 0 – running 1 – paused 2 . In order to get the average number of page faults for Internet Explorer processes. Excluded services should be written in double quotes. stopped] . Parameter is service name.representation type (meaningful when more than one process with the same name exists). started.zabbix.exclude>] List of services.service3”] -list of stopped services.org [http://www.process name (same io_other_op . length . if list would be empty.exe. where “counter” is the counter path. Number of system calls agent[processed_requests] Number of requests agent[failed_requests] agent[unsupported_requests] Number of requests Number of requests Average value of the “counter” during last “interval” seconds. The following steps have to be performed in order to add monitoring of SNMP parameters: 43 de 143 23/02/10 12:25 .list of services to exclude it from the result.1.stop pending 6 – stopped 7 . Zabbix agent must have read-only access to filesystem /proc.continue pending 5 .8:complete http://www. pause_pending.5.Process kernel time in milliseconds utime .service2. Examples: services[. use the following parameter: proc_info[iexplore.gdiobj and userobj attributes available only on Windows 2000 and later versions of Windows.average value for all processes named <process> sum . interval] service_state[*] State of service.wkset.service2 and service3 proc_info[<process>.com/documentation/1.one of all (default). without spaces. automatic. Total number of requests with errors in processing.8. that should be run. Total number of requests accepted by agent for processing. running.started] .Number of bytes transferred by process during operations other than read and write operations <process> .sum of values for all processes named <process> Examples: 1.maximal value among all processes named <process> avg .. Total number of requests rejected by agent for processing. other than read and write as in proc_cnt[] parameter) operations <attribute> .grsecurity. manual.Number of page faults ktime .Number of I/O operations performed by process. 19. paused exclude .Size of process working set (amount of physical memory used by process) in Kbytes pf .pf. if not given. services[<type><. WIN32-specific parameters This section contains description of parameter supported by Zabbix WIN32 agent only.state> <.exe. use the following parameter: proc_info[iexplore. agent[max_collector_time] Time in milliseconds agent[accepted_requests] Number of requests agent[rejected_requests] Number of requests agent[timed_out_requests] agent[accept_errors] Total number of requests timed Number of requests out in processing. Total number of accept() system call errors. Total number of requests successfully processed by agent.1. not on Windows NT 4.requested process gdiobj . The following attributes are currenty supported: vmsize . Default value. disabled state .Process user time in milliseconds io_read_b .

Enter the community (usually public) and enter the numeric OID that you retrieved earlier in to the 'SNMP OID' field being sure to include the leading dot.2. Now ADD the item and go back to the hosts area of Zabbix. Step 1 Create a host for the SNMP device. Simple checks Simple checks are normally used for agent-less monitoring or for remote checks of services.com/documentation/1.2.3.6. the 'Type of information' to NUMERIC and the 'Store value' to DELTA (important otherwise you will get cumulative values from the SNMP device instead of the latest change).10.3.2. Description Note that OID can be given in either numeric or string form.3.ifTable. Step 2 Find out the SNMP string of the item you want to monitor.1. So.6.8/compl.ifEntry. ‘my_param’.1. port 3=3.0 router.3.10.1.g.2. Choose the Multiplier if you want one and enter an 'update interval' and 'keep history' if you want it to be different from the default.1. This should give you something like the following: . i. selecting the SNMP host you created earlier.memTotalSwap.ifOctetsIn.2.2. You can use the host.2. string OID must be converted to numeric representation.3: shell> snmpget -On 10. Depending on whether you used a template or not when creating your host you will have either a list of SNMP items associated with your host or just a new item box. All simple checks accept one optional parameter: port .7.3 Enter the 'SNMP port' as 161 and the 'Key' as something meaningful.3 = Counter 32: 614794138 You should now use the snmpget command to find the OID for interfaces. .8.2.g.1. Enter an IP address and a port of 161.zabbix.port number.0 Monitoring of SNMP parameters is possible if either -with-net-snmp or -with-ucd-snmp flag was specified while configuring Zabbix sources.62.0) <Unique string to be used as reference to triggers> For example.ifInOctets.45. However. etc). Example 2 Monitoring of Uptime Parameter Description Community public Oid Key Value type Units Multiplier MIB::sysUpTime.g. but Cisco use regular numbers. so enter a plain English description in the 'Description' field of the new item box. We will work on the assumption that you are going to create the item yourself using the information you have just gathered using snmpwalk and snmpget. 3COM seem to use port numbers in the hundreds.1.SNMP template which would automatically add set of items. SNMP-InOctets-Bps.. the template may not be compatible with the host.0 (or .3 where the last number in the string is the port number you are looking to monitor.memory. standard default service port is used.1.6. Utility snmpget may be used for this purpose: shell> snmpget -On localhost public enterprises. You would then go through the list until you find the string you want to monitor.1.8.6. 44 de 143 23/02/10 12:25 .net-snmp.g.3 = Counter32: 614794138 again the last number in the OID is the port number.org/] software which you should have installed as part of the Zabbix installation) or equivalent tool: shell> snmpwalk <host or host IP> public This will give you a list of SNMP strings and their last value.e.ifTable. If missing. If it doesn't then it is possible that the SNMP 'community' is different from the standard public in which case you will need to find out what it is.01 19.ifTable. e. you wanted to monitor the bytes coming in to your switch on port 3 you would use: interfaces.ucdavis.6. e.uptime Float uptime 0. Set the 'Status' to MONITORED. now go back to Zabbix and click on Items. From here set the SNMP device to be MONITORED and check in LATEST VALUES for your SNMP data! Example 1 General example Parameter Community public Oid Key 1. use 'snmpwalk' (part of ucd-snmp/net-snmp [http://www.. Zabbix server is responsible for processing of simple checks (making external connections.1. Set the host Status to NOT MONITORED. Note that Zabbix agent is not needed for simple checks. e.1.8:complete http://www.45.ifEntry. port 1=port 101.ifOctetsIn. After creating the host.ifEntry. However.7.22 interfaces.1. Make sure the 'Host' field has your switch/router in it and change the 'Type' field to “SNMPv1 agent” (I had difficulty with SNMPv2 agent so I don't use it). e. port 3=port 103. Step 3 Create an item for monitoring. in some cases.

interval><.size><. Run these commands as user root in order to setup correct permissions: shell> chown root:zabbix /usr/sbin/fping shell> chmod 710 /usr/sbin/fping shell> chmod ug+s /usr/sbin/fping 45 de 143 23/02/10 12:25 .number of packets interval .interval><. 0 – POP server is down Otherwise number of millisecond spent connecting to POP server. 0 – SMTP server is down Otherwise number of millisecond spent connecting to SMTP server.one of min. Checks if NNTP server is running and accepting connections 0 – NNTP server is down Otherwise number of millisecond spent connecting to NNTP server.1.port> Checks if SMTP server is running and accepting connections ssh_perf<.port> Checks if SSH server is running and accepting connections tcp<.155 http http_perf. In case if Timeout time is exceeded.packet size in bytes timeout . avg (default) Return percentage of loss packets target .port> 0 – TCP service is down Checks if TCP service is running and accepting connections 1 – TCP service is running 2 – timeout Checks if FTP server is running and accepting connections 0 – FTP server is down Otherwise number of millisecond spent connecting to FTP server.port> 0 – FTP server is down 1 – FTP server is running 2 – timeout http<.8/compl.port> nntp<. has wrong permissions or its location does not match FpingLocation defined in configuration file..packet size in bytes timeout .mode>] Number of seconds icmppingloss[<target><.port> Checks if SSH server is running and accepting connections Timeout processing Zabbix will not process a simple check longer than Timeout seconds defined in Zabbix server configuration file.time between successive packets in milliseconds size . ftp_perf<.number of packets interval . nntp_perf<.host IP or DNS name packets .port> Checks if HTTP (WEB) server is running and accepting connections imap_perf<.port> pop_perf<.interval><. ICMP pings (icmpping.time between successive packets in milliseconds size .packets><. If the utility is missing.packets><. 0 – SSH server is down Otherwise number of millisecond spent connecting to SSH server.port> 0 – IMAP server is down Checks if IMAP server is running and accepting connections Otherwise number of millisecond spent connecting to IMAP server. The utility is not part of Zabbix distribution and has to be additionally installed. 2 is returned.8:complete Examples of using simple checks: ftp.port> http_perf<.packets><.port> Checks if POP server is running and accepting connections smtp<..port> 0 – HTTP server is down Checks if HTTP server is running and accepting connections 1 – HTTP server is running 2 – timeout 0 – IMAP server is down Checks if IMAP server is running and accepting connections 1 – IMAP server is running 2 – timeout Checks if NNTP server is running and accepting connections 0 – NNTP server is down 1 – NNTP server is running 2 – timeout 0 – POP server is down 1 – POP server is running 2 – timeout 0 – SMTP server is down 1 – SMTP server is running 2 – timeout 0 – SSH server is down 1 – SSH server is running 2 – timeout imap<.host IP or DNS name packets .timeout>] 0 – ICMP ping fails 1 – ICMP ping successful icmppingsec[<target><. 0 – HTTP (WEB) server is down Otherwise number of millisecond spent connecting to HTTP server.8080 http://www. icmppingsec and icmppingloss) will not be processed.timeout in milliseconds Return ICMP ping response time target .port> Checks if POP server is running and accepting connections smtp_perf<.timeout>] Loss packets in percents ftp<.number of packets interval . max. ICMP pings Zabbix uses external utility fping for processing of ICMP pings. List of supported simple checks: Key Description Checks if server is accessible by ICMP ping target .com/documentation/1.port> Checks if SMTP server is running and accepting connections ssh<.time between successive packets in milliseconds size .timeout> <.size><.packet size in bytes timeout . IP is taken from the Zabbix host definition.size><.port> pop<.host IP or DNS name packets .timeout in milliseconds mode .zabbix.timeout in milliseconds Checks if FTP server is running and accepting connections Return value icmpping[<target><.

In seconds since the epoch. Aggregated checks Aggregate checks do not require any agent running on a host being monitored. Do not use if MySQL InnoDB.<mode>] Cache Mode buffer pfree total used free Number of server monitored items in the Queue. Internal checks are calculated by ZABBIX Server. Key zabbix[boottime] zabbix[history] zabbix[history_str] zabbix[items] zabbix[items_unsupported] zabbix[log] Description Startup time of Zabbix server process in seconds."Item key". 19.com/documentation/1.zabbix. (seconds. <name> . Zabbix server collects aggregate information by doing direct database queries. Number of values stored in table TRENDS Number of triggers in ZABBIX database Uptime of ZABBIX server process in seconds.7. Syntax of aggregate item's key groupfunc["Host group". Oracle or PostgreSQL is used! Number of values processed by Zabbix server. Add item with this key to have Zabbix internal messages stored.<cache>.Proxy name List of supported parameters (<param>): lastaccess – timestamp of last heart beat message received from Proxy For example.8:complete The default values for ICMP checks parameters: packets interval size timeout 3 1 68 0. Internal Checks Internal checks allow monitoring of internals of Zabbix.. Number of values stored in table HISTORY Number of values stored in table HISTORY_STR Number of items in ZABBIX database Number of unsupported items in Zabbix database Stores warning and error messages generated by Zabbix server.8.<param>] Access to Proxy related information."parameter"] Supported group functions: GROUP FUNCTION DESCRIPTION grpavg grpmax grpmin grpsum Average value Maximum value Minimum value Sum of values Supported item functions: ITEM FUNCTION avg count last max min sum DESCRIPTION Average value Number of values Last value Maximum value Minimum value Sum of values Examples of keys for aggregate items: 46 de 143 23/02/10 12:25 .lastaccess] Trigger function fuzzytime() can be used to check availability of proxies.<cache>. zabbix[queue] zabbix[trends] zabbix[triggers] zabbix[uptime] zabbix[wcache.1. Oracle or PostgreSQL is used! Do not use if MySQL InnoDB. zabbix[proxy.<name>.8/compl. the target) "fping" default) "fping" default) "fping" default) http://www. Oracle or PostgreSQL is used! Comments zabbix[proxy."item func". 19.”Germany”.5 (pings to (seconds. (bytes.. Character. Free space in the history buffer in percentage. It is the best indicator of Zabbix performance. Do not use if MySQL InnoDB. <mode>] Cache Mode values all float uint str log text history pfree total used free trend pfree total used free text pfree total used free zabbix[rcache. Low number indicates performance problems on the database side.

company. Key Description Comments ssh.168.qps".com -h 192. min. Host name 'www1.. SSH checks Zabbix must be configured with SSH2 support. Example 1 Total disk space of host group 'MySQL Servers'. Command will be executed as the user Zabbix server runs as. Note that Zabbix agent is not needed for SSH checks. if necessary. choose item type Calculated.<parameter1>.168.1.. Syntax of item's key: script[parameters] * script – name of the script.load[.1.conf. The minimal supported libssh2 library version is 1. SSH checks are used for agent-less monitoring. You could use all functions and operators supported in trigger expressions. Calculated items Support of calculated items was introduced in Zabbix 1. 19.sh with parameters ”-h 192.0. however logic and operator precedence are exactly the same.fs.11.1.this simplified syntax is supported starting from Zabbix 1.<parameter2>. Do not overuse external checks! It can decrease performance of Zabbix system a lot. This directory is located on Zabbix server. Standard error and exit code are discarded. grpavg["MySQL Servers". Example 1 Execute script check_oracle. * parameters – list of command line parameters. First command line parameter is host name.10.1 Zabbix server will find and execute the command in directory defined in configuration parameter ExternalScripts in zabbix_server.) More complex expression may use a combination of functions."avg".<ip>. External checks External check is a check executed by Zabbix Server by running a shell script or a binary. Note that syntax is slightly different.168. If you don't want to pass your parameters to the script you may use: script[] or script <.<encoding>] Run bash script by using SSH remote session 19.sh[-h 192."system. so any access permissions or environment variables should be handled in a wrapper script. other parameters are substituted by parameters. operators and brackets."0"] Example 3 Average (5min) number of queries per second for host group 'MySQL Servers' grpavg["MySQL Servers".cpu.avg1]"."last".8:complete http://www.9. External checks do not require any agent running on a host being monitored.<port>."last".total]".8/compl.. grpsum["MySQL Servers".com/documentation/1. count.1 Calculated items is a very nice way of creating virtual data sources."vfs."300"] 19.4] Zabbix will execute: check_oracle.4. For custom command execution using Zabbix agents see user parameter documentation.size[/. etc Is a reference to an item.8. check_oracle. The following functions are supported: A very simple expression might look like: func(<key>|<hostname:key>.sh www1.zabbix. It may be defined as key or hostname:key parameter(s) Optional parameters 47 de 143 23/02/10 12:25 .0.company. max. ARGUMENT func host:key DEFINITION One of functions supported by trigger expressions: last.8. Zabbix uses the standard output of the script as the value.4”."0"] Example 2 Average processor load of host group 'MySQL Servers'. and permissions on the command should allow that user to execute it. To use calculated items.. Item values will be periodically calculated based on a arithmetical expression and data stored in Zabbix database. avg.com'.run[<unique short description>. Only commands in the specified directory are available.1."mysql..

8:complete Supported characters for a hostname: a.fs. User Parameters Functionality of Zabbix agents can be enhanced by defining user parameters (UserParameter) in agent's configuration file... Example 1 Simple command UserParameter=ping._- http://www. Zabbix processes calculated items according to item update interval. Example 2 Calculate 10 minute average number of values processed by Zabbix.Z0. one line has to be added to configuration file of Zabbix agent and the agent must be restarted. Sum of two functions: last("net.bytes])) 8 Comments 4.if.out[eth0.8/compl.in[eth0.bytes])/(last("net. 4.. User parameters are commands. A calculated item may become unsupported in several cases: 1.bytes]) Example 4 Calculate percentage of incoming traffic. Example 3 Calculate total bandwidth on eth0. User parameter has the following syntax: UserParameter=key.Z0. division by zero 4.9 .. Example 2 More complex example 48 de 143 23/02/10 12:25 .zA.out[eth0.zabbix. Simple user parameters In order to define a new parameter for monitoring.fs.1. Description Command Command to be executed to evaluate value of the Key..if..if.values]".bytes])+last("net.10.echo 1 The agent will always return '1' for item with key 'ping'.in[eth0.command Parameter Key Unique item key.zA.size[/.9_ Unlike trigger expressions. executed by Zabbix agent. not upon receiving a new value.zA.1.. More complex expression: 100*last("net._ Supported characters for a function: a. Supported characters for a key: a.if.. no data to calculate a function 3. Use of function avg: avg("Zabbix Server:zabbix[wcache.size[/.if.com/documentation/1...bytes])+last("net.in[eth0. Also if you change item key of a referenced item. Use of function last: 100*last("vfs. you have to update all formulas that used the old key manually.Z0..total]") Zabbix will take the latest values for free and total disk spaces and calculate percentage according to the given formula.. syntax errors Example 1 Calculate percentage of free disk space on '/'.600) Note that extensive use of calculated items with long time periods may affect performance of Zabbix Server.9.free]")/last("vfs.10. referenced item(s) not found 2.

000001) Is equal.root] wc[/etc/services|zabbix] Note that Zabbix agent daemon does not support user parameters with -t or -p switches.zabbix. ping[0] – will always return '0' ping[aaa] – will always return 'aaa' Example 2 Let's add more sense! UserParameter=mysql.command Parameter Key Command Description Unique item key.000001) & (A<B+0.000001) Logical AND DEFINITION 49 de 143 23/02/10 12:25 . For flexible user parameters.com/documentation/1. The operator is defined as: A=B ⇔ (A>B-0.otherwise. wc[/etc/passwd. In this case. It is not allowed to pass flexible parameters containing these symbols: \ ' ” ` * ? [ ] { } ~ $ ! & . Zabbix cannot evaluate trigger expression. The following operators are supported for triggers (descending priority of execution): PRIORITY OPERATOR 1 2 3 4 5 6 7 8 9 / * + < > # = & Division Multiplication Arithmetical minus Arithmetical plus Less than More than Not equal. Zabbix parses content of [] and substitutes $1. Flexible user parameters Flexible user parameters can be used for more control and flexibility. We can pass user name and password: mysql. if this value is part of this expression..8:complete http://www.our_password] Example 3 How many lines matching a regular expression in a file? UserParameter=wc[*]. The operator is defined as: A=B ⇔ (A<B-0.echo $1 We may define unlimited number of items for monitoring all having format ping[something]. The expression may have the following values: VALUE TRUE FALSE DESCRIPTION Normally means that something happened. if MySQL server is alive.000001) | (A>B+0. See manpage for more information. This may happen because of several reasons: server is unreachable trigger expression cannot be evaluated trigger expression has been recently changed UNKNOWN 12.10.mysqladmin –u$1 –p$2 ping|grep alive|wc –l This parameter can be used for monitoring availability of MySQL database. You can use them to create complex logical tests regarding monitored statistics. UserParameter=mysql.ping[*]. Trigger status (expression) is recalculated every time Zabbix server receives new value.8/compl. '0' .2.1.mysqladmin -uroot ping|grep alive|wc –l The agent will return '1'. This is normal trigger state. For example.$10 in the command.…. 2 Comments 12. UserParameter=key[*]. Expression for triggers The expressions used in triggers are very flexible.. ( ) < > | # @ \0 Example 1 Something very simple UserParameter=ping[*]. Triggers Trigger is defined as a logical expression and represents system state.1.ping[zabbix. 4. The [*] defines that this key accepts parameters. processor load is too high.ping. Command to be executed to evaluate value of the Key.grep "$2" $1|wc -l This parameter can be used to calculate number of lines in a file.

depending on what is counted .86400) will return the average value for an hour one day ago. int nodata now prev sec ignored ignored any any float. Parameter #num is supported from Zabbix 1. Integer items: exact match Float items: match within 0.2.8. Another example: count(#10.com/documentation/1. Parameter defines length of the period in seconds. For strings: 0 – values are equal 1 – values differ Number of historical values for period of time in seconds or number of last #num values matching condition.otherwise Returns number of seconds since the Epoch (00:00:00 UTC.2. for example. int.00001 String. last(0) is always equal to last(#1) last(#3) – third most recent value The function also supports an optional time_shift parameter. Comparison to strings is not supported. Since Zabbix 1.8. January 1. text. See function avg for an example of its use.86400) or count(600. Parameter is ignored.2. Parameter defines string to find. The period should not be less than 30 seconds. log.”gt”) will return exact number of values which are more than '12' stored in the history for the last 600 seconds. str. count(600.otherwise Find string in last (most recent) value. last(0. str. count(600..12. Second optional parameter is number of seconds or number of lines to analyse. the function supports a second. Returns log severity of the last log entry. See function avg for an example of its use. log float.86400) should be used. 0 – does not match 1 – matches Normally used for Windows event logs. int float. Parameter defines regular expression.8:complete http://www. Same as last(#2) Check if last value matches regular expression. For example. Parameter time_shift is supported starting from Zabbix 1. text. FUNCTION ARGUMENT SUPPORTED VALUE TYPES float.6. respectively. Last (most recent) value. logsource(“VMWare Server”) Maximal value for period of time.. log Returns absolute difference between last and previous values. avg(3600. optional parameter time_shift.1.8. Since Zabbix 1.text or numbers. Since Zabbix 1.2.2. str.”gt”. For example. Usually used with system. Parameter time_shift is supported from Zabbix 1. Mon – 1. text. Trigger functions The following functions are supported: All functions return numeric values only. 0 – otherwise.2. Parameter defines length of the period in seconds. Returns difference between last and previous values. This function is non case-sensitive analogue of regexp. int. Parameter is ignored. In this case more than one value will be processed. int. Zabbix takes log severity from field Information of Windows event log. text. str. log.12) will return exact number of values equal to '12' stored in the history. For strings: 0 – values are equal 1 – values differ Average value for period of time. Sun – 7. Same as max()-min(). third parameter operation. int. #num sec. Zabbix does not guarantee exact order of values if more than two values exists within one second in history.8. The function accepts second optional parameter pattern. Returns: 1 – found 0 – otherwise DEFINITION abschange ignored avg sec or #num float.2.8. Minimal value for period of time. Returns: 1 – found 0 . log regexp 1st – string 2nd – sec or #num str. Parameter defines length of the period in seconds. 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 N seconds. log count sec or #num float. useful for Windows event logs). int. Case sensitive! Second optional parameter is number of seconds or number of lines to analyse. This function is case-sensitive. For instance. text.6. str. 1970). str. log date ignored any any float.86400) will return exact number of values which are larger than '12' stored in the history among last 10 values 24 hours ago. For example.1. text. See function avg for an example of its use. Returns: 1 – if no data received during period of time in seconds. In this case more than one value will be processed. It is useful when there is a need to compare the current average value with the average value time_shift seconds back. text and log items: matches if contains pattern. text 50 de 143 23/02/10 12:25 . 0 – default severity N – severity (integer.zabbix.. for the last 600 seconds 24 hours ago. If there is a need to count arbitrary values. #num float. int change ignored float. Returns previous value.86400) will return the most recent value one day ago. Third parameter works for integer and float values only. Supported operators: eq – equal ne – not equal gt – greater ge – greater or equal lt – less le – less or equal For example. text str 1st – string 2nd – sec or #num str. the function supports a second. For example: 20031025 Returns day of week in range of 1 to 7. either count(600.8/compl. 0 . int float. and fourth time_shift. the function supports a second. Parameter time_shift is supported from Zabbix 1. optional parameter time_shift.12.2.8. log. Parameter #num is supported starting from Zabbix 1. 10 | Logical OR 12. Returns current date in YYYYMMDD format.. optional parameter time_shift.localtime to check that local time is in sync with local time of Zabbix server. The function accepts a second. int dayofweek ignored delta sec or #num diff ignored fuzzytime sec 1st – string 2nd – sec or #num iregexp str. Posix style. int.. log logseverity ignored log logsource string log max min sec. for instance. optional parameter time_shift. text last sec #num float. Check if log source of the last log entry matches parameter. Parameter: sec – ignored #num – Nth value For example.

15.last(0)}=0 The expression is true when both SMTP servers are down on both smtp1.load[all.com [http://www.zabbix. such as /etc/passwd.min(600)}>2 The expression is true when either the current processor load is more than 5 or the processor load was more than 2 during last 10 minutes.com] {www. which ignore it.conf.zabbix. Similar expressions could be useful to monitor changes in important files.service[smtp].com] is overloaded {www. Example 5 Both nodes of clustered SMTP server are down Note use of two different hosts in one expression: {smtp1.min(300)}>100K The expression is true when number of received bytes on eth0 is more than 100 KB within last 5 minutes.load[all.cpu.zabbix. Example: last(0) Example 1 Processor load is too high on www.if.avg1].com]’ and the key being monitored is ‘system. Example 6 Zabbix agent needs to be upgraded Use of function str(): {zabbix.zabbix.com:agent. #num ignored float. 4G.service[smtp].zabbix. It specifies that the server is ‘www.com:system. Example 3 /etc/passwd has been changed Use of function diff: {www. /kernel.avg1]’. int any Sum of values for period of time.str(beta8)}=1 The expression is true if Zabbix agent has version beta8 (presumably 1. Example 4 Someone is downloading a large file from the Internet Use of function min: {www. 0.file. Examples: 0.cpu.com/documentation/1.zabbix.load][all. Since Zabbix 1. the function supports a second.zabbix.com.tcp.zabbix.com:vfs. optional parameter time_shift. Example 2 www.zabbix.com] is greater than 5.avg1].com:system.com:system.cpu.5M <number><K|M|G> A simple useful expression might look like: {<server>:<key>.avg1]. Returns current time in HHMMSS format.cpu.com:net.cpu. Example: 123055 Some of the functions cannot be used for non-numeric parameters! Most of numeric functions accept number of seconds as an argument.zabbix. we are referring to the most recent value.zabbix.cpu.0beta8)..zabbix. Finally.com and smtp2.8/compl.last(0)}>5|{www.zabbix..2. 1.8. /etc/inetd.last(0)}>5 ‘www.zabbix.avg1]’ gives a short name of the monitored parameter. sum time sec. Parameter defines length of the period in seconds.com:net. You may also use prefix # to specify that argument has a different meaning: ARGUMENT sum(600) sum(#5) DEFINITION Sum of all values within 600 seconds Sum of the last 5 values The following constants are supported for triggers: CONSTANT <number> DEFINITION Positive float number.com [http://www.com [http://www.zabbix.in[eth0. By using the function ‘last()’. 123. 0.zabbix.tcp.com [http://www.zabbix.<function>(<parameter>)}<operator><const> Parameter must be given even for those functions. etc. See function avg for an example of its use. 51 de 143 23/02/10 12:25 .cksum[/etc/passwd].zabbix.com:system.zabbix.1.bytes].last(0)}=0&{smtp2.55 K – 1024*N M – 1024*1024*N G – 1024*1024*1024*N Examples: 2K.diff(0)}>0 The expression is true when the previous value of checksum of /etc/passwd differs from the most recent one.8:complete http://www.zabbix.com:system.zabbix.com:net.load[all.load[all. ‘>5’ means that the trigger is true whenever the most recent processor load measurement from www.version.load [http://www.

then trigger status will not be changed and thus actions will not be executed and notifications will not be sent.zabbix. If no data is received within 180 seconds. Bright red. user medias. In order to do this. Something important has happened. Example 8 No heartbeats within last 3 minutes Use of function nodata(): {zabbix. For example. Different colors for different severities. Dark red. Trigger dependencies is a very convenient way of limiting number of messages to be sent in case if an event belongs to several resources. Trigger severity Trigger severity defines how important is a trigger.. 12.cpu. Red. etc.com:status.8:complete http://www. then obviously the Host and the Router2 are also unreachable. Be warned.last(0)}>15) Note use of macro {TRIGGER. we would like to define a trigger which would become TRUE when server room temperature is higher than 20C while it should stay in the state until temperature will not become lower than 15C.zabbix. Average problem.1. This is when Trigger dependencies may be handy. If so. Disaster. Hysteresis Sometimes a trigger must have different conditions for different states. Information Warning Average High Disaster For information purposes.zabbix. Not classified Unknown severity. The host should periodically send data for this parameter using zabbix_sender. we define these dependencies: trigger ‘Host is down’ depends on trigger ‘Router2 is down’ trigger ‘Router2 is down’ depends on trigger ‘Router1 is down’ Before changing status of trigger ‘Host is down’.5.VALUE}. Example 7 Server is unreachable {zabbix. Different media (notification channel) for different severities. Zabbix supports following trigger severities: SEVERITY DEFINITION COLOR Gray.time(0)}>000000&{zabbix:system.avg1].avg1].3.load[all. Trigger dependencies Trigger dependencies can be used to define relationship between triggers.4.load[all. See description of ‘status’ for more details. Zabbix will check if there are corresponding trigger dependencies defined. Zabbix performs this check recursively. Zabbix .com/documentation/1.Router1 – Router2 .time(0)}<060000 The trigger may change its status to true. The macro returns current trigger value.VALUE}=1&{server:temp. If Router1 or Router2 is unreachable..VALUE}=0&{server:temp. SMS – high severity. 12. Light greed. For example.avg1].cpu.nodata(180)}=1 ‘tick’ must have type ‘Zabbix trapper’’. the Router1 and the Router2. 52 de 143 23/02/10 12:25 . item ‘tick’ must be defined.8/compl. the Host trigger won’t be updated.com:tick. and one of the triggers is in TRUE state. the trigger value becomes TRUE. Light yellow. In order to make this trigger work.min(300)}>2&{zabbix:system. 12. only at night (00:00-06:00) time. One does not want to receive three notifications about the Host. we define the following trigger: Example 1 Temperature in server room is too high ({TRIGGER. a host Host is behind router Router2 and the Router2 is behind Router1.last(0)}=2 The ‘status’ is a special parameter which is calculated if and only if corresponding host has at least one parameter for monitoring. Financial losses. Different audio for different severities. Example 9 CPU activity at night time Use of function time(): {zabbix:system.last(0)}>20)| ({TRIGGER.cpu. For example.load[all. email – other. audio alarms in Status of Triggers screen. In this case.Host If the Router1 is down. The severities are used to: visual representation of triggers.

Slide Show is a set of screens. high processor load. Screens and Slide Shows Zabbix screens allow grouping of various information for quick access and display on one screen. We can also be interested in identifying weak places of IT infrastructure. which will be automatically rotated according to configured update intervals. and many other information of higher level.1. Example 1 Slide show “Zabbix administrators” The slide show consists of two screens which will be displayed in the following order: Zabbix Server ⇒ Pause 60 seconds ⇒ Zabbix Server2 ⇒ Pause 30 seconds ⇒ Zabbix Server ⇒ Pause 60 seconds ⇒ Zabbix Server2 ⇒ … 4. The status is calculated and propagated to upper levels according to selected algorithm. Triggers create lowest 53 de 143 23/02/10 12:25 . Description Update interval (in sec) This parameter defines default interval between screen rotations in seconds.8:complete 3 Comments http://www.. Screen is a table which may contain the following elements in each cell: simple graphs user-defined graphs maps other screens plain text information server information (overview) trigger information (overview) data overview clock history of events history of actions URL (data taken from other location) Number of elements in each screen is unlimited. we are not interested in low-level details. etc. IT Services IT Services are intended for those who want to get a high-level (business) view of monitored infrastructure.. SLA of various IT services. like lack of disk space.8/compl. IT Services is hierarchy representation of monitored data. 13. structure of existing IT infrastructure.zabbix.14. In many cases. Easy-to-use screen builder makes creation of the screens easy and intuitive. If set to 0. in seconds. PARAMETER Name Name of slide show. What we are interested is availability of service provided by our IT department.com/documentation/1. Slides Screen Delay List of individual slides (screens): Screen name How long the screen will be displayed. Update Interval of the slide show will be used. Zabbix IT Services provides answers to all mentioned questions. A very simple IT Service structure may look like: IT Service | |-Workstations | | | |-Workstation1 | | | |-Workstation2 | |-Servers Each node of the structure has attribute status.

The Queue 4.8/compl.16.8:complete level of the IT Services.com/documentation/1. no permissions are granted on a screen when user is registered to the Zabbix.16.2. 15.2. By default. Communication between the Web Server and the user's browser can be protected using SSL.1.16. 15. 4.1. Statistics shown by the Queue is a good indicator of performance of Zabbix server. How to read The Queue on a standalone application or when displayed for a master node shows items waiting for a refresh. Permissions cannot be revoked by denying access to specific host groups.. Permissions are granted to user groups on a host group level. up-to 10 seconds for inter-node data transfer). The user has Read-Write access to all host groups.1. Users can not use their user id and password to log directly into the UNIX server unless they have also been set up accordingly to UNIX. Zabbix supports several types of users. Permissions to host groups must be explicitly given. Overview Zabbix has a flexible user permission schema which can be efficiently used to manage user permission within one Zabbix installation or in a distributed environment. so the information is delayed. and one item of type Zabbix agent (active) waiting more than five minutes (perhaps the agent is down?). The Queue is just a logical representation of data from the database. 4. There is no IPC queue or any other queue mechanism in Zabbix. User types User types are used to define access to administrative functions and to specify default permissions. 15. The master node receives historical data with a certain delay (normally. Overview Zabbix Queue displays items that are waiting for a refresh. All user passwords are encrypted and stored on the Zabbix database. The user has access to Monitoring and Configuration. The user has access to everything: Monitoring.zabbix. The type controls what administrative functions a user has permission to. User permissions All Zabbix users access the Zabbix application through the Web-based front end. [To be finished…] http://www. The user has no access to any resources by default. 54 de 143 23/02/10 12:25 . Note that a user is automatically disconnected after 30 minutes of inactivity. we see that we have three items of type Zabbix agent waiting to be refreshed 0-5 seconds. Each Zabbix user is assigned a unique login name and a password. Permissions to host groups must be explicitly assigned. User type Zabbix User Zabbix Admin Zabbix Super Admin Description The user has access to Monitoring menu. Note that information displayed for a child node is not up-to-date. Access permissions on screen within the menu may be set for each user. The user has no access to any host groups by default.. In this case. Configuration and Administration.

18. which is part of package net-snmp.conf. 55 de 143 23/02/10 12:25 .17.2. 5. @mycustomregexp.. Login This is Welcome to ZABBIX screen. There's a full list of such internal items in item configuration section. Run snmptrapd 4.sh to ~zabbix/bin Edit snmptrap. 4.8:complete http://www. The script must be used in combination with snmptrapd.sh for the item's key. it can be used everywhere regular expressions are supported by referring to it's name. however we should not trust the information as it depends on: performance of the Child node communications between Master and Child nodes possible local time difference between Master and Child nodes A special item key zabbix[queue] can be used to monitor health of the queue by Zabbix. or entered manually.17.sh Copy misc/snmptrap/snmptrap.1.wikipedia. On the screenshot we see that there are 93 items waiting more than 5 minutes for refresh on node “Child”.zabbix. Utilities 4. See snmptrap.8/compl. Regular expressions Complex regular expressions can be created and tested in the Zabbix frontend by going to Administration → General → Regular expressions.18.org/wiki/Regular_expression#POSIX_Extended_Regular_Expressions]. support POSIX extended regular expressions [http://en. use user name Admin with password zabbix to connect as ZABBIX superuser. Configuration guide: Install snmptrapd (part of net-snmp or ucd-snmp) Edit snmptrapd.. Add this line: traphandle default /bin/bash /home/zabbix/bin/snmptrap. When installed.2.1. snmptrap. Using regular expressions After a regular expression has been created.1.sh The script is used to receive SNMP traps. The scripts are located under directory misc/init.d. whether created with the advanced editor. prefixed with @.sh to configure some basic parameters Add special host and trapper (type “string”) item to Zabbix. Start-up scripts The scripts are used to automatically start/stop Zabbix processes during system's start-up/shutdown. 4. 4. Quick Start Guide 5. for example. Regular expression types All regular expressions in Zabbix.1.17.18. 4.com/documentation/1.

5. User “guest” is a special default user..com/documentation/1. In order to add new user. “guest” has read-only permissions. ZABBIX has only two users defined. press “Create user”. IP address of a failed login attempt will be displayed after successful login. 56 de 143 23/02/10 12:25 .zabbix.1. ZABBIX interface will pause for 60 seconds within next 15 minutes in order to prevent brute force and dictionary attacks. User “Admin” is ZABBIX superuser. By default.2. you will see “Connected as Admin” and access to “Configuration” area will be granted: 5. If an user does not log in. User “Admin” has all permissions.8/compl. Protection against brute force attacks In case of five consecutive failed login attempts. Add user After initial installation. the user will be granted with “guest” permissions.. When logged in.1.1.8:complete http://www.

com/documentation/1. Select “user groups” from drop-down to edit user group membership.8/compl. Grant user rights.8:complete http://www.1. The user is added.zabbix. 57 de 143 23/02/10 12:25 .. By default. new user has no permissions..

zabbix. Configure email address..8:complete http://www. Click on a group to change membership of the group.. No medias assigned yet.8/compl. 58 de 143 23/02/10 12:25 . list of severities for which the media will be active.1. Assign notification methods (medias) to the user.com/documentation/1.

Select “Email” from the list of all available media types. Zabbix has only one notification delivery method (media type) defined. Email settings Initially.1. Press “Save” when ready. 5.zabbix.com/documentation/1..8:complete http://www. Done! You may try to log in.. 59 de 143 23/02/10 12:25 .3.8/compl. Email configuration can be found under Menu → Administration → Media types. Email. SMTP helo and SMTP email values. Set correct SMTP server.

We will use standard template Unix_t in order to simplify configuration.. Now you have media type “Email” defined. We have ZABBIX agent running on our ZABBIX server and we want to monitor this server. Click on “Create host”.8:complete http://www. otherwise it will not be used. 2 Comments 5. The host is created and it has exactly the same items and triggers as Unix_t has.zabbix..1. Add agent-enabled host The section provides details about monitoring a host which has ZABBIX agent running. 60 de 143 23/02/10 12:25 . A media type must be linked with users. No hosts defined yet. Enter all required details. If a template is not used.com/documentation/1. we should manually add Items and Triggers to the host afterwards.8/compl. You must have the agent installed and configured properly.4.

zabbix. We see our host in the list.com/documentation/1.1. Let's check if this host has any items to monitor.8:complete http://www.8/compl.. Back to the list of hosts.. Menu→Configuration→Items: Yes! What about triggers? Menu→Configuration→Triggers: 61 de 143 23/02/10 12:25 .

Click on Graph.com/documentation/1.. It is time to see what information is available... and finally triggers.8:complete http://www. . Good.zabbix.8/compl. Menu→Status of triggers: 62 de 143 23/02/10 12:25 . Go to Menu→Latest data: It is time to see some graphs.1.

Menu→Configuration→Actions No actions defined yet. the host is under ZABBIX control. The action will be applied to all medias linked to the selected user or user group.. Press “Create Action”: If you do not specify any conditions the action will be triggerred if any trigger change its status. Macro {STATUS} is either ON or OFF depending on current status of the trigger.. we may be interested in: Modifying list of monitored items Modifying list of triggers items Adjusting refresh rate for items Adding user notification rules 5.zabbix.1. Set up notifications We have a host or several hosts monitored. Now it is time to configure basic email notification. Macro {TRIGGER.com/documentation/1.NAME} will be substituted by a trigger name.8/compl. We see graphs and status of the hosts. After the host is added.5. All right. 63 de 143 23/02/10 12:25 .8:complete http://www.

Applications.2. XML Import and Export 1. and network maps. Overview Currently two main categories of configuration are supported for export . host groups and maps. Templates. Host export Menu→Configuration→Export/Import Step 1 Select elements for export 64 de 143 23/02/10 12:25 .com/documentation/1. Items.1. Map import/export Zabbix map import/export supports the following elements since version 1. Use cases: Sharing of templates or network maps Zabbix users may share configuration parameters. This is very basic setup of notifications..8. Data is exported in XML format which is easy to read and modify.2. All connectors with associated data. 3. We may be interested in: Use conditions to define advanced filters for sending notification Repeat notifications Execution of remote commands 6. Host import/export Zabbix host Import/Export processes the following data: Hosts and their linkage to templates.hosts and their associated data. Goals Zabbix Import/Export functionality is created to make possible effective exchange of various configuration entities. Integration with third-party tools Universal XML format makes integration and data import/export possible with third party tools and applications.8/compl. Custom graphs.zabbix.8:complete http://www. 2. 2. Triggers.8. All map elements.1. Exporting and importing network maps is supported since Zabbix version 1. hosts.. triggers. including labels and status indicators. including images. 2.2: Full map configuration.

com/documentation/1.0.07" time="11.11"> <hosts> <host name="ZABBIX Server"> <useip>1</useip> <ip>127. Press button “Preview” to see list of elements to be exported: Step 2 Export data Press button “Export” to export selected elements to a local XML file with default name zabbix_export.1. </items> <triggers> <trigger> <description>Version of zabbix_agent(d) was changed on {HOSTNAME}</description> <expression>{{HOSTNAME}:agent.0000</yaxismax> <graph_elements> <graph_element item="{HOSTNAME}:system.0</expression> <priority>3</priority> </trigger> .avg15]"> <color>990000</color> <yaxisside>1</yaxisside> <calc_fnc>2</calc_fnc> <periods_cnt>5</periods_cnt> </graph_element> <graph_element item="{HOSTNAME}:system.0"?> <zabbix_export version="1..diff(0)}&gt.version. We selected host “Template_Linux” and all its items and triggers.xml.load[...0.cpu. <graphs> <graph name="CPU Loads" width="900" height="200"> <show_work_period>1</show_work_period> <show_triggers>1</show_triggers> <yaxismin>0..0000</yaxismin> <yaxismax>100.0" date="11..05.. The file has the following format (one element of each type is shown): <?xml version="1.load[.avg1]"> <color>009900</color> 65 de 143 23/02/10 12:25 .zabbix.cpu.8/compl..ping" value_type="3"> <description>Ping to the server (TCP)</description> <delay>30</delay> <history>7</history> <trends>365</trends> <snmp_port>161</snmp_port> <valuemap>Service state</valuemap> <applications> <application>General</application> </applications> </item> .1</ip> <port>10050</port> <status>1</status> <groups> </groups> <items> <item type="0" key="agent.8:complete http://www..

cpu.2. </hosts> </zabbix_export> 4..export and import. Press “Import Map” button. Map export and import controls can be found under Configuration → Maps menu.avg5]"> <color>999900</color> <yaxisside>1</yaxisside> <calc_fnc>2</calc_fnc> <periods_cnt>5</periods_cnt> </graph_element> </graph_elements> </graph> ...com/documentation/1. Otherwise it will not add it.. Element defines element of XML file. Map export and import A new feature is available since Zabbix version 1.8/compl. On the top right corner near “Create Map” button. If parameter Add is set for Missing element. 5. 2. 3.2 .1. To import maps: 1. 3. you will find new button .. 4. <yaxisside>1</yaxisside> <calc_fnc>2</calc_fnc> <periods_cnt>5</periods_cnt> </graph_element> <graph_element item="{HOSTNAME}:system. Check box under “Update existing” if you need to update (overwrite) existing maps.zabbix. Select file where Zabbix should store XML data with exported maps. Press button “Go”. </graphs> </host> . then the import will add new element with data taken from the file. Select “Export selected” if it's not selected already. where all configured maps are displayed. Otherwise it will not update it.load[.8:complete http://www. then the import will update it with data taken from the file.1. 5.. If parameter Update is set for Existing element.. Map exporting In left bottom corner a selection box is available with two options: “Export selected” and “Delete selected”. Map importing Importing maps is as easy as exporting them. 2. Mark boxes next to maps you wish to export. 66 de 143 23/02/10 12:25 .“Import Map”..8. Host import Menu→Configuration→Export/Import Step 1 Configure settings for data import and press “Import”. Press on “Choose file” button to select XML file containing exported Zabbix maps. To export maps: 1. You will get to a screen similar to what you see when importing hosts in Configuration→ Export/Import (Import) menu. Description 5. Pay attention to the following parameters of the item: PARAMETER Import file Rules File name of XML file.

8/compl. 5. Press import to send needed data to Zabbix frontend. Element types and storage elementtype tag in map export can be one of the following: Value 0 1 2 3 4 Type Host Map Trigger Host group Image Host reference DM (distributed monitoring) setup <node>noden1</node> <host>LocalHost</host> Single server setup <host>LocalHost</host> Hosts are referred to by host name. 5. http://www. all contained elements with their settings are exported.1. 5.1. 6. Thus if at least one of the elements map refers to is missing.3.4. so are the map links and map link status indicators. <elementid> refers to the actual Zabbix entity that is represented on the map (map/hostgroup/host etc.5.. import would fail with an error message: Cannot find trigger "our_node5:Zabbix server:Disk is full" used in exported map "Small map". hosts. used for map link references. triggers.. Wait till page reloads.com/documentation/1. {TimeHost:system.localtime[local].5.8:complete 4. <elementtype> describes what type of element info is stored in <elementid> node.last(0)}=0 &amp. but this trigger has been deleted in the meantime. 67 de 143 23/02/10 12:25 .5. Check box under “Add missing” if you need to create a new map if it's missing. hostgroups. What is not exported? Any maps. import will fail. Export format An example empty map export with background image from a distributed setup node: <sysmap> <selements> </selements> <links> </links> <name>TEST</name> <width>800</width> <height>600</height> <backgroundid> <node>aly_trunk</node> <name>Map BG</name> </backgroundid> <label_type>2</label_type> <label_location>0</label_location> <highlight>1</highlight> <expandproblem>1</expandproblem> </sysmap> 5. Click on “Details” link on the left hand side to see more information about what was done by import.last(0)}=2</expression> </elementid> <elementtype>2</elementtype> <iconid_off> <node>noden1</node> <name>Hub</name> </iconid_off> <label>New Element</label> <label_location>-1</label_location> <x>231</x> <y>122</y> </selement> <selement> is the opening tag for an element (shorthand of “System map element”). skipped otherwise. For example. triggers etc. It can take some time if you have lots of maps to import or lots of hosts. if map refers to a specific trigger on a specific node.2. images or any others elements related to the exported map are not exported. Zabbix frontend will inform you about import success or failure.zabbix. Map elements Let's take XML excerpt of some Zabbix map element as an example: <selement> <selementid>100100000000372</selementid> <elementid> <node>noden1</node> <host>LocalHost</host> <description>DOUBLE</description> <expression>{TimeHost:system. <node> tag will be present if the exported map comes from a distributed setup.. <selementid> is a unique element id. 5. That means all map settings are exported. What is exported? Only map structure is exported. or why it failed to import. 5.localtime[local].

size[free]. node for that state should be skipped in the <selement> block.zabbix.memory.1. Host group reference DM setup <node>noden1</node> <name>Local Host Group</name> Single server setup <name>Local Host Group</name> Host groups are referred to by host group name. trigger description and trigger expression. <iconid_off> is used. Element positioning <x> and <y> nodes are used for positioning element on the map by x and y coordinates. 5. <drawtype> defines default link style: 68 de 143 23/02/10 12:25 . Nodes <iconid_off>. For default icon. Trigger reference Triggers are described in a more complex way: DM setup <node>noden1</node> <host>LocalHost</host> <description>Lack of free memory on server {HOSTNAME}</description> <expression>{LocalHost:vm.last(0)}&lt.10000</expression> Trigger is referred to by host name.memory.4.3. <label_location> is used for positioning element's label: Value -1 0 1 2 3 Type use map default bottom left right top 5. image itself is specified: DM setup <node>noden1</node> <name>Local Image</name> Single server setup <name>Local Image</name> To use default icon for any state.size[free]. <iconid_on>. <iconid_unknown>..5.10000</expression> Single server setup <host>LocalHost</host> <description>Lack of free memory on server {HOSTNAME}</description> <expression>{LocalHost:vm.8:complete Map reference DM setup <node>noden1</node> <name>Local map</name> http://www.com/documentation/1. <iconid_maintenance> and <iconid_disabled> describes what icons should be used for the map element according to its status.5. Map links Example: <link> <selementid1>100100000000399</selementid1> <selementid2>100100000000402</selementid2> <drawtype>0</drawtype> <color>00AA00</color> <linktriggers> </linktriggers> </link> <selemetid1> and <selementid2> nodes are used to specify map elements that link connects.last(0)}&lt. Single server setup <name>Local map</name> Maps are referred to by map name. Element labels <label> describes map elements labels. Inside icon block.8/compl. Macros can be used in labels. Image reference For images <elementid> node can be skipped.5.5.. 5.

7.conf: UserParameter=mysql. Tutorials This section contains step-by-step instructions for most common tasks. It is assumed that a host is configured already in ZABBIX frontend. Add the command to zabbix_agentd. Make sure that parameter Hostname matches host name of the host configured in Zabbix frontend. Step 2 Add this command to agent's configuration file. Otherwise Zabbix won't accept them. Be aware that type of returned values must be set correctly on Zabbix server. 7. For example. Step 1 Configure Zabbix agent. Linked trigger referenced the same as map element trigger..8:complete http://www.com/documentation/1.. It can be any string. Extending Zabbix Agents This tutorial provides step-by-step instructions how to extend functionality of Zabbix agent. 7.last(0)}&gt.15 | {Symmetra PX40 Clone2:upsPhaseInputCurrent.questions is an unique identifier. Test this parameter by using zabbix_get utility.L3. for example. 69 de 143 23/02/10 12:25 .mysqladmin -uroot status|cut -f4 -d":"|cut -f1 -d"S" mysql. Value 0 2 3 4 Style line bold line dot dashed line * <color> specifies what default link colour.8/compl.2. queries. Step 4 Add new item for monitoring. Monitoring of log files This tutorial provides step-by-step instructions how to setup monitoring of log files. the command returns total number of SQL queries. Agent will reload configuration file.conf Step 2 Add a new item for monitoring of a log file. <drawtype> and <color> are used to indicate how link should be drawn on the map if this trigger has the highest severity from all the active triggers that are attached to this link. Example: <linktrigger> <triggerid> <node>aly_trunk</node> <host>Symmetra PX40 Clone2</host> <description>APC: Input Current (PHASE L3)</description> <expression>{Symmetra PX40 Clone2:upsPhaseInputCurrent.questions. we may write the following command in order to get total number of queries executed by a MySQL server: mysqladmin -uroot status|cut -f4 -d":"|cut -f1 -d"S" When executed. Follow standard instructions in order to install and configure agent on monitored host.last(0)}&lt.L3. Add new item with Key=mysql.zabbix. Step 1 Write a script or command line to retrieve required parameter.1.18</expression> </triggerid> <drawtype>0</drawtype> <color>0</color> </linktrigger> <triggerid> describes trigger used for indicating link status.1.questions to the monitored host. Step 3 Restart Zabbix agent. <linktriggers> contains information about link status indicators. Also make sure that parameter DisableActive is not set in zabbix_agentd. Type of the item must be either Zabbix Agent or Zabbix Agent (active).

For example: host:/etc/init. Example 1 Restart of Windows on certain condition. 7. if I wanted to monitor the “workstation” service then my service would be lanmanworkstation. Step 1 On Zabbix agent.exe –r –f Replace 'host' with Zabbix hostname of Windows server. Remote commands This tutorial provides step-by-step instructions how to setup remote execution of pre-defined commands in case on an event. For example. “power”. enable remote commands.8:complete Pay attention to the following parameters of the item: PARAMETER Type Key Type of information Update interval (in sec) Must be set to ‘ZABBIX Agent (active)’. log[/var/log/syslog.d/apache restart Remote commands in Zabbix < 1. Syntax of IPMI remote commands: REMOTE COMMAND <host>:IPMI <ipmi control> [value] <group>#IPMI <ipmi control> [value] Description The syntax is for execution of IPMI command on a single host.error]. execute as root: # visudo Example lines that could be used in sudoers file: # allows 'zabbix' user to run all commands without password. Step 1 Get service name You can get that name by going to the services mmc and bring up the properties of the service you want to monitor it's up/down status.4. The value that follows that you put in the brackets above.regexp>]’. Zabbix agent will filter entries of log file by the regexp if present. For example: log[/var/log/syslog]. Zabbix does not check if a command has been executed successfully Access permissions Make sure that user 'zabbix' has execute permissions for configured commands. Make sure that the file has read permissions for user ‘zabbix’ otherwise the item status will be set to ‘unsupported’. Description Must be set to ‘log[file<.3. It is assumed that ZABBIX server and ZABBIX agent are configured and operational.4 they are limited to 255 characters. In the General tab you should see a field called Service name. Must be set to ‘log’. http://www.1. Supported values: “on”. Server reboot: host:IPMI power off The syntax is for execution of IPMI command for all hosts of a host group..8/compl.. In zabbix_agentd.zabbix. zabbix ALL=NOPASSWD: ALL # allows 'zabbix' user to restart apache without password. Monitoring of Windows Services This tutorial provides step-by-step instructions how to setup monitoring of Windows services. The parameter defines how often ZABBIX Agent will check for any changes in the log file. 70 de 143 23/02/10 12:25 . Step 2 Configure new action by going to Configuration → Actions and choosing operation type Remote command. Restart agent daemon if changing this parameter.d/apache restart.conf make sure that parameter EnableRemoteCommands is set to 1 and uncommented. “off” or number (1.4 are limited to 44 characters. in Zabbix >= 1. by default). Normally must be set to 1 second in order to get new records as soon as possible. It is assumed that Zabbix is configured and operational. Supported ipmi controls: “reset”. Description Remote command Each line must contain an command for remote execution. zabbix ALL=(ALL) /etc/init. Pay attention to the following parameters of the action: PARAMETER Action type Must be set to 'Remote command'. define the following actions: PARAMETER Action type Remote command 'Remote command' host:c:\windows\system32\shutdown.com/documentation/1. To configure access. Remote command may contain macros! Syntax of remote commands: REMOTE COMMAND <host>:<command> Description Command 'command' will be executed on host 'host'. In order to automatically restart Windows in case of a problem detected by Zabbix. Zabbix agent executes commands in background. One may be interested in using sudo to give access to privileged commands. Description 7. <group>#<command> Command 'command' will be executed on all hosts of host group 'group'. Examples: Server restart: host:IPMI reset on.

test. Useful for monitoring of WEB sites which generate different content for different WEB browsers. triggers and notifications. Item Description This item will collect information about download speed (bytes per second) of the whole scenario.zabbix. Actual scenario name will be used instead of “Scenario”. Zabbix WEB monitoring supports both HTTP and HTTPS. Scenarios are very convenient way of monitoring user experience. The name will appear in Monitoring → Web For example: Zabbix GUI How often this scenario will be executed. average for all steps. Go to Overview screen 3. Logout If a step cannot be performed.1. WEB Scenario is periodically executed and consists of one or more Steps. WEB Monitoring 9. The scenario may have the following steps: 1.8:complete http://www. it will be executed Disabled: disabled scenario. Name Update interval Agent Status Variables Steps As soon as a scenario is created. For example: Zabbix Server Name of the WEB scenario. All cookies are preserved during execution of a single scenario. Parameter Application Description WEB scenario will be linked to this application.bps] Type: float 71 de 143 23/02/10 12:25 . For example: Opera 9. i. it will NOT be executed List of macros to be used in configuration of the steps.1. The application must exist. Step 2 Add item for monitoring of the service Add item with a key service_state[lanmanworkstation]. For example: 60 Zabbix will pretend to be the selected browser.2. The data is automatically used for graphs. Syntax: {macro}=value The macro {macro} will be replaced by “variable” in Step's URL and Post variables. Login 2. WEB Scenario Scenario is set of HTTP requests (steps). 9.in[Scenario. Example 1 Monitoring of Zabbix GUI If we want to monitor availability and performance of Zabbix GUI. execution of scenario fails... in seconds. Normally a scenario is defined for one particular part of functionality of a WEB application. value mapping Windows service state. For example: {user}=guest {password}=guest Steps of the scenario. Zabbix automatically adds the following items for monitoring and links them to the selected application.02 on Linux Active: active scenario. value type Integer.e. WEB Scenario is linked to a host application for grouping. 3. The module periodically executes WEB scenarios and keeps collected data in the database. Overview Zabbix provides effective and very flexible WEB monitoring functionality. we have to login. Go to Status of Triggers screen 4. Goals Zabbix WEB Monitoring support is developed with the following goals: Performance monitoring of WEB applications Availability monitoring of WEB applications Support of HTTP and HTTPS Support of complex scenarios consisting of many steps (HTTP requests) 1.com/documentation/1.. Download speed for scenario 'Scenario' Item key: web. which will be periodically executed by Zabbix server. check how quickly Overview and Status of Triggers screens work and then logout.8/compl. The following information is collected per each step of WEB scenario: Response time Download speed per second Response code Zabbix also checks if a retrieved HTML page contains a pre-defined string.

time[ZABBIX GUI.com [http://www. Item key: web.test. WEB Step Step is basically a HTTP request. Actual scenario and step names will be used instead of “Scenario” and “Step” respectively.fail[Scenario] Type: integer These items can be used to create triggers and define notification conditions.test. Item key: web. If empty.zabbix. Actually this parameter defines maximum time for making connection to the URL and maximum time for performing an HTTP request.last(0)<10000 Do not forget to replace the Scenario with real name of your scenario.1.210 Description Post Timeout Required Status codes As soon as a step is created.. For example: 15 The string (given as POSIX regular expression) must exist in retrieved content. Failed step of scenario 'Scenario' This item keeps number of failed step of the scenario. Zabbix automatically adds the following items for monitoring and links them to the selected application.com] HTTP POST variables.Step] Type: integer Response code for step 'Step' of scenario 'Scenario' These items can be used to create triggers and define notification conditions.Step.last(0)#0 Do not forget to replace the Scenario with real name of your scenario. 0 is returned.Step] Type: float This item will collect response codes of the step.zabbix. For example: Login URL For example: www. provides right content and how quickly it works.. Download speed for step 'Step' of scenario 'Scenario' Item key: web. For example: id=2345&userid={user} If {user} is defined as a macro of the WEB scenario.test. Do not spend more than Timeout seconds for execution of the step. Therefore. If all steps are executed successfully. So. 9. Example 1 Trigger “Zabbix GUI login is too slow” The trigger expression can be defined as: {zabbix: web. it will be replaced by its value when the step is executed. You may also want to create a host if one does not exist.zabbix. this step fails.com/documentation/1.5. Step 1 Add new host application.time[Scenario. Example 2 Trigger “WEB application is slow” The trigger expression can be defined as: {host: web.in[Scenario.in[Scenario. Example 1 Trigger “WEB scenario failed” The trigger expression can be defined as: {host: web. Steps are executed in a pre-defined order.fail[Scenario]}.test.Login]}.. any content will be accepted.8:complete http://www. if any. If empty.bps]}. This step is not required if you already have a suitable application. Parameter Name URL Name of the step.4. any status code is accepted.test. Item key: web. Item Description This item will collect information about download speed (bytes per second) of the step.last(0)>3 9. Zabbix will not spend more than 2 x Timeout seconds on the step. For example: Homepage of Zabbix List of HTTP status codes to be considered as success. For example: 200. We want to know if it is available. Real life scenario Let's use Zabbix WEB Monitoring for monitoring of Zabbix WEB interface. If retrieved status code is not in the list. first we make a login with our user name and password and then we will try to access Configuration→General page.test.test.8/compl. Otherwise this step fails.rspcode[Scenario.bps] Type: float Response time for step 'Step' of scenario 'Scenario' This item will collect information about response time of the step in seconds. The information will be sent as is. 72 de 143 23/02/10 12:25 .

. Note use of macros {user} and {password}.com/documentation/1.php file. Note that we also created two macros. {user} and {password}. Step 2 Add new WEB scenario. Example string for logging into Zabbix frontend: name=Admin&password=zabbix&enter=Enter 73 de 143 23/02/10 12:25 . Scenario step 1. Add steps for monitoring. Additionally. We add a new scenario for monitoring of Zabbix WEB interface. Note that Zabbix frontend uses JavaScript redirect when logging in..8:complete http://www.8/compl. login step must use full URL to index. All the post variables must be on a single line and concatenated with & symbol. The scenario will execute number of steps. Step 3 Define steps for the scenario.zabbix. and only further steps may check for logged-in features. thus first step must log in.1.

zabbix..1..8:complete http://www.8/compl.com/documentation/1. Scenario step 2. Step 4 Save Scenario. The list of applications and linked scenarios will appear in Monitoring→WEB: Click on a scenario to see nice statistics: 74 de 143 23/02/10 12:25 .

since it is not possible unambiguously define."pattern_to_match". Special note for “\” path separators: if file_format is “file\."pattern_to_match". Whenever the log file becomes smaller than the log size counter known by the agent. The number of bytes already analyzed (the size counter) and the last modification time (the time counter) are stored in the Zabbix database and are sent to the agent. Overview 75 de 143 23/02/10 12:25 . to make sure it starts reading the log file from this point.encoding><. 0 Comments 11. Support of changing environments Network discovery makes possible use of Zabbix in rapidly changing environments with no excessive administration.8:complete http://www. How it works Monitoring of log files requires Zabbix Agent running on a host.encoding><..100] or logrt["/home/user/filelog_.” is escaped or is the first symbol of the file name.max lines>] or logrt[path to log file with filename format<."UTF-8". Important notes: The server and agent keep a trace of the monitored log's size and last modification time (for logrt) in two counters. Overview Zabbix can be used for centralized monitoring and analysis of log files with/without log rotation support.pattern><. 2.100] The last one will collect data from files such “filelog_abc_1” or “filelog__001”.. All files matching the filename format in the provided directory are analyzed every cycle the agent tries to get the next line from the log (for logrt).1. For example: log["/home/user/file. The limit prevents overloading of network and CPU resources and overrides the default value provided for MaxLinesPerSecond parameter in the configuration file of the agent.max lines>]. If there are several matching files with the same last modification time in the directory.1.2.pattern><. Log File Monitoring 1. Goals There are several goals of Zabbix network discovery module: Simplify deployment Network discovery can be used to significantly simplify and speed up Zabbix deployment.com/documentation/1. Discovery 11.8/compl. then there should not be directory “file”.log". Zabbix Agent does not send more than maxlines of a log file per second. whether ”. 1. 10. its value type must be Log and key set to log[file<.3}".*_[0-9]{1. Simplify administration Properly configured network discovery can simplify administration of Zabbix system a lot. An item used for monitoring of a log file must have type Zabbix Agent (Active). The agent starts reading the log file from the point it stopped the previous time. Notifications can be used to warn users when a log file contains certain strings or string patterns.zabbix. then the agent will read lexicographically the smallest one. It also makes possible creation of user friendly appliances.log”."UTF-8". the counter is reset to zero and the agent starts reading the log file from the beginning taking the time counter into account. Zabbix Agent processes new records of a log file once per Refresh period seconds.

FTP. Parameters of network discovery rule: Parameter Name Name of the rule. “Local network”. etc) Information received from Zabbix agent Information received from SNMP agent It does NOT provide: Discovery of network topology Every service and host (IP) checked by Zabbix network discovery module generates events which may be used to create rules for the following actions: Generating user notifications Adding and removing hosts Enabling and disabling hosts Adding hosts to a group Removing hosts from a group Linking hosts to a template Unlinking hosts from a template Executing remote scripts The actions can be configured to respect host or service uptime and downtime. IMAP. POP3.168. SNMPv2 Agent. Service Lost Host Discovered Host Lost If the service is lost after being up.0/24 List: 192. Will be based either on a SNMP or Zabbix Agent check.1-255 IP mask: 192. How it works Network discovery basically consists of two phases: Discovery and Actions. Network discovery rule Network discovery rule is a rule used by Zabbix to discover hosts and services. TCP.4.60-70 Description IP range Delay (in sec) Checks Uniqueness criteria may be: Device uniqueness criteria IP address (no processing multiple-IP devices) One of discovery check of the rule. LDAP. It won't be executed. Every time Zabbix cannot detect service. ICMP checks will fail for IPv4 devices as well.192.3. Discovery Zabbix periodically scans IP ranges defined in network discovery rules. If at least one of the services is UP for the IP. 11.0/24 This parameter defines how often Zabbix should execute this rule. SNMPv1 Agent. SNMPv3 Agent Parameter Ports may be one of following: Single port: 22 Range of ports: 22-45 List: 22-45. Only from 1.2. First.192. If host is lost after being up. Actions For a description of all conditions available for network discovery based events see action conditions. IMAP. Frequency of the check is configurable for each rule individually.1-100. Then we process the events and apply certain actions depending of type of discovered device. Each rule defines set of service checks to be performed for IP range. Range of IP addresses for discovery. 11.8/compl. and generate discovery event or several events. Zabbix network discovery is based on the following information: IP ranges Availability of external services (FTP. SMTP.3.192.55. Zabbix will use this list of checks for discovery of hosts and services. List of supported checks: SSH.1. we discover a host or a service.com/documentation/1.1. Status Active – the rule is active and will be execute by Zabbix server Disabled – the rule is not active.168. Events generated by network discovery module have Event Source “Discovery”. If host is back after downtime or discovered for the first time. For example.8:complete http://www.168. ZABBIX Agent.4. NNTP. 76 de 143 23/02/10 12:25 . TCP. its status.2. SSH.zabbix. Service Discovered If the service is back after downtime or discovered for the first time. etc. POP.200. HTTP.2.1.1. Zabbix provides effective and very flexible network discovery functionality.33 Range of IP addresses: 192. up/down time. 0 Comments 11.3.4.168. IP.1. 11. If Zabbix server is compiled with IPv6 support and fping6 utility is missing.2 IPv4 addresses are still processed by located fping.168. It may have the following formats: Single IP: 192.. For a description of all operations available for network discovery based events see operations.168. WEB.168.1-255.8.. If all services are not responding. Zabbix generates the following events: Event Service Up Service Down Host Up Host Down When generated Every time Zabbix detects active service.

The rule will be executed every 10 minutes (600 seconds). link Windows boxes to Windows_Template. Zabbix will automatically start discovery and generation of Discovery based events for further processing. Step 3 Define an action for adding newly discovered Windows servers. Linux boxes to Linux_Template. The action will be activated if: service “Zabbix Agent” is Up value of system.uname (Zabbix Agent's key we used in rule definition) contains “Linux” Uptime is more than 1 hour (3600 seconds) The action will execute the following operations: adds newly discovered host to group “Linux servers” (also adds host if wasn't added previously) links host to template “Template_Linux”.1. In our scenario we want to: discover only hosts having Zabbix Agent running run discovery every 10 minutes add host for monitoring if host uptime is more than 1 hour remove hosts if host downtime is more than 24 hours use Template_Windows for Windows hosts use Template_Linux for Linux hosts add Linux hosts to group “Linux servers” add Windows hosts to group “Windows servers” Step 1 Define network discovery rule for our IP range.168.1-192. For example. Zabbix will automatically start monitoring of the host using items and triggers from “Template_Linux”. A value received from an agent can be used to apply different actions for different operating systems.1.1.255.com/documentation/1. Step 2 Define an action for adding newly discovered Linux servers.8/compl. Real life scenario Suppose we would like to setup network discovery for local network having IP range of 192..168.1.uname key.255 by connecting to Zabbix Agents and getting value from system.. 77 de 143 23/02/10 12:25 .1-192.168. When the rule is added.5. 11.zabbix.168.8:complete http://www.1. Zabbix will try to discover hosts in IP range of 192.

2.2. ifInUnknownProtos 1. including framing characters.1.2. The current operational state of the interface.2.. The interface's address at the protocol layer immediately `below' the network layer in the protocol stack.1.1.1.3.1. 1. Description 1.1.6.2.3.1.2.1.1..3 1.1.1.2.2.11 The number of subnetwork-unicast packets delivered to a higher-layer protocol.6. Special OID ifIndex ifDescr ifType ifMtu ifSpeed ifPhysAddress ifAdminStatus ifOperStatus ifInOctets ifInUcastPkts ifInNUcastPkts ifInDiscards ifInErrors Identifier 1.6. ifOutOctets ifOutNUcastPkts ifOutDiscards ifOutErrors 1.3.1.1.1.2.4 1.This string should include the name of the manufacturer.20 The number of outbound packets that could not be transmitted because of errors.2.1.6.2.1. including framing characters.6. Special OIDs Some of the most used SNMP OIDs are translated automatically to a numeric representation by Zabbix.2.2.2.6.1.15 The number of packets received via the interface which were discarded because of an unknown or unsupported protocol.2.2. A server will be removed if service “Zabbix Agent” is Down for more than 24 hours (86400 seconds).6.2.14 The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol.1.3.6.1.1. specified in octets.1.3.6.6.1.0 is translated to 1.2.2.6.2. An estimate of the interface's current bandwidth in bits per second.1.13 The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. 78 de 143 23/02/10 12:25 .1. The type of interface.3.2.2.e. 1.6.1.2.1.2.3. 1.3.2.1.com/documentation/1. Step 4 Define an action for removing lost servers.18 1.1.2. Advanced SNMP Monitoring 1.3. 1. One possible reason for discarding such a packet could be to free up buffer space.1.2. ifIndex.1.2. 1.3.2. The current administrative state of the interface.1.1.2.3.2.1. A textual string containing information about the interface.1.1.2.2..1.2.1.1.8 A unique value for each interface.2. distinguished according to the physical/link protocol(s) immediately `below' the network layer in the protocol stack.1.2.1.2.3.3.2.1.1.3.1. including those that were discarded or not sent.2.2.1.2.6.1.10 The total number of octets received on the interface. 1.broadcast or subnetwork-multicast) packets delivered to a higher-layer protocol. 12.6. ifIndex is translated to 1.2.2. For example.2.2.0.3.2.6 1.3.5 1.1. The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted.2.3.1.1. subnetwork.3.12 The number of non-unicast (i.1.2.2.1.2.3.6.6.2.1.1.1.2.2 1.2.3. the product name and the version of the hardware interface.6.19 The total number of packets that higher-level protocols requested be transmitted to a subnetwork-unicast address. The size of the largest datagram which can be sent / received on the interface.2.2. One possible reason for discarding such a packet could be to free up buffer space.2.1 1. The table contains list of the special OIDs.1.1.1.7 1.zabbix.1.2.1.2.8:complete http://www.6.1.1.6.17 The total number of octets transmitted out of the interface.8/compl.2.1.2.1.1.6.

when all Agents and Proxies report to one Zabbix server and all data is collected centrally. 12. Use of dynamic indexes Dynamic indexes are supported since Zabbix version 1. The index will be appended to the Data OID in order to receive value we are interested in: HOST-RESOURCES-MIB::hrSWRunPerfMem."ifDescr". etc). 5388. can be executed manually from ZABBIX GUI See corresponding sections of the Manual for more details. Method of processing.5389 HOST-RESOURCES-MIB::hrSWRunPerfMem. use of Zabbix Proxies is the easiest way of implementing centralized and distributed monitoring.1. Sun hardware. ifOutQLen 1. Another example. 13. Dynamic index lookup and data retrieval is performed in single connection since Zabbix version 1. etc).3.21 The length of the output packet queue (in packets). See configuration of hosts for more details.7. a host must be configured to process IPMI commands."<base OID of index>".2..zabbix.8/compl. 79 de 143 23/02/10 12:25 .5388 HOST-RESOURCES-MIB::hrSWRunPerfMem. 13. to get the ifInOctets value for the GigabitEthernet0/1 interface on a Cisco device. use the following OID: ifInOctets["index". IPMI actions Two types of actions can be defined: automatic actions..com/documentation/1.3..5392 = = = = = = = INTEGER: INTEGER: INTEGER: INTEGER: INTEGER: INTEGER: INTEGER: 528 KBytes 528 KBytes 31468 KBytes 31740 KBytes 32116 KBytes 30420 KBytes 32560 Kbytes Dynamic indexes are cached since Zabbix version 1.."<string to search for>"] For example.7. Description string to search for The string is used for exact match with a value when doing lookup.5376 HOST-RESOURCES-MIB::hrSWRunPerfMem.6. 14. Using dynamic indexes leads to more SNMP queries in Zabbix versions up to 1. A special syntax for item OID can be used in order to deal with dynamic data (random IDs of network interfaces. IPMI agent's IP address.1.5377 HOST-RESOURCES-MIB::hrSWRunPath. IMPI parameters ZABBIX IPMI monitoring works only for devices having IPMI support (HP iLO.5389 . 13. Currently one method is supported index – search for index and append it to the base OID The OID will be used to make a lookup for the string.6.1. Monitoring of IPMI devices 13. Case sentitive.8:complete http://www. port number. user name and password must be configured properly.5388 HOST-RESOURCES-MIB::hrSWRunPath.5391 HOST-RESOURCES-MIB::hrSWRunPerfMem.3. = = = = STRING: STRING: STRING: STRING: "/sbin/getty" "/sbin/getty" "/usr/sbin/apache2" "/sbin/sshd" Now we have index.5.5377 HOST-RESOURCES-MIB::hrSWRunPerfMem.5376 HOST-RESOURCES-MIB::hrSWRunPath. In order to use IMPI monitoring.2.2.1.. HOST-RESOURCES-MIB::hrSWRunPath. getting memory usage of apache process: HOST-RESOURCES-MIB::hrSWRunPerfMem["index". which are executed automatically IPMI scripts. shutdown. The syntax: <base OID of data>["index".1. "/usr/sbin/apache2"] . Also.5390 HOST-RESOURCES-MIB::hrSWRunPerfMem. halt.2.. and other commands can be executed either automatically or manually from ZABBIX front-end. Use of Proxies Zabbix Proxies may greatly simplify maintenance of Zabbix environment and increase performance of the central Zabbix server."GigabitEthernet0/1"] Parameter base OID of data index base OID of index Base OID to use for data retrieval. Goals There are several goals of Zabbix IPMI monitoring: Monitoring of health and availability of IPMI devices Remote IPMI based management functions Remote restart.2."HOST-RESOURCES-MIB::hrSWRunPath".

Works independently Easy maintenance No Yes Automatic DB creation No Yes Local administration Yes No No Yes Ready for embedded hardware One way TCP connections Yes Yes No Yes Centralised configuration Generates notifications Yes No Lightweight GUI Node No Proxy Yes Yes Yes No Yes 3. Configuration Every host can be monitored either by Zabbix Server or by Zabbix Proxy. the Proxy will perform gathering of performance and availability data for the host.. several considerations must be taken into account. Distributed Monitoring Zabbix can be configured to support hierarchical distributed monitoring. This is configured in host definition screen: If a host is configured to be monitored by a Proxy. Why use Proxy? Zabbix Proxy can be used for many purposes: Offload Zabbix Server when monitoring thousands of devices Monitor remote locations Monitor locations having unreliable communications Simplify maintenance of distributed monitoring 2.zabbix. Goals There are several goals of the distributed monitoring: Get control of whole monitoring from a single or several locations Zabbix administrator may control configuration of all Nodes from a single Zabbix WEB front-end.1.s.com/documentation/1.. Hierarchical monitoring This is for monitoring of complex multi-level environments. Proxy v.8/compl. 14. Node When making a choice between use of a Proxy or a Node. 15.8:complete http://www. The data will be collected by the Proxy and sent to Zabbix Server for further processing.1. 80 de 143 23/02/10 12:25 .1. 15.

Each Node has its own configuration and works as a normal Zabbix Server. Configuration of Child Nodes can be done in off line mode.3. install Zabbix frontend and binaries. Description Do not keep history older than (in sec) For non local historical data only.conf: 81 de 143 23/02/10 12:25 . Default is 10051.5. Port: 10051 Child Node IP: 192. Each Node is responsible for monitoring of its own Location. Zabbix won't keep history of the node longer than N seconds.3.2. Overview Zabbix provides effective and reliable way of monitoring distributed IT infrastructure.zabbix. Zabbix supports up-to 1000 (one thousand) Nodes in a distributed setup. Node IP address. New Nodes can be attached to and detached from the Zabbix distributed setup without any loss of functionality of the setup. No restart of any Node required.3.3. Central Node will have total control over configuration of Child Node. 15. Configuration of Nodes Parameters of a Node: Parameter Name Id Type Time zone IP Port Unique node name. ZABBIX won't keep trends of the node longer than N seconds. 15.8:complete Monitor large complex environments This is especially useful when monitoring several geographical locations. Child Node will report to central node events. Hierarchical distributed monitoring allows having tree-like structure of Nodes. Follow standard installation instructions to create database.. All Nodes may work even in case of communication problems.1.8/compl. Do not keep trends older than (in sec) For non local trend data only. Configuration of the whole distributed setup can be done from a single location via common WEB interface. Central Node IP: 192. Local – Local node Remote – Remote node Time zone of the Node. Step 2 Setup NodeID in server configuration file.2. Port: 15052 For Central Node Step 1 Install Zabbix. Zabbix trapper must be listening on this port number.2.com/documentation/1. when there are no connectivity between Master and Child Node. Node can be configured either locally or by its Master node which has a copy of configuration data of all Child Nodes. In file zabbix_server. Central Node will have NodeID=1. Child Nodes will optionally send the data to Master Node.e. Unique Node ID. Zabbix trapper must be listening on this IP address. Simple configuration Our simple configuration consists of a Central Node and a Child Node. Offload the overhead from busy Zabbix server Monitoring thousands of hosts using single Zabbix server? This may be for you! http://www. Node Port number.3.168. history and trends.1. 15. Zabbix automatically converts time stamps to local timezone when transferring time related data across nodes. Each Node reports to its Master Node only. while Child Node's NodeID=2. Historical information and events are stored locally.168. When communication is back.. i. Configuration 15.

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

NodeID=1

Step 3 Convert database data. Zabbix server has to be executed to convert unique IDs for use by first node.
cd bin ./zabbix_server -n 1 -c /etc/zabbix/zabbix_server.conf Converting tables .................................................................. done. Conversion completed.

This should be executed only once. This option is not required to start Zabbix server! Step 4 Configure Node parameters.

Step 5 Add child node.

Step 6 Start Master Node. We should see NodeID in startup messages of server log file:
31754:20070629:150342 server #16 started [Node watcher. Node ID:1]

For Child Node Step 1 Install Zabbix. Follow standard installation instructions to create database, install Zabbix frontend and binaries. Step 2 Setup NodeID in server configuration file. In file zabbix_server.conf:
NodeID=2

Step 3 Convert database data. Zabbix server has to be executed to covert unique IDs for use by first node.
cd bin ./zabbix_server -n 2 -c /etc/zabbix/zabbix_server.conf Converting tables .................................................................. done. Conversion completed.

This should be executed only once. This option is not required to start Zabbix server! Step 4 Configure Node parameters.

82 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

Step 5 Add master node.

Step 6 Start Child Node. We should see NodeID in startup messages of server log file:
27524:20070629:150622 server #9 started [Node watcher. Node ID:2]

Does it work? Selection of active nodes will appear automatically after nodes are defined:

Add host for monitoring for Child Node node and see events coming to Master Node:

83 de 143

23/02/10 12:25

1.8:complete

http://www.zabbix.com/documentation/1.8/compl...

15.3.3. More complex setup
The setup consists of seven Nodes. Each Node may be configured either locally (using local WEB interface) or from one of its Master Nodes.

In this example, Riga (node 4) will collect events from all child nodes. It may also optionally collect historical information as well.

15.4. Platform independence
A node may use its own platform (OS, hardware) and database engine independently of other nodes. Also child nodes can be installed without ZABBIX frontend. It may be practical to use less powerful hardware with ZABBIX Server running SQLite or MySQL MyISAM while nodes of higher levels may use combination of a better hardware with MySQL InnoDB, Oracle or PostgreSQL backend.

15.5. Configuration of a single Node
Every Node in distributed environment must be properly configured to have a unique Node ID. Additional steps Step 1 Follow standard installation procedure. Follow standard installation procedure but do not start Zabbix Server. Zabbix front end must be installed and configured. Zabbix database must be created and populated with data from data.sql. Step 2 Configure zabbix_server.conf. Add NodeID to Zabbix Server configuration file. NodeID must be a unique Node ID. Step 3 Configure Master and Child Nodes. Use Zabbix Frontend to configure details of Nodes having direct communication with the Node. Make sure that all IP addresses and port numbers are correct. Step 4 Start Zabbix Node. Start ZABBIX Server:

84 de 143

23/02/10 12:25

.. Master Node must be powerful enough to process and store not only local data but also data received from its all Child Nodes.com/documentation/1. 15. Firewall settings Inter-node communications use TCP protocol only. This can be useful for protection of Zabbix database from any changes initiated by users. Child to Master Each Child Node periodically sends configuration changes. etc) exists only locally. Every 10 seconds. 16.7. Data Frequency Configuration changes Every 120 seconds. Data flow Source port Destination port 10051 10051 Child to Master Any Master to Child Any This is default port used by Zabbix trapper process. Maintenance mode for Zabbix GUI Zabbix GUI can be temporarily disabled in order to prohibit access to the front-end. Zabbix database can be stopped while Zabbix GUI is in the maintenance mode.1. 15. All information available in the GUI belongs to the selected node. Data Frequency Configuration changes Every 120 seconds.8:complete http://www.2. thus protecting integrity of database.. It displays current node. For example.7./zabbix_server If everything was configured properly. historical data and events to its Master Node. Configuration 85 de 143 23/02/10 12:25 . Performance considerations Any node requires more processing resources in a distributed setup. Zabbix does not send configuration of a Master Node to Childs. shell> . Data flow 15.zabbix. Master to Child Each Master Node (a node with at least one child) periodically sends configuration changes to Child Nodes either directly or via other Child Nodes directly connected to the Master Node. 11656:20061129:171614 NODE 2: Sending data of node 2 to node 1 datalen 3522738 11656:20061129:171614 NODE 2: Sending data of node 2 to node 1 datalen 20624 . Zabbix does not send operational data across the nodes. 15. 15.7..1.6. Sending of Events and History can be controlled by configuration parameters NodeNoEvents and NodeNoHistory. Goals There are several goals of the maintenance mode: Protect Zabbix database from any changes initiated by users Perform database maintenance Inform users about reason of the maintenance work Users from a range of IP addresses will be able to work with the GUI during the maintenance mode normally Automatic return to normal mode when maintenance is over 16. 15. a list of available child nodes is accessible in right-upper corner of the GUI. 16. Events History Every 10 seconds. item-related information (last check. Zabbix node will automatically start configuration and data exchange with all nodes in distributed setup. last value.8/compl.1.7. You may see the following messages in server log file: . Trends are calculated locally based on received historical data.. Child Node will resend data in case of communication problems.3. Network communications must be also fast enough for timely transfer of new data.2..8. Switching between nodes When connecting to a node in distributed setup.

17. items.1). In order to enable maintenance mode..php must be modified to uncomment the following lines: // Maintenance mode define('ZBX_DENY_GUI_ACCESS'.168. Step 3 86 de 143 23/02/10 12:25 . The file can be based on existing CSS files coming with Zabbix.0. etc) sound alarm can be switched on and off in Status of Triggers view a new theme can be created to match your preferences or a company color schema 17. WEB Interface There are several useful features of ZABBIX WEB interface: almost all screens support full-screen mode Ctrl + Mouse click make possible selection of multiple list elements (hosts. disabled otherwise Connections from these IP addresses will be allowed with no maintenance mode. Zabbix provides number of predefined themes. file conf/maintenance.0.1.8/compl.zabbix.1').. you may take Black&Blue CSS file from styles/css_bb. // IP range.1. into directory styles/. Step 2 Place the new CSS file into correct location.1. css_new. The file you created. 16. Step 1 Create your own CSS file. Feel free to share result of your work with Zabbix community if you created something nice. Parameter ZBX_DENY_GUI_ACCESS Details Enable maintenance mode: 1 – maintenance mode is enabled.8:complete http://www. For example. who allowed to connect to FrontEnd $ZBX_GUI_ACCESS_IP_RANGE = array('127.com/documentation/1. How it looks like The following screen will be displayed while in maintenance mode.conf. // MSG showed on Warning screen! $_REQUEST['warning_msg'] = 'Zabbix is under maintenance.3. triggers. You may follow this step-by-step procedure in order to create your own.css. The screen is refreshed every 30 seconds in order to return to normal state withiout user intervention when maintenance is over.css and create new css_new. Creating your own theme By default.1-255 warning_msg Informative message.css.'. ZBX_GUI_ACCESS_IP_RANGE For example: 192.

css'.1. http://www.in that case make sure to prefix it with S_.com/documentation/1. You should not omit apostrophes. Note that disabled scenarios are not displayed by default.php file: $combo_theme->addItem('css_new.css. There are two pieces of code that have to be amended. $cmbTheme->AddItem(ZBX_DEFAULT_CSS.8/compl. Open this file for editing.S_SYSTEM_DEFAULT).css'.S_BLACK_AND_BLUE).2.2. 87 de 143 23/02/10 12:25 .1.css'. search for css_bb. Modified code: $cmbTheme = new CComboBox('theme'.1.inc. you may either set this theme to be a default one or change your theme in user profile.zabbix. WEB The screen can be used to manage monitoring of WEB scenarios. Step 5 Activate new theme.$theme).1. 17.'MY_COOL_THEME').2. Step 4 You should also add your new theme to the config.. If you want your theme name to be translatable.8:complete Edit include/forms.S_BLACK_AND_BLUE). Update interval Status Frequency of execution of the WEB scenario. $cmbTheme->AddItem('css_bb.S_ORIGINAL_BLUE). Description Number of steps Number of individual steps (HTTP requests) the scenario consists of.S_SYSTEM_DEFAULT). $cmbTheme->AddItem('css_new. $cmbTheme->AddItem('css_ob.S_ORIGINAL_BLUE). Status of the scenario: Active – the scenario is active Disabled – the scenario is disabled. $cmbTheme->AddItem('css_ob. Enjoy new look and feel! 2 Comments 17.$theme). as that will result in warnings. but the new example uses string (enclosed in apostrophes). Note that original themes use constants. $cmbTheme->AddItem('css_bb. Configuration 17. Displayed data: Parameter Name Unique name of a WEB scenario.css'.css'.'MY_COOL_THEME').php.. Original code: $cmbTheme = new CComboBox('theme'. you must add the constant used for name in locale files . List of WEB scenarios It provides list of active WEB scenarios.css'. In Zabbix GUI. $cmbTheme->AddItem(ZBX_DEFAULT_CSS.

1.com/documentation/1. Agent Client agent string.2.. Useful when WEB site returns different content for different browsers.2.. Description Update interval (in sec) Frequency of execution of the WEB scenario. 88 de 143 23/02/10 12:25 . Status of the scenario: Active – the scenario is active Disabled – the scenario is disabled. List of variables (macros) that can be used in scenario steps (URL and Post variables).2.3.1. Note that disabled scenarios are not displayed by default. Zabbix will automatically replace them with actual values. List of steps executed by the scenario: Name – step name Timeout – timeout URL – location to connect to Required – required string Status – step status Status Variables Steps 17.8:complete http://www. Configuration parameters: Parameter Application Name Host application the scenario is linked to. WEB scenarios configuration The screen is used to define parameters of an individual WEB scenario.zabbix.1. WEB step configuration The screen is used to define parameters of each individual step of the WEB scenario. It has the following format: {macro1}=value1 {macro2}=value2 For example: username=Alexei password=kj3h5kJ34bd The macros can be referenced as {username} and {password}. MS Explorer or any other application. 17. Unique name of the WEB scenario.8/compl. Zabbix will pretend that it is Firefox.

com [https://www.google. List of Hosts The screen provides a list of monitored hosts. GET variables can be passed in the URL parameter.zabbix.com] List of POST variables.google.8/compl. Required string. no check is performed.2. the step will fail.2.. Retrieved content (HTML) must contain this string. Description List of expected HTTP codes. URL to connect and retrieve data.1. For example: http://www. For example: 200.1.2.zabbix.com] https://www. no check is performed.8:complete http://www. If Zabbix gets a code which is not in the list.2.201.com [http://www.210-299 17.zabbix.. Configuration parameters: Parameter Name URL Post Timeout Required Unique step name. Displayed data: 89 de 143 23/02/10 12:25 . otherwise the step will fail. If empty.com/documentation/1. Status codes If empty. Hosts The screen is used to manage host related information. Zabbix will not spend more than Timeout second on processing the URL. Hosts 17.

8/compl.. Parameter Name DNS IP Port Templates Status Unique host name. Description Zabbix Agent port number. It is a very effective way of changing attributes for a number of hosts.8:complete http://www.. Host configuration The screen give access to host details. List of templates linked to the host. It is ignored by Zabbix if no agent used.zabbix. 90 de 143 23/02/10 12:25 . Host mass-update screen The screen is accessible by selecting hosts and clicking on button “Mass update”.com/documentation/1. Host Status: Monitored – Host is active and being monitored Disabled – Host disabled Agent (Zabbix.1. SNMP) availability: Availability Available – agent is up and running Unknown – agent is not available Error Any errors related to use of agent based checks. Host DNS name if used. Host IP address if used.

Status Link with template Use IPMI IPMI IP address IPMI port IPMI privilege level IPMI username IPMI password Use profile Link host with one or more templates. Optional host DNS name. New group can be created and linked to the host. User. but preserve information about items.. 91 de 143 23/02/10 12:25 . Templates The screen is used to manage host templates. triggers and graphs will be inherited from the templates. Port number of the IPMI device. Information about items. Keep default setting here. triggers and graphs Unlink and clear – unlink from template and remove all information inherited from the template Enable IMPI management functionality for this host. Templates List of hosts linked to this template.8/compl.com/documentation/1. IP address of IPMI management device. Template configuration The screen give access to template details. User name for authentication. The host can be monitored either by Zabbix Server or one of Proxies: (no proxy) – host is monitored by Zabbix Server Proxy name – host is monitored by Proxy “Proxy name” Host status: Monitored – Host is active. Zabbix server will use this setting to retrieve data from agents: DNS name – Connect to host DNS name IP address – Connect to host IP (recommended) Zabbix agent TCP port number.2.2. if empty.2. Unlink – unlink from template.1. 17. List of Templates The screen provides list of templates. Ignored.. thus not monitored Description http://www. Password for authentication. Use extended profile Enable or disable use of extended Host profile. Default value is 10050. Displayed data: Parameter Name Description Template name. Enable or disable use of Host profile.zabbix. ready to be monitored Not monitored – Host is not active. List of host groups the host belongs to. Optional host IP address.8:complete Configuration parameters: Parameter Name Groups New group DNS name IP address Connect to Port Monitored by proxy Unique host name.

2.3. Description 92 de 143 23/02/10 12:25 . triggers and graphs will be inherited from the templates. New group can be created and linked to the template.com/documentation/1. Configuration parameters: Parameter Name Groups New group Link with template Unique template name.zabbix. Displayed data: Parameter Name Unique Proxy name.1.8:complete http://www. List of Proxies The screen provides list of proxies. Proxies The screen is used to manage proxies. Link template with one or more templates.. List of host groups the template belongs to.. Description 17. if empty. Ignored. Information about items.2.8/compl.

2. Displayed data: 93 de 143 23/02/10 12:25 .zabbix.8:complete http://www.com/documentation/1..1. Hosts List of hosts monitored by this Proxy.8/compl. List of Host Groups.. Members List of hosts monitored by this Proxy. 17. The screen provides list of host groups. Proxy configuration The screen gives access to proxy details.2.4. Last seen (age) Last time we received a heart beat message or data from the Proxy. Configuration parameters: Parameter Description Proxy name Unique Proxy name. Host groups The screen is used to manage host groups.

94 de 143 23/02/10 12:25 . Number of group members (hosts). Hosts List of hosts.2.5. 17.8/compl. List of Templates The screen provides list of template and linked hosts. Template linkage The screen is used to manage host template linkage.com/documentation/1.. members of the group. List of host group members.8:complete http://www. Configuration parameters: Parameter Description Group name Unique host group name.zabbix. Parameter Name # Members Description Host Group name.2.1. Host group configuration The screen provides access to host group details..

List of hosts linked to the template.6. Hosts List of hosts linked to the template.com/documentation/1..8/compl. Configuration parameters: Parameter Template Hosts Description Template name. Applications The screen is used to manage applications. 95 de 143 23/02/10 12:25 . List of Applications The screen provides list of applications.8:complete Displayed data: Parameter Description http://www. 17. Template linkage The screen give access to management of host template linkage.1.2.. Templates Host template name.zabbix.2.

1. Must be unique within one host. Description http://www.. Show Link to host items. Items The screen is used to manage item related information.zabbix.1.3.8:complete Displayed data: Parameter Application Application name. Configuration parameters: Parameter Name Hosts Description Application name. Host name the application is linked to. Configuration of application The screen give access to management of applications. Items 17.com/documentation/1.3. also displays number of items (members of the application). List of Items The screen provides list of items linked to a host..2. 96 de 143 23/02/10 12:25 .8/compl. 17.2.

8:complete http://www. List of applications the item belongs to. Item mass-update screen The screen is accessible by selecting items and clicking on button “Mass update”.zabbix. Item status.8/compl. Number of days Zabbix keeps trends data. Click on a parameter you would like to change.. Item type. Displayed data: Parameter Description Key Description Item description (name). Any errors related to this item. History Trends Type Status Applications Error Number of days Zabbix keeps detailed historical data.. Update interval Frequency of the check. Copy selected to… 97 de 143 23/02/10 12:25 .1. Unique item key. It is very effective way of changing attributes of a number of items. enter new value and press “Save”.com/documentation/1.

zabbix.size[/.…$9 – first. Item attributes: Parameter Description Item description. Type of data as stored in the database after performing conversions. It may contain this macros: $1. if any. the description will be automatically changed to “Free disk space on /” Item type. Item key.. http://www. if key type is Zabbix Agent. Numeric (unsigned) – 64bit unsigned integer Numeric (float) – floating point number Character – character (string) data limited to 255 bytes Description Type Key Type of information 98 de 143 23/02/10 12:25 . Select hosts you would like to copy items and press “Copy”.8:complete The screen makes possible copy of a selected item to a number of hosts. The key must be unique within a single host. or Zabbix aggregate.. second.… ninth parameter of item key For example: Free disk space on $1 If item key is “vfs. Item configuration The screen provides access to configuration of a single item.$2.fs. Zabbix Agent (active). See sections below for detailed description of each type. The key value must be supported by an agent or Zabbix server.com/documentation/1. Simple check.8/compl.free]”.1.

additionally supported prefixes include: T (Tera). it is for displaying data only.1. bps . max. 17. M (Mega). Supported placeholders: * M: Month (00-12) * m: Minute (00-59) * h: Hour (00-24) * y: Year (0001-9999) * s: Second (00-59) * d: Day (01-31) * Blank means use unix timestamp Link item to one or more applications.1 Zabbix supports the following unit prefixes: K (Kilo). Zabbix will process this item.8/compl. P (Peta). E (Exa). hh:mm:dd”. As is – no pre-processing Delta (speed per second) – evaluate value as (value-prev_value)/(time-prev_time). Period format: dd-dd. MBps.1. See below for supported units.Sunday Data type Units Use multiplier Custom multiplier Update interval (in sec) Flexible intervals Keep history (in days) Keep detailed history N days in the database. Multiply all received value by this integer or floating-point value. count) detailed history N days in the database. where value – current value value_prev – previously received value time – current timestamp prev_time – timestamp of previous value This setting is extremely useful to get speed per second based on constantly growing value. Active . Disabled – item is disabled. Status Store value Show value Log time format Applications Until version 1. Otherwise Zabbix cannot correctly set prefixes (K.. Triggers 17. Y (Yotta). special processing for bits.dd-dd. Not supported – item is not supported by Zabbix or SNMP agent.09:00-18:00 – refresh set to 10 seconds for working hours. s – translated to “yyymmmdddhhhmmm”. M and G). if units set to 'B'. unixtime – translated to “yyyy.do not pre-process received values Custom multiplier – multiply received values by value defined in Custom multiplier Use this option to convert values received in KB.2. Available for items of type Log only. parameter is treated as number of seconds since 01/01/1970. “Windows service states”.2. 1-5. Otherwise default update interval will be used.8. For example. Delta (simple change) – evaluate as (value-prev_value). If set. Zabbix will add prefix if required and the unit postfix to all received values (1024 is 1K). Older data will be removed by Housekeeper. Keep trends (in days) Keep aggregated (hourly min. Do not use . For example: 10 sec. Text – text of unlimited size The data type is used for integer items in order to specify expected data type.2. Value mapping does not change received values. Decimal – data in decimal format Octal – data in octal format Hexadecimal – data in hexadecimal format Zabbix will automatically perform conversion to numeric. It works with integer items only. This is supported starting from version 1. Triggers The screen is used to manage triggers. For example.dd hh:mm:ss” uptime – translated to “hh:mm:ss” or “N days. Older data will be removed by Housekeeper. avg. however Zabbix may try to periodically set status of such items to Active if configured. …. 99 de 143 23/02/10 12:25 .zabbix. Log – log file. This item will not be processed. 2y10m14d3h54m1s Pre-process received values.1000 is 1K. This item will not be processed. etc into B. Bps. 1-5.mm. Since version 1.09:00-18:00.8:complete http://www.active (normal) status.10:00-12:00 1 .6-7. List of exceptions for Update Interval. See more details about items in other sections of the Manual.8.5KB Some units have special processing: b. where value – current value value_prev – previously received value Apply value mapping to this item.Monday. Refresh this item every N seconds.4.. Z (Zetta).hh:mm-hh-mm For example. Must be set for keys log[].com/documentation/1.4. G (Giga).7 . parameter is treated as number of seconds since 01/01/1970. For example. Zabbix will display: 1 as 1B 1024 as 1KB 1536 as 1.8.hh:mm-hh:mm. List of Triggers The screen provides list of triggers linked to a host.

enter new value and press “Save”. 100 de 143 23/02/10 12:25 . Copy selected to… The screen makes possible copy of a selected trigger to a number of hosts. It is very effective way of changing attributes of a number of triggers.com/documentation/1. Trigger name. Trigger mass-update screen The screen is accessible by selecting triggers and clicking on button “Mass update”. Note that Disabled triggers are hidden by default. Click on a parameter you would like to change. Trigger status.8/compl.1.zabbix.8:complete http://www.. Description Expression Trigger expression.. Displayed data: Parameter Severity Status Name Coloured trigger severity.

zabbix... Trigger configuration The screen provides access to configuration of a single trigger.com/documentation/1. May contain instructions for fixing specific problem.8:complete http://www. Logical expression used for calculation of trigger state.8/compl. on TRIGGER status change Normal + Multiple TRUE events – events are also generated on every TRUE evaluation of the trigger Trigger severity. If not empty. etc. See more details about triggers in other sections of the Manual. Trigger can be disabled if required. the URL is used in the screen 'Status of Triggers'. contact detail of responsible staff. Normal – events are generated normally. Select hosts you would like to copy items and press “Copy”. New dependency Event generation Severity Comments URL Disabled Add new dependency. Trigger attributes: Parameter Name Expression Trigger name. Description The trigger depends on List of triggers the trigger depends on. 101 de 143 23/02/10 12:25 . Text field used to provide more information about this trigger. The name may contain macros.1.

1. List of Actions The screen provides list of actions.5. 17. Conditions List of conditions for this action.com/documentation/1. Actions 17. Actions The screen is used to manage actions.5.8:complete http://www.zabbix. 102 de 143 23/02/10 12:25 .2. Action configuration The screen provides access to configuration of a single action. Status Status of the action..1.2.. Displayed data: Parameter Name Description Action name. Operations List of operations for execution.8/compl.

6. conditions and operations in other sections of the Manual.8/compl.6. Graph height in pixels.. Graph width in pixels..1. 17. Graphs 17.com/documentation/1.1. Displayed data: Parameter Name Width Height Description Graph name.2. See more details about configuration of actions. 103 de 143 23/02/10 12:25 . Graphs The screen is used to manage custom graphs.8:complete More configuration options are available if escalation is enabled: http://www.zabbix. List of Graphs The screen provides list of graphs.2.

Enable 3D style. Exploded – exploded pie graph. Comments Text field used to provide more information about this trigger. values displayed as lines. contact detail of responsible staff. Normally used for displaying 95% percentile..com/documentation/1. Graph height in pixels.8/compl. Y axis type 3D view Legend Items Graph element: 104 de 143 23/02/10 12:25 . For Pie graphs only..zabbix. List of graph elements (items) to be displayed for this graph. Display percentile for left Y axis. Display legend. simple triggers will be displayed as red lines. Graph type: Normal – normal graph. Pie – pie graphs. May contain instructions for fixing specific problem.8:complete http://www. Stacked – stacked graph. Type of Y axis: Calculated – Y axis value will be automatically calculated Calculated [min=0] – Y min value is set to 0. Graph type: Normal Graph type Stacked Pie Pie exploded Graph configuration The screen provides access to configuration of a single custom graph. maximum value will be automatically calculated. If selected.1. non-working hours will be shown with gray background. Graph width in pixels. For Pie graphs only. Normally used for displaying 95% percentile. If selected. Fixed – fixed min and max value for Y axis. Graph attributes: Parameter Name Width Height Unique graph name. Description Graph type Show working time Show triggers Percentile line (Left) Percentile line (Right) Display percentile for right Y axis. etc.

Screens The screen is used to manage screens. Screens 17. average and maximum) Min – minimum only Avg – average only Max – maximum only Draw style: Line – draw lines Filled region – draw filled region Bold line – draw bold lines Dot – draw dots Dashed line – draw dashed line RGB color in HEX notation..8:complete http://www.7.1. Type: Simple Aggregated What values will be displayed. 105 de 143 23/02/10 12:25 . used when more than one value exists for a single pixel (X-coordinate): All – all (minimum. 0 will be processed first.. which will be displayed.com/documentation/1.1.2. Draw order. Attributes of a graph element: Parameter Parameter Type Description Selection of host item.zabbix. List of Screens The screen provides list of screens. 17.2. Function Draw style Color Aggregated periods count Y axis side Sort order (0→100) What Y axis side the element is assigned to.8/compl.7.

106 de 143 23/02/10 12:25 . number of columns and rows.8/compl... Screen configuration (screen elements) The screen provides access to configuration of a single screen giving access to configuration of all elements.com/documentation/1. Description Dimension (cols x rows) Screen size.zabbix. Number of rows in the screen. Number of columns in the screen.8:complete http://www.1. Screen configuration (high-level) The screen provides access to configuration of a single screen. Screen high-level attributes: Parameter Name Columns Rows Description Unique screen name. Parameter Name Screen name.

8:complete http://www.com/documentation/1. Screen high-level attributes: Parameter Description Information displayed in the cell: Clock – digital or analog clock displaying current server or local time Data overview – latest data for a group of hosts Graph – single custom graph History of actions – history of recent actions History of events – latest events Hosts info – high level host related information Map – single map Plain text – plain text data Screen – screen (one screen may contain other screens inside) Server info – server high-level information Simple graph – single simple graph Triggers info – high level trigger related information Triggers overview .status of triggers for a host group URL – include content from an external resource Possible values: Center Left Right Resource Horizontal align 107 de 143 23/02/10 12:25 ..zabbix. Click on a screen element (cell) to change what information should be displayed in the screen cell.8/compl..1.

Map height in pixels. Vertical align Possible values: Middle Top Bottom Extend cell to a number of columns.8:complete http://www.2.. 108 de 143 23/02/10 12:25 . same way as HTML column spanning works.8.com/documentation/1.1.2. Maps 17. Extend cell to a number of rows. Displayed data: Parameter Name Width Height Description Map name Map width in pixels. Column span Row span 17.8.8/compl. Map configuration (high-level) The screen provides access to configuration of a user-defined screen.. List of Maps The screen provides list of maps. same way as HTML row spanning works. Maps The screen is used to manage user-defined maps.1.zabbix.

Map high-level attributes: Parameter Name Width Height Background image Icon highlighting Expand single problem Unique map name. problem name is used.zabbix.com/documentation/1. Map elements will receive highlighting.1. For upgrades from previous installations it is enabled by default on all maps. or problem count. This option is available since Zabbix 1. round background will be used. Use background image: No image – no background image (white background) Image – selected image to be used as a background image. Map height in pixels.8. List of map elements (icons): 109 de 143 23/02/10 12:25 .no icon labels are displayed Display icon label on: Bottom – bottom (under the icon) Left – left side Right – right side Top – top of the icon Description Icon label type Icon label location Map configuration (configuration of map elements) The screen provides access to configuration of map icons and links.8/compl.1. Map width in pixels.. this option controls whether problem (trigger) name is printed.8:complete http://www. If a map element (host. square background will be used. This option is available since Zabbix 1. having same colour as the highest severity trigger. host name) Status only – status only (OK or PROBLEM) Nothing .. Label type used for all map icons: Label – icon label only IP address – IP address only Element name – element name (for example. If element status is “disabled” or “in maintenance”.8. No scaling is performed. If element has an active trigger. host group or another map) has a single problem. If marked.

110 de 143 23/02/10 12:25 .1.com/documentation/1..8/compl..8:complete http://www. List of links: Configuration of map element The screen provides access to configuration of a single map element.zabbix.

8/compl.8:complete http://www. Configuration of a link The screen provides access to configuration of a link. the URL will be used when an user clicks on the screen element. X coordinate for the map element. Macros and multi-line string can be used in labels starting from version 1.8 Label location: Default – Map's default label location Bottom – bottom (under the icon) Left – left side Right – right side Top – top of the icon Status of triggers of this hosts will be used. Status of this triggers will be used.zabbix. Status of all elements of this map will be used. Icon (disabled) Coordinate X Coordinate Y URL Icon to be used if the selected host is disabled. Icon to be used in case of problems (one or more). Type Label Label location Host Map Trigger Host group Icon (ok) Icon (problem) Icon (unknown) Icon to be used in case of problems (one or more).. Y coordinate for the map element. Map element attributes: Parameter Description Type of the element: Host – icon representing status of all triggers of the selected host Map – icon representing status of all elements of a map Trigger – icon representing status of a single trigger Host group – icon representing status of all triggers of all hosts belonging to Image – just an icon not linked to any resources Icon label.com/documentation/1.. 111 de 143 23/02/10 12:25 . If set. Icon to be used when no problem exists. any string.1. Status of all triggers of this host group will be used.

Default link style: Line – single line Bold line – bold line Dot – dots Dashed line – dashed line Default link colour. You can use macros here.9.1..2.8:complete http://www. its style is applied to the link. Second element that link connects. Map link attributes: Parameter Label Element 1 Element 2 Description Label that will be rendered on top of the link.1. List of IT Services The screen provides list of IT Services.. Link status indicators List of triggers linked to the link. In case if a trigger has status PROBLEM.2.9. Type (OK) Colour (OK) 17. IT Services 17.com/documentation/1. First element that link connects.zabbix.8/compl. IT Services The screen is used to manage IT Services. 112 de 143 23/02/10 12:25 .

For reference only. Description Status calculation How the service updates its status. IT Service attributes: Parameter Name Parent service Service name.com/documentation/1. Description 113 de 143 23/02/10 12:25 . Trigger Linked to a trigger: none – no linkage trigger name – linked to the trigger..8:complete http://www. Displayed data: Parameter Service Service name. thus depends on the trigger status IT Service configuration The screen provides access to configuration of IT services. it cannot be changed. Parent service..8/compl.zabbix.1.

com/documentation/1.10. Range of IP addresses affected by the discovery rule.2. Service state within this period does not affect SLA. if it least one child has a problem – consider problem if at least one child service has a problem Problem. Service times: One-time downtime – a single downtime. Discovery 17.. List of discovery rules The screen provides list of discovery rules.8/compl. Display sort order. lowest comes first. How to calculate status of the service: Do not calculate – do not calculate service status Problem.2.. List of checks executed by the discovery rule.10. Add new service times to make exceptions. all service operates 24x7x365. Services of the lowest level must be linked to triggers. Status of the discovery rule: Active – the rule is active Disabled – the rule is disabled Discovery rule configuration The screen provides access to configuration of a discovery rule. It is used for reporting. Frequency in seconds. By default. Discovery The screen is used to manage discovery rules.8:complete http://www.1. 114 de 143 23/02/10 12:25 . if all children have problems – consider problem if all children have problems Select to display SLA data.zabbix. SLA percentage for this service. Uptime – service uptime Downtime – Service state within this period does not affect SLA. Depends on List of child services the service depends on. Status calculation algorithm Calculate SLA Acceptable SLA (in %) Service times New service time Link to trigger Sort order 17.1. Displayed data: Parameter Name IP range Delay Checks Status Description Name of discovery rule.

1. Zabbix Agent. It is used for reporting.1-100.8/compl. SNMPv1 Agent. IMAP.11.168.33 Range of IP addresses: 192. Description Who performs discovery: Discovery by proxy (no proxy) – Zabbix Server is doing discovery proxy name – This proxy performs discovery Range of IP addresses for discovery.1-255.2. NNTP.2. SNMPv2 Agent.192. Export/Import 17. TCP. SNMPv3 Agent SLA percentage for this service.1.168.200 This parameter defines how often Zabbix should execute this rule in seconds.60-70 Status of the discovery rule: Active – the rule is active Disabled – the rule is disabled IP range Delay (seconds) Checks New check Port Status 17. LDAP. items.192.1.2. SMTP. Format: Single IP: 192. Discovery rule attributes: Parameter Name Unique name of the discovery rule.. Export The screen is used to export hosts.zabbix. triggers and graphs.1.com/documentation/1.1. Export The screen provides list of hosts and their elements for export.. This parameter may be one of following: Single port: 22 Range of ports: 22-45 List: 22-45.8:complete http://www.168. List of supported checks: SSH.2. FTP. HTTP. 115 de 143 23/02/10 12:25 .55.11. POP.1-255 List: 192.168.168.

com/documentation/1. Host DNS name.zabbix. Preview page: 17. Zabbix agent port number.2. Description Templates Select to export template related information.2. Host status. Import The screen is used to perform XML import of host related data.8:complete http://www. IP address of Zabbix agent. Select to export host triggers.11. then press “Preview” or “Export”.. Displayed data: Parameter Name DNS IP Port Status Host name.8/compl. Select elements you would like to export. Items Triggers Graphs Select to export host items. 116 de 143 23/02/10 12:25 ..1. Select to export host graphs.

1. Discovery rule attributes: Parameter Import file Description XML file to import. 117 de 143 23/02/10 12:25 .3.3. Administration 17. 1 Comment 17..1.com/documentation/1. General 17.3.1.8/compl.zabbix. Set of rules for each type of element: Existing – what to do if element already exists Missing – what do to if element is missing Possible actions: Update – update existing element Add – add element Skip – do not process new data Rules Press “Import” to import selected file.1. Events This screen defines event related settings.8:complete http://www..

17. jabber. This parameter defines how many days of events history Zabbix will keep in the database. Housekeeper The Housekeeper is a periodical process which is executed by Zabbix Server. Default is 7 days. etc) history Zabbix will keep in the database..8:complete http://www.3.1. Configuration parameters: Parameter Event acknowledges Show events no older (Days) Description This parameter defines if event acknowledges are activated in Zabbix interface. The process removes outdated information and information deleted by user. This parameter defines for how many days event are displayed in Status of Triggers screen. SMS. Images List of images 118 de 143 23/02/10 12:25 .zabbix. Default is 100.com/documentation/1.3.1.3. 17.1.2. Configuration parameters: Parameter Do not keep actions older than (in days) Do not keep events older than (in days) Description This parameter defines how many days of executed actions (emails. Older events will be removed..8/compl. Older actions will be removed. Mac count of events per trigger to show Maximum number of event to show for each trigger in Status of Triggers screen.

Either Icon or Background Name of local file (PNG. Image attributes: Parameter Name Type Upload Description Unique name of an image.1.ini if you have this problem. Themes 119 de 143 23/02/10 12:25 . Image definition Zabbix images are stored in the database.8:complete http://www.zabbix.5MB may not be displayed in maps.3. Backgrounds are used as background images of System Maps.4. 17. however images bigger than 1. Increase value of max_memory_size in php.8/compl.1.com/documentation/1... There are two types of images: Icon Background Icons are used in for displaying System Map elements. JPEG) to be uploaded to Zabbix Note that you may upload image of any size.

. Value mapping Value maps are used to create a mapping between numeric values and string representations.8:complete Zabbix support themes. Possible parameters: Parameter Description Default theme Theme used for all users.1.5.zabbix. Default theme is “Original blue”. Value mappings are used for representation of data in both Zabbix front-end and information sent by email/jabber/SMS/whatever.3..1. http://www.8/compl. For example. an item which has value ‘0’ or ‘1’ can use value mapping to represent the values in a human readable form: ‘0’ ⇒ ‘Not Available’ ‘1’ ⇒ ‘Available’ Value mapping can be used only for items having type ‘Unsigned integer’. 17. which are used to customize look and feel of Zabbix front-end. An user may override the default theme in user profile.com/documentation/1. Value mapping definition Parameters of a value mapping: 120 de 143 23/02/10 12:25 .

17.… Format dd hh mm Description Day of week: 1 – Monday.10:00-16:00 17.hh:mm-hh:mm. Working time has the following format: dd-dd.1. Zabbix server will not stop. it will wait until the database is back again to continue processing.8:complete http://www. Parameter Name Mapping Description Unique name of set of value mappings.com/documentation/1. a special Zabbix server process.… . Zabbix can be configured to periodically make unsupported items active.1.3. Working time is displayed as a white background. Other Refresh unsupported items Some items may become unsupported due to errors in User Parameters or possible an item is not supported by an agent. 7 – Sunday Hours: 00-24 Minutes: 00-59 Empty format is equal to 01-07..hh:mm-hh:mm. 121 de 143 23/02/10 12:25 .zabbix. Currently this is used for graphs only.6-7. New mapping Single mapping for addition. Database watchdog Availability of Zabbix server depends on availability of back-end database very much.dd-dd. Working time Working time is system-wide parameter which defines working time.09:00-18:00.. while non-working time is displayed as grey.6.8/compl.09:00-18:00 1-5. is created in order to alarm Zabbix administrators in case of disaster. 2 – Tuesday .7.00:00-23:59 For example: 1-5.3. Set of mappings. The watchdog will send notifications to a user group in case if the database is down.1. Database watchdog. It cannot work without a database.

the automatic activation will be disabled. Proxies check unsupported items every 10 minutes.2. Database watchdog is supported for MySQL only! The Administration Tab is available to users of type Super Administrators only.8:complete http://www.zabbix. HTTP The screen can be used to enable Apache based (HTTP) authentication. This is not configurable for Proxies. Authentication 17. 122 de 143 23/02/10 12:25 . Configuration parameters: Parameter Description HTTP Authentication Enabled This parameter defines if Apache based authentication is enabled. User group for database down message User group for sending alarm message or ‘None’.8/compl. If set to 0..1. The authentication will be used to check user names and passwords.2. Parameter Refresh unsupported items (in sec) Description Zabbix will activate unsupported item every N seconds.3. however his Zabbix password will not be used.3.1.com/documentation/1. 17. Note that an user must exist in Zabbix as well..

.com Port of LDAP server. The authentication will be used to check user names and passwords.zabbix.3.com/documentation/1. Default is 389. Port Base DN Search Attribute Bind DN Bind Password LDAP Authentication Enabled Enable LDAP authentication.zabbix.2.3.ou=system uid uid=Admin.. 123 de 143 23/02/10 12:25 . Configuration parameters: Parameter LDAP Host Description Name of LDAP server.3. Note that an user must exist in Zabbix as well. Zabbix LDAP authentication works at least with Microsoft Active Directory and OpenLDAP. Users 17. The user must exist in LDAP.zabbix. In case of Apache authentication all users (even with GUI Access set to Internal) will be authorised by Apache. Users The screen can be used to manage Zabbix users. For secure LDAP connection port number is normally 636. LDAP The screen can be used to enable external LDAP authentication.2.8/compl. Test Authentication Login User Password Name of a test user. LDAP password of the test user. 17. These groups must have GUI Access set to Internal. not by Zabbix! 17.com For secure LDAP server use ldaps protocol ldaps://ldap.3.1. ou=Users. Zabbix will not activate LDAP authentication if it is unable to authenticate the test user. List of users It provides list of users. however his Zabbix password will not be used.ou=system Password for binding to the LDAP server. For example: ldap://ldap. Be careful! Make sure that Apache authentication is configured and works properly before switching it on.3.8:complete http://www. Some user groups can still be authorised by Zabbix.1.

. User surname. Displayed data: Parameter Alias Name Surname Description User short-name. depends on settings of user groups: Enabled – the user is active Disabled – the user is disabled. depends on settings of user groups: System default – Zabbix. i.. Is user online. one of following: Zabbix User Zabbix Admin Zabbix Super Admin List of all group the user belong to. HTTP Authentication. User name. Access to GUI.zabbix. User type Groups Is online? GUI Access Status Actions User configuration The screen provides user details and gives control to change user attributes.com/documentation/1. login name.8/compl. The user is ignored by Zabbix. 124 de 143 23/02/10 12:25 .e. LDAP Authentication Internal – the user is authenticated by Zabbix regardless of system settings Disabled – GUI access is restricted to this user User status. User type.1.8:complete http://www.

8/compl.. URL (after login) Refresh (in seconds) Make Zabbix to transfer you to the URL after successful login. the rights depend on user group membership! The information is available read-only.e. i. one of following: Zabbix User – access to Monitoring tab only. Click on User Rights Show to display user rights. User surname. Language of Zabbix GUI.1. etc. Can be set to 0 to disable. Configuration parameters: Parameter Alias Name Surname Description User short-name. List of all group the user belong to.8:complete http://www. Zabbix Admin – access to Monitoring and Configuration tabs. screens. Browser cookies are used for this. plain text data. Set it to 0 to disable auto-logout..use system settings Original Blue – standard blue theme Black & Blue – alternative theme Enable if you want Zabbix to remember you. Must be unique! User name. 125 de 143 23/02/10 12:25 . User type Groups Media Language Theme Auto-login (1 month) Auto-logout (0 . Refresh used for graphs.disable) User will be logouted after N seconds if inactivity. The medias are used by Zabbix for sending notifications. Zabbix Super Admin – access to everything. List of all medias. login name. Defines how the GUI looks like: System Default .zabbix. User type.com/documentation/1. It is impossible to change user rights here. including Administration tabs.

8/compl.. Enabled – users are active Disabled – all users of the group are disabled Displays how the users are authenticated. List of user groups It provides list of user groups.1. Must be unique.zabbix.2.3.8:complete http://www.. Displayed data: Parameter Name User status Description Host group name.3. User Groups The screen can be used to manage Zabbix user groups. 17.com/documentation/1. System default – use default authentication Internal – use Zabbix authentication Disabled – access to Zabbix GUI is forbidden List of group members GUI Access Members User group configuration 126 de 143 23/02/10 12:25 .

8:complete http://www.4. Media types 17. Configuration parameters: Parameter Group name Users Description Unique group name. List of members of this group. How the users of the group are authenticated.com/documentation/1.3.3.. Media types 127 de 143 23/02/10 12:25 .4.. System default – use default authentication Internal – use Zabbix authentication Disabled – access to Zabbix GUI is forbidden GUI Access Status of group members: Users Status Enabled – users are active Disabled – users are disabled Three lists for different host permissions: Read-write – host groups with read-write access Read-only – host groups with read-only access Deny – host groups with deny access Rights Click on User rights (Show) to see what permissions the user group has: 17.1.1.8/compl.zabbix.

Media configuration The screen provides user details and gives control to change media attributes.8/compl. Details Configuration details.1.com/documentation/1.. List of media types It provides list of media types. Displayed data: Parameter Description Media type: Email – email notification SMS – SMS notifications sent using serial GSM modem Jabber – Jabber notification Script – script based notification Type Description Name of the media. http://www.zabbix. Configuration parameters: 128 de 143 23/02/10 12:25 .. Media type is a delivery method for user notifications. depends on media type.8:complete The screen can be used to manage Zabbix media types.

8:complete http://www. List of scripts It provides list of scripts known to Zabbix. Host access Read .com/documentation/1. 129 de 143 23/02/10 12:25 .user must have write permission for the host to execute the script.8/compl. The script is available to members of the user group only. The scripts are executed on Zabbix Server side even for hosts monitored by a proxy.serial device name of GSM modem Jabber – Jabber notification Jabber Identifier .server name SMTP Hello – Hello string. normally domain name SMTP Email – sender email address SMS – SMS notifications sent using serial GSM modem GSM Modem .1.. Parameter Description Description Unique media name.name of the custom script 17.Jabber ID Password – Password of the Jabber ID Script – script based notification Script name . Depending on permission.. Script configuration The screen provides script details and gives control to change script attributes.5.user must have read permission for the host to execute the script Write .zabbix. Zabbix user may execute a script from the front-end by clicking on host from certain screens. Command to be executed.3. Displayed data: Parameter Name Command User group Unique script name. Type Media type: Email – email notification SMTP Server . Description Host group The script is available for hosts of the host group only. Scripts The screen can be used to manage user-defined scripts.

. Full path to a command. Audit logs 130 de 143 23/02/10 12:25 . Configuration parameters: Parameter Name Unique script name. Description Command User group Host group The script is available for hosts of the host group only.user must have write permission for the host to execute the script..6.3.user must have read permission for the host to execute the script Write .DNS} {IPADDRESS} For example: /bin/ping-c 3 {HOST.8:complete http://www.8/compl.com/documentation/1. The following macros are supported here: {HOST. which will be executed on user request.1.CONN} A special syntax for IPMI commands must be used: IPMI <ipmi control> [value] For example: IPMI power off The script is available to members of the user group only. 17. Host access Read .CONN} {HOST. Audit The screen can be used to see front-end audit records and list of notifications sent to users.zabbix. The command will run on Zabbix Server side.

8:complete http://www..1. User name. 131 de 143 23/02/10 12:25 ..8/compl. Resource Action Details Audit actions The screen provides access to history of notifications and remote commands.com/documentation/1. Displayed data: Parameter Time User Description Time stamp when an action took place. Object. which was affected: Application Graph Host Item User Performed action: Added Login Logout Removed Updated More detailed information about action.zabbix.

Data is delayed for 10-30 seconds. Data is delayed for 5-10 minutes. Overview For each item type the following data is displayed: Parameter Items 5 seconds 10 seconds 30 seconds 1 minute 5 minutes Item type Data is delayed for 5-10 seconds.com/documentation/1. 132 de 143 23/02/10 12:25 . Description More than 10 minutes Data is delayed for more than 10 minutes.3. Data is delayed for 1-5 minutes.1.8/compl. 17.8:complete Displayed data: Parameter Time Type Description Time stamp when an action took place. http://www.zabbix. Queue The Queue provides information about performance of Zabbix.. Error if the notification was not sent. Type of executed operation: Notifications Remote command Status: Not sent Sent Number of retries left. Data is delayed for 30-60 seconds.7. Status Retires left Recipient(s) List of recipients. Message Error Message used in notification. Overview by proxy The view gives more detailed information about performance of Zabbix Server and Proxies..

Host name. Details The view gives very detailed information about delayed items. Notifications This is report on number of notifications sent to each user grouped by media types.com/documentation/1. 133 de 143 23/02/10 12:25 . shows statistics about local server..8:complete http://www.zabbix. The time stamps will always be in the past.8/compl.8. 17. Server. List of items is displayed with the following details: Parameter Next check Host Description Expected time stamp of next data retrieval.. Description Item name.1. For each Proxy and local Zabbix Server the following data is displayed: Parameter Proxy Description Proxy name or Server.3. displayed last.

zabbix.8/compl.9. Left side is filled with default language.1. ignore it Leave empty – if something is not translated. leave translation empty Fill with default value – if something is not translated. 17. Do not add – if something is not translated. Parameters: Parameter Take for default locale The locale will be used as a base one. Locale to extend New entries Select language you'd like to improve.3. fill translation with default value Description Translation form This form is used to translate phrases used in Zabbix front-end. Locale selection Select locale you'd like to select for further processing.. right side consists of translated phrases. 134 de 143 23/02/10 12:25 .com/documentation/1.8:complete http://www. For each user number of notifications is displayed per each media type.. Locales Locales provides functionality for easy editing of translations of Zabbix front-end.

23. kernel 2. You want to update these parameters once in 30 seconds. 1 Comment 18..0. Pentium IV 1.8/compl.0 installed (RedHat Linux 8.8:complete http://www. IDE) is able to collect more than 200 parameters per second from servers being monitored (assuming no network delays). Once translation is ready. 17. Real world configuration Server with Zabbix 1. In case if these parameters need to be updated once in a minute. These calculations made in assumption that all monitored values are retrieved 135 de 143 23/02/10 12:25 .1.4. press button “Download” to have translation file. which can be used to replace files under include/locales. each server you monitor has ten parameters to watch for. Installation The screen makes possible creation of Zabbix front-end configuration file.18-14.1. the hardware configuration will be able to handle 600×2=1200 servers.10.zabbix.5Ghz. Doing simple calculation. MySQL/MyISAM 3. Performance Tuning 18. we see that Zabbix is able to handle 600 servers (or 6000 checks).54a-4. Suppose. How many servers can be monitored by Zabbix on the hardware.com/documentation/1. one may ask? It depends on number of monitored parameters and how often Zabbix should acquire these parameters.3.. 256Mb.

contains minimum number of parameters (ideally.1. This value can be monitored by using internal check zabbix[queue]. 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.com/documentation/1. InnoDB requires more CPU power. Zabbix configuration parameters Many parameters may be tuned to get optimal performance.1.2.2.2. parallelism is increased. 18. max(3600) will be calculated significantly slower than max(60).2. Optimal number of instances is achieved when queue. then number of monitored servers can be increased even up to 5x-10x times. this may overload Zabbix tune parameters for default templates tune housekeeping parameters do not monitor parameters which return same information. For example. 'items' 'functions'.3.1. i.1. Database Engine This is probably most important part of Zabbix tuning. Example: why use system[procload].e. That is the fastest and the most secure way. Monitoring of server's availability At least three methods (or combination of all methods) may be used in order to monitor availability of a server.5 times faster (comparing to MyISAM) if InnoDB is used. in the same time. and 'trends' are most heavily used tables. DBSocket MySQL only. 18.keep value of this parameter as low as possible. Cookbook 19. 18. 'history_str.8:complete http://www. avoid use of triggers with long period given as function argument.4. as soon as required (latency is 0). Zabbix heavily depends on availability and performance of database engine. Keeping small update interval may be good for nice graphs. Every additional instance of zabbix_server adds known overhead. use fastest database engine. However. Hardware General advices 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 User fast RAID storage Use fast Ethernet adapter Having more memory is always better 18. General advices monitor required parameters only tune 'Update interval' for all items. 19. triggers'. Operating System Use latest (stable!) version of OS Exclude unnecessary functionality from kernel Tune kernel parameters 18. 18.. It is recommended to use DBSocket for connection to the database. If this is not a requirement. 0 at any given moment). keeping of MySQL temporary files in tmpfs is recommended 18.zabbix. ICMP ping (Key “icmpping”) Key “status” 136 de 143 23/02/10 12:25 . General Recipes 19.5.8/compl.2..1. for large installations. however.3. use InnoDB table structure ZABBIX works at least 1. zabbix_server StartPollers General rule .2. Performance tuning It is very important to have Zabbix system properly tuned for maximum performance. keep database tables on different hard disks 'history'.system[procload5] andsystem[procload15] if system[procload] contains all.1. on average. This is because of increased parallelism.2.2. DebugLevel Optimal value is 3.

3.8:complete http://www. 2.novell.3.23.php?msg_id=2721722 [https://sourceforge.com] for more information.5.2.mysqladmin -uroot ping|grep alive|wc -l #UserParameter=mysql[uptime].com/documentation/1. Details about enabling of WinPopUps can be found at https://sourceforge. It is available from http://forge. mysql[uptime] Number of seconds MySQL is running 2.novell.2.8/compl.com/Redbooks. 2.mikrotik.23.net/forum /message. AS/400 IBM AS/400 platform can be monitored using SNMP.conf contains list of parameters that can be used for monitoring of MySQL. mysql[questions] Number of processed queries 2.ibm. Mikrotik routers Use SNMP agent provided by Mikrotik. mysql[version] Version of MySQL Example: mysql Ver 11. It could be good addition for email-based alert messages.2.49. More information is available at http://publib-b. mysql[threads] Number of MySQL threads 2.php?msg_id=2721722].2.42 and later) ### Change -u and add -p if required #UserParameter=mysql[ping].mikrotik. 2.com/modules/xfmod/project/?mrtgext].mysqladmin -uroot status|cut f5 -d”:”|cut -f1 -d”O” #UserParameter=mysql[qps].alive 2.NLM) agent for Novell.mysqladmin -uroot status|cut f4 -d”:”|cut -f1 -d”S” #UserParameter=mysql[slowqueries]. Novell Use MRTG Extension Program for NetWare Server (MRTGEXT.txt. WIN32 Use ZABBIX W32 agent included (pre-compiled) into ZABBIX distribution. mysql[slowqueries] Number of slow queries 2.6.4.com [http://www.16 Distrib 3.2. The agent is compatible with protocol used by ZABBIX.com/Redbooks.5..ibm. mysql[qps] Queries per second 2. Items have to be configured of type ZABBIX Agent and must have keys according to the MRTGEXT documentation.nsf/RedbookAbstracts /sg244504.2. For example: UTIL1 1 minute average CPU utilization CONNMAX Max licensed connections used VFKSys bytes free on volume Sys: Full list of parameter supported by the agent can be found in readme. 137 de 143 23/02/10 12:25 .boulder.1.zabbix.4.com/modules/xfmod/project/?mrtgext [http://forge.html?Open [http://publib-b.html?Open]. See http://www.7. which is part of the software.mysqladmin -uroot status|cut f3 -d”:”|cut -f1 -d”Q” #UserParameter=mysql[questions]. Trigger function nodata() for monitoring availability of hosts using only active checks 19.mysql -V 2. MySQL Configuration file misc/conf/zabbix_agentd.mysqladmin -uroot status|cut f2 -d”:”|cut -f1 -d”T” #UserParameter=mysql[threads]. mysql[ping] Check whether MySQL is alive Result: 0 .boulder.1.net/forum/message. for pc-linux-gnu (i686) 2. Monitoring of Specific Applications 2.1.2. ### Set of parameter for monitoring MySQL server (v3. Sending alerts via WinPopUps WinPopUps maybe very useful if you're running Windows OS and want to get quick notification from ZABBIX.1.not started 1 . 2.nsf/RedbookAbstracts/sg244504..2.2.mysqladmin -uroot status|cut -f9 d”:” #UserParameter=version[mysql].2.

the qry string is the one obtained from jconsole. ZABBIX can retrieve information provided by Informix SNMP agent.8/compl. Once you can reliably grab the data you are interested in.management. you can use the command line tool like this /<pathTo>/java -jar /<pathTo>/cmdline-jmxclient.jmxremote.jmxremote \ 2. The first way is I can use the servlet provided by Tomcat.lang:type=Threading PeakThreadCount The difference with the command line client is you need to specify the attribute you are interested in specifically.zabbix.0/docs.sun. Integration 19.5.management.org/cmdline-jmxclient/] Information on setting up jmx monitoring for your jvms http://java. and to refer to the passwords stored in the jmxremote.password. Threading. Dcom.sun.6.lang:type=Threading PeakT That's it. How do you know if you can do this? You can use the sun jconsole utility that comes with the jdk and point it at your machine running the jvm. you need to configure your jvm to allow jmx monitoring. /usr/bin/curl -s -u<jmxusername>:<jmxpassword> 'http://<tomcat_hostname>/manager/jmxproxy/?qry=java. 2.3. Dcom.org/cmdline-jmxclient/ [http://crawler.ment/agent. The second way is I can send well formatted requests via a jmx command line tool.5. (Don't know what jboss has).html] Apparently the 1. Dcom.password file.. I click on the info tab.3.5. Dcom.html [http://java. e.sun. Step 2 Define new user.authenticate=true \ 5.g. parse the output for the data of your choice.. 2. Now.0/docs. you are good.lang:type=Threading” With tomcat. 2.0/docs.com/j2se/1.management.management.com/documentation/1.. since I use Tomcat.file=/path/java/jre/lib/management/jmxremote.lang:type=Threading' | /bin/awk '/ or UserParameter=jvm. If you don't have a servlet that will allow you to make a http request to the jmx interface.sun. Need a command line jmx client? I use the one from here: http://crawler.verviewTOC.sun. I can do the following: curl -s -u<jmxusername>:<jmxpassword> 'http://<tomcat_hostname>/manager/jmxproxy/?qry=java..port=xxxxx \ 3.jar <jmxusername>:<jmxhostname> <jvmhostname>:<jmxport> java. I browse down through the jmx objects via jconsole.archive.sun. In my tomcat environment.html] General Information on JMX http://java. See the sun docs on jconsole for details.ssl=false \ 4.jmxremote.sun..5 jvm also supports SNMP which provides another option.com/j2se/1. jconsole will also provide you the information you need to query specific jmx attributes from the information tab.. password” This tells the jmx server to run on port XXXXX.. 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.maxthreads. JMX First of all. find it under java.com/j2se/1. UserParameter=jvm. you can then turn that command into a zabbix userparm.html [http://java. The following steps must be performed: Step 1 Define new media.verviewTOC. I enable it by setting the following options for the jvm: 1. I prefer getting my stats from the servlet via http rather than using the java command line client as it is much “lighter” to start up and grab the information. The output from this will be all the metrics from this jmx key.. there are two ways that I can grab the jmx attribute values (or effect a jmx operation). The media will execute a script which will send required information to OpenView.7.1.sun. I can then run jconsole and see everything that is currently exposed (and to verify that I can connect properly).ment /agent. /<pathTo>/java -jar /<pathTo>/cmdline-jmxclient.lang:type=Threading' where the jmx username and password are the ones defined in the file defined in the jvm options above.5.jmxremote. Also.. to use password authentication.lang.maxthreads.com/j2se/1.management. HP OpenView ZABBIX can be configured to send messages to OpenView server. Dcom. Informix Standard Informix utility onstat can be used for monitoring of virtually every aspect of Informix database. After selecting Threading. Again.archive. Leaving it out will give you a list of all the attributes available under Threading. (You might consider enabling ssl to make the connection more secure.) Once that is done. 138 de 143 23/02/10 12:25 .jmxremote.0/docs. If you can connect.sun.jar <jmxusername>:<jmxpassword> <jvmhostname>:<jmxport> java.8:complete http://www. Parse the output and grab the number of your choice. and I can see the name of the mbean is “java. 19.8.1.. Let's say I am interested in peak threads used by the system.

Simple messages Warning: before enabling recovery messages or escalations. Zabbix will automatically escalate (increase escalation step) unresolved problems and execute actions assigned to each escalation step. preferrably in a new table of ZABBIX database. Recovery message to all interested parties Zabbix supports unlimited number of escalation steps 21. Error Message Details Zabbix daemon is unable to establish connection to the database.. 20. Zabbix executes arbitrary scripts (remote commands) Repeated notifications until problem is resolved Delayed notifications and remote commands Escalate problems to other user groups Different escalation path for acknowledged and unacknowledged problems Execute actions (both notifications and remote commands) if a problem exists for more than N hours (seconds. Z3004 Cannot close database: [%d] %s Z3005 Query failed: [%d] %s [%s] Z3006 Fetch failed: [%d] %s The numbered error messages are supported starting from Zabbix 1. Step 4 Write media script. Step 3 Configure actions. The script will have the following logic. If trigger is OFF then opcmack <message id> has to be executed with message ID retrieved from the database. make sure to add “Trigger value = PROBLEM” condition to the action.8:complete The user has to be linked with the media. The messages are written to log files depending on configuration parameters. Error and warning messages Zabbix daemons generate error and warning messages in case of any problems.com/documentation/1.8/compl. 1 Comment 21.1.2. The table contains complete list of numbered messages with additional details. etc). Additional information: database error code database error string SQL query execution failed. Additional information: database name database error code database error string This should never happen. Troubleshooting 20. then execute OpenView command opcmsg -id application=<application> msg_grp=<msg_grp> object=<object> msg_text=<text>. Depending on configuration. Additional information: database error code database error string Z3002 Cannot create database '%s': [%d] %s Z3003 No connection to the database. Additional information: database name Z3001 Connection to database '%s' failed: [%d] %s database error code database error string Zabbix daemon is unable to create database. Refer to OpenView official documentation for more details about opcmsg and opcmack. If trigger is ON. http://www.. Zabbix daemon is unable to close connection to the database. Overview Zabbix provides effective and extremely flexible functionality for escalations and repeated notifications. The command will return unique message ID which has to be stored somewhere. otherwise remedy events can become escalated as well. minutes. Some of the messages are numbered. Additional information: database error code database error string SQL query string Record fetch failed. Configure actions to send all (or selected) trigger status changes to the user.1. Report to Zabbix Team. In order to alert MySQL Administrators about any issues with MySQL applications the following configuration can be used: 139 de 143 23/02/10 12:25 . The media script is not given here.zabbix. Escalations and repeated notifications 21.8.1. Zabbix supports the following scenarios for escalations. notifications and remote commands: Immediately inform users about new problems Pro-active monitoring.

zabbix.. 21. middleware. no messages will be sent on recovery. memory. Zabbix supports wide range of macros. Action conditions is defined so that it will be activated in case of any problem with any of MySQL applications. The action condition is defined so that it will be activated in case of any disaster problems with one of Apache applications. He is the list of some of the most obvious uses of the feature: Automatically restart application (WEB server.e. whatever) resources Configuration of action for remote commands is similar to messaging. clean /tmp) if we are running out of disk space Migrate one VM from one physical box to another depending on CPU load Add new nodes to the cloud environment if we have insufficient CPU (disk. when the problem is resolved. If sending of recovery messages is not enabled. Note also use of macros in the messages.. Zabbix can execute a command on a monitored host in case of any pre-defined conditions. Complete list of macros is available here: macros Actions are defined as: A message will be sent to all members of the group MySQL Administrators. CRM) if it does not respond Using IPMI 'reboot' command reboot remote server if it does not answer requests Try to automatically free disk space (remove older files. the only difference is that Zabbix will execute a command instead of sending a message. i.3. Since we are not interested in sending multiple messages or escalating MySQL problems to other user groups. As a reaction to the disaster problem Zabbix will try to restart Apache process: 140 de 143 23/02/10 12:25 .8/compl.1. Zabbix will send only one message with information about new problem.com/documentation/1. Zabbix will send a single message to MySQL Administrators and a recovery message when problem is resolved. escalations are not enabled. Remote commands Remote commands is a powerful mechanism for smart pro-active monitoring.8:complete http://www.

8:complete http://www. As soon as we enabled escalations. Suppose we would like to send 5 messages every hour. Suppose we would like to be notified about long-standing MySQL problems only. The escalation period will be taken from action definition unless we overwrote it for an individual operation.com/documentation/1. actions operations get additional options: Step(s). 21. Note use of the macro {HOSTNAME} here. Make sure that escalations are enabled in the action details: The period defines how frequently Zabbix should increase escalation step. By default. Period and Conditions. so all operations assigned to the step will be executed..zabbix. 1. As soon as we have a problem.4. so all operations of step 2 will be execute. Zabbix sends a message informing about this fact to persons that have already received notifications. If the trigger that generated an active escalation is disabled. After one hour. it goes to the next step every hour.5. Also Zabbix Agent should run on a remote host and accept incoming connections. Zabbix is at step 1.1. escalation period will be increased automatically (if the problem still exists obviously). User 'zabbix' must have enough permissions to execute this script.e. 3600 seconds. so we defined that the operation will be active from escalation step 1 till 5. Repeated notifications Repeated notifications is probably one of the most common use of Zabbix escalations. A recovery message will be sent only to those people who received at least one message before in scope of the escalation. See remote command tutorial for more information. And so on.8/compl. Note that the escalation period was changed to 10 hours and we use a custom default message: 141 de 143 23/02/10 12:25 . Delayed notifications Zabbix escalations supports sending of delayed notifications. i..

1. Problem is not being fixed by MySQL admins? Escalate to their BOSS! Now we configured periodical sending of messages to MySQL administrators. Zabbix will try to restart the MySQL database. beware! 21. The macro will contain information about all previously executed steps.8:complete http://www.6. supposedly no one is working on it. Escalate to Boss Zabbix escalations can be used to escalate problem to other users and user groups.zabbix.. The operation is assigned only to step 2. It means it will be executed once after one escalation period.e.8/compl. Note that the manager will get a message only in case if the problem is not acknowledged yet. Complex scenario Look at this set of actions. after another 30 minutes Zabbix will send a message to all users in Japan. 21. 142 de 143 23/02/10 12:25 . after another hour Zabbix will reboot server with the MySQL database (second remote command) using IPMI commands.com/documentation/1. 10 hours: Therefore user 'Alexei' will get a message only in case if a problem exists for more than 10 hours. The administrators will get four messages before the problem will be escalated to the Database manager.. If this does help. MySQL administrators.HISTORY} macros in the message. i. The manager will get information about all email and all action executed before. The notification delay is controlled by the escalation period. It will happen if problem exists for 2:30 hours and it hasn't been acknowledged.7. Note use of the {ESC. After multiple messages to MySQL administrators and escalation to the manager. If the problems still exists.

.zabbix.1.com/documentation/1.8:complete http://www.. 143 de 143 23/02/10 12:25 .8/compl.

Sign up to vote on this title
UsefulNot useful