Zabbix Documentation 2.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


manual:xml_export_import:hosts

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:xml_export_import:hosts [2018/07/04 10:04]
manual:xml_export_import:hosts [2014/09/25 14:22] (current)
sasha Page moved from 2.0:manual:xml_export_import:hosts to manual:xml_export_import:hosts
Line 1: Line 1:
 +==== 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.
 +
 +<code xml>
 +<​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>​
 +</​code>​
 +=== 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 ===
 +
 +^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  |
 +=== hosts/​host/​items/​item/​applications/​application ===
 +
 +^Parameter^Type ​     ^Description^Details^
 +|name     ​|//​string//​|Application name. | |