Zabbix Documentation 2.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

manual:xml_export_import:hosts

Hosts

Hosts are exported with many related objects and object relations.

Host export contains:

  • hosts data
  • host inventory data
  • groups relations
  • templates relations
  • interfaces
  • macros
  • applications
  • items
  • discovery rules with all prototypes

When 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>
            <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>
                    <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/>
                    <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 &quot;File systems for discovery&quot;.</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/>
                            <interface_ref>if1</interface_ref>
                        </item_prototype>
                    </item_prototypes>
                    <trigger_prototypes>
                        <trigger_prototype>
                            <expression>{Zabbix server 2:vfs.fs.size[{#FSNAME},pfree].last(0)}&lt;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>
            <macros>
                <macro>
                    <macro>{$M1}</macro>
                    <value>m1</value>
                </macro>
                <macro>
                    <macro>{$M2}</macro>
                    <value>m2</value>
                </macro>
            </macros>
            <inventory/>
        </host>
    </hosts>

hosts/host

Parameter Type Description Details
host string Host name.
name string Visible host name.
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

ParameterType DescriptionDetails
name stringGroup name.

hosts/host/templates/template

ParameterType DescriptionDetails
name stringTemplate 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

ParameterType DescriptionDetails
name stringApplication 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
portint 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

hosts/host/items/item/applications/application

ParameterType DescriptionDetails
name stringApplication name.