This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

Hosts

Hosts are exported with many related objects and object relations.

Host export contains:

  • host data
  • host inventory data
  • group relations
  • template relations
  • interfaces
  • macros
  • applications
  • items
  • discovery rules with all prototypes
  • web scenarios
  • value maps

When a host is imported and updated, it can only be linked to additional templates and never be unlinked from any.

    <hosts>
               <host>
                   <host>Zabbix server</host>
                   <name>Zabbix server</name>
                   <description>Zabbix monitoring server.</description>
                   <proxy/>
                   <status>0</status>
                   <ipmi_authtype>-1</ipmi_authtype>
                   <ipmi_privilege>2</ipmi_privilege>
                   <ipmi_username/>
                   <ipmi_password/>
                   <templates/>
                   <groups>
                       <group>
                           <name>Zabbix servers</name>
                       </group>
                   </groups>
                   <interfaces>
                       <interface>
                           <default>1</default>
                           <type>1</type>
                           <useip>1</useip>
                           <ip>127.0.0.1</ip>
                           <dns/>
                           <port>20001</port>
                           <interface_ref>if1</interface_ref>
                       </interface>
                   </interfaces>
                   <applications>
                       <application>
                           <name>Memory</name>
                       </application>
                       <application>
                           <name>Zabbix agent</name>
                       </application>
                   </applications>
                   <items>
                       <item>
                           <name>Agent ping</name>
                           <type>0</type>
                           <snmp_community/>
                           <multiplier>0</multiplier>
                           <snmp_oid/>
                           <key>agent.ping</key>
                           <delay>60</delay>
                           <history>7</history>
                           <trends>365</trends>
                           <status>0</status>
                           <value_type>3</value_type>
                           <allowed_hosts/>
                           <units/>
                           <delta>0</delta>
                           <snmpv3_securityname/>
                           <snmpv3_securitylevel>0</snmpv3_securitylevel>
                           <snmpv3_authpassphrase/>
                           <snmpv3_privpassphrase/>
                           <formula>1</formula>
                           <delay_flex/>
                           <params/>
                           <ipmi_sensor/>
                           <data_type>0</data_type>
                           <authtype>0</authtype>
                           <username/>
                           <password/>
                           <publickey/>
                           <privatekey/>
                           <port/>
                           <description>The agent always returns 1 for this item. It could be used in combination with nodata() for availability check.</description>
                           <inventory_link>0</inventory_link>
                           <applications>
                               <application>
                                   <name>Zabbix agent</name>
                               </application>
                           </applications>
                           <valuemap>
                               <name>Zabbix agent ping status</name>
                           </valuemap>
                           <logtimefmt/>
                           <interface_ref>if1</interface_ref>
                       </item>
                       <item>
                           <name>Available memory</name>
                           <type>0</type>
                           <snmp_community/>
                           <multiplier>0</multiplier>
                           <snmp_oid/>
                           <key>vm.memory.size[available]</key>
                           <delay>60</delay>
                           <history>7</history>
                           <trends>365</trends>
                           <status>0</status>
                           <value_type>3</value_type>
                           <allowed_hosts/>
                           <units>B</units>
                           <delta>0</delta>
                           <snmpv3_securityname/>
                           <snmpv3_securitylevel>0</snmpv3_securitylevel>
                           <snmpv3_authpassphrase/>
                           <snmpv3_privpassphrase/>
                           <formula>1</formula>
                           <delay_flex/>
                           <params/>
                           <ipmi_sensor/>
                           <data_type>0</data_type>
                           <authtype>0</authtype>
                           <username/>
                           <password/>
                           <publickey/>
                           <privatekey/>
                           <port/>
                           <description>Available memory is defined as free+cached+buffers memory.</description>
                           <inventory_link>0</inventory_link>
                           <applications>
                               <application>
                                   <name>Memory</name>
                               </application>
                           </applications>
                           <valuemap/>
                           <logtimefmt/>
                           <interface_ref>if1</interface_ref>
                       </item>
                   </items>
                   <discovery_rules>
                       <discovery_rule>
                           <name>Mounted filesystem discovery</name>
                           <type>0</type>
                           <snmp_community/>
                           <snmp_oid/>
                           <key>vfs.fs.discovery</key>
                           <delay>3600</delay>
                           <status>0</status>
                           <allowed_hosts/>
                           <snmpv3_securityname/>
                           <snmpv3_securitylevel>0</snmpv3_securitylevel>
                           <snmpv3_authpassphrase/>
                           <snmpv3_privpassphrase/>
                           <delay_flex/>
                           <params/>
                           <ipmi_sensor/>
                           <authtype>0</authtype>
                           <username/>
                           <password/>
                           <publickey/>
                           <privatekey/>
                           <port/>
                           <filter>{#FSTYPE}:@File systems for discovery</filter>
                           <lifetime>30</lifetime>
                           <description>Discovery of file systems of different types as defined in global regular expression "File systems for discovery".</description>
                           <item_prototypes>
                               <item_prototype>
                                   <name>Free disk space on $1</name>
                                   <type>0</type>
                                   <snmp_community/>
                                   <multiplier>0</multiplier>
                                   <snmp_oid/>
                                   <key>vfs.fs.size[{#FSNAME},free]</key>
                                   <delay>60</delay>
                                   <history>7</history>
                                   <trends>365</trends>
                                   <status>0</status>
                                   <value_type>3</value_type>
                                   <allowed_hosts/>
                                   <units>B</units>
                                   <delta>0</delta>
                                   <snmpv3_securityname/>
                                   <snmpv3_securitylevel>0</snmpv3_securitylevel>
                                   <snmpv3_authpassphrase/>
                                   <snmpv3_privpassphrase/>
                                   <formula>1</formula>
                                   <delay_flex/>
                                   <params/>
                                   <ipmi_sensor/>
                                   <data_type>0</data_type>
                                   <authtype>0</authtype>
                                   <username/>
                                   <password/>
                                   <publickey/>
                                   <privatekey/>
                                   <port/>
                                   <description/>
                                   <inventory_link>0</inventory_link>
                                   <applications>
                                       <application>
                                           <name>Filesystems</name>
                                       </application>
                                   </applications>
                                   <valuemap/>
                                   <logtimefmt/>
                                   <application_prototypes>
                                       <application_prototype>
                                           <name>{#FSNAME}</name>
                                       </application_prototype>
                                   </application_prototypes>
                                   <interface_ref>if1</interface_ref>
                               </item_prototype>
                           </item_prototypes>
                           <trigger_prototypes>
                               <trigger_prototype>
                                   <expression>{Zabbix server 2:vfs.fs.size[{#FSNAME},pfree].last()}<20</expression>
                                   <name>Free disk space is less than 20% on volume {#FSNAME}</name>
                                   <url/>
                                   <status>0</status>
                                   <priority>2</priority>
                                   <description/>
                                   <type>0</type>
                               </trigger_prototype>
                           </trigger_prototypes>
                           <graph_prototypes>
                               <graph_prototype>
                                   <name>Disk space usage {#FSNAME}</name>
                                   <width>600</width>
                                   <height>340</height>
                                   <yaxismin>0.0000</yaxismin>
                                   <yaxismax>0.0000</yaxismax>
                                   <show_work_period>0</show_work_period>
                                   <show_triggers>0</show_triggers>
                                   <type>2</type>
                                   <show_legend>1</show_legend>
                                   <show_3d>1</show_3d>
                                   <percent_left>0.0000</percent_left>
                                   <percent_right>0.0000</percent_right>
                                   <ymin_type_1>0</ymin_type_1>
                                   <ymax_type_1>0</ymax_type_1>
                                   <ymin_item_1>0</ymin_item_1>
                                   <ymax_item_1>0</ymax_item_1>
                                   <graph_items>
                                       <graph_item>
                                           <sortorder>0</sortorder>
                                           <drawtype>0</drawtype>
                                           <color>C80000</color>
                                           <yaxisside>0</yaxisside>
                                           <calc_fnc>2</calc_fnc>
                                           <type>2</type>
                                           <item>
                                               <host>Zabbix server 2</host>
                                               <key>vfs.fs.size[{#FSNAME},total]</key>
                                           </item>
                                       </graph_item>
                                       <graph_item>
                                           <sortorder>1</sortorder>
                                           <drawtype>0</drawtype>
                                           <color>00C800</color>
                                           <yaxisside>0</yaxisside>
                                           <calc_fnc>2</calc_fnc>
                                           <type>0</type>
                                           <item>
                                               <host>Zabbix server 2</host>
                                               <key>vfs.fs.size[{#FSNAME},free]</key>
                                           </item>
                                       </graph_item>
                                   </graph_items>
                               </graph_prototype>
                           </graph_prototypes>
                           <interface_ref>if1</interface_ref>
                       </discovery_rule>
                   </discovery_rules>
                   <httptests>
                       <httptest>
                           <name>Zabbix</name>
                           <application/>
                           <delay>60</delay>
                           <attempts>1</attempts>
                           <agent>Mozilla/5.0 (Windows NT 6.1; WOW64; Trident/7.0; rv:11.0)</agent>
                           <http_proxy/>
                           <variables/>
                           <headers/>
                           <status>0</status>
                           <authentication>0</authentication>
                           <http_user/>
                           <http_password/>
                           <verify_peer>0</verify_peer>
                           <verify_host>0</verify_host>
                           <ssl_cert_file/>
                           <ssl_key_file/>
                           <ssl_key_password/>
                           <steps>
                               <step>
                                   <name>Main page</name>
                                   <url>https://zabbix.com</url>
                                   <posts/>
                                   <variables/>
                                   <headers/>
                                   <follow_redirects>1</follow_redirects>
                                   <retrieve_mode>0</retrieve_mode>
                                   <timeout>60</timeout>
                                   <required/>
                                   <status_codes>200</status_codes>
                               </step>
                           </steps>
                       </httptest>
                   </httptests>
                   <macros>
                       <macro>
                           <macro>{$M1}</macro>
                           <value>m1</value>
                       </macro>
                       <macro>
                           <macro>{$M2}</macro>
                           <value>m2</value>
                       </macro>
                   </macros>
                   <inventory/>
               </host>
           </hosts>
           <value_maps>
               <value_map>
                   <name>Zabbix agent ping status</name>
                   <mappings>
                       <mapping>
                           <value>1</value>
                           <newvalue>Up</newvalue>
                       </mapping>
                   </mappings>
               </value_map>
           </value_maps>

hosts/host

Parameter Type Description Details
host string Host name.
name string Visible host name.
description string Host description.
status int Host status.
proxy int Proxy name.
ipmi_authtype int IPMI authentication type.
ipmi_privilege int IPMI privilege.
ipmi_username string IPMI username.
ipmi_password string IPMI password.

hosts/host/groups/group

Parameter Type Description Details
name string Group name.

hosts/host/templates/template

Parameter Type Description Details
name string Template technical name.

hosts/host/interfaces/interface

Column name Type Description
default integer Interface status:
0 - Not default interface
1 - Default interface
type integer Interface type:
1 - agent
2 - SNMP
3 - IPMI
4 - JMX
useip integer How to connect to the host:
0 – connect to the host using DNS name
1 – connect to the host using IP address
ip varchar IP address, can be either IPv4 or IPv6.
dns varchar DNS name.
port varchar Port number.
interface_ref varchar Interface reference name to be used in items.

hosts/host/applications/application

Parameter Type Description Details
name string Application name.

hosts/host/items/item

Parameter Type Description
type int Item type:
0 - Zabbix agent
1 - SNMPv1
2 - Trapper
3 - Simple check
4 - SNMPv2
5 - Internal
6 - SNMPv3
7 - Active check
8 - Aggregate
9 - HTTP test (web monitoring scenario step)
10 - External
11 - Database monitor
12 - IPMI
13 - SSH
14 - telnet
15 - Calculated
16 - JMX
17 - SNMP trap
snmp_community string SNMP Community name
snmp_oid string SNMP OID
port int Item custom port
name string Item name
key string Item key
delay int Check interval
history int How long to keep item history (days)
trends int How long to keep item trends (days)
status int Item status
value_type int Value type
trapper_hosts string
units string Value units
multiplier int Value multiplier
delta int Store values as delta
snmpv3_securityname string SNMPv3 security name
snmpv3_securitylevel int SNMPv3 security level
snmpv3_authpassphrase string SNMPv3 authentication phrase
snmpv3_privpassphrase string SNMPv3 private phrase
formula string
delay_flex string Flexible delay
params string
ipmi_sensor string IPMI sensor
data_type int
authtype int
username string
password string
publickey string
privatekey string
interface_ref varchar Reference to host interface
description string Item description
inventory_link int Host inventory field number, that will be updated with the value returned by the item
applications Item applications
valuemap Value map assigned to item
logtimefmt string Format of the time in log entries. Used only by log items.

hosts/host/items/item/applications/application

Parameter Type Description Details
name string Application name.

hosts/host/items/item/valuemap

Parameter Type Description Details
name string Value map name.

value_maps/value_map

Parameter Type Description Details
name string Value map name.
mappings Value mappings for value map.

value_maps/value_map/mappings/mapping

Parameter Type Description Details
value string Value mapping original value.
newvalue string Value to which the original value is mapped to.