2017/10/16 15:32 1/20 3 Hosts. When a host is imported and updated, it can only be linked to additional templates and never be unlinked from any.

Transcription

1 2017/10/16 15:32 1/20 3 Hosts 3 Hosts Overview Hosts are exported with many related objects and object relations. Host export contains: linked host groups host data template linkage host group linkage host interfaces directly linked applications directly linked items directly linked triggers directly linked graphs directly linked discovery rules with all prototypes directly linked web scenarios host macros host inventory data value maps When a host is imported and updated, it can only be linked to additional templates and never be unlinked from any. Exporting To export hosts, do the following: Go to: Configuration Hosts Mark the checkboxes of the hosts to export Click on Export below the list Selected hosts are exported to a local XML file with default name zabbix_export_hosts.xml. Zabbix Documentation

2 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts Importing To import hosts, do the following: Go to: Configuration Hosts Click on Import to the right Select the import file Mark the required options in import rules Click on Import A success or failure message of the import will be displayed in the frontend. Import rules: Rule Update existing Create new Delete missing Description Existing elements will be updated with data taken from the import file. Otherwise they will not be updated. The import will add new elements using data from the import file. Otherwise it will not add them. The import will remove existing elements not present in the import file. Otherwise it will not remove them. Printed on 2017/10/16 15:32

3 2017/10/16 15:32 3/20 3 Hosts Export format <?xml version="1.0" encoding="utf-8"?> <zabbix_export> <version>3.4</version> <date> t08:26:43z</date> <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/> <tls_connect>1</tls_connect> <tls_accept>1</tls_accept> <tls_issuer/> <tls_subject/> <tls_psk_identity/> <tls_psk/> <templates/> <groups> <group> <name>zabbix servers</name> </group> </groups> <interfaces> <interface> <default>1</default> <type>1</type> <useip>1</useip> <ip> </ip> <dns/> <port>20001</port> <bulk>1</bulk> <interface_ref>if1</interface_ref> </interface> </interfaces> <applications> <application> <name>memory</name> </application> <application> <name>zabbix agent</name> </application> </applications> <items> Zabbix Documentation

4 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts <item> <name>agent ping</name> <type>0</type> <snmp_community/> <snmp_oid/> <key>agent.ping</key> <delay>1m</delay> <history>1w</history> <trends>365d</trends> <status>0</status> <value_type>3</value_type> <allowed_hosts/> <units/> <snmpv3_contextname/> <snmpv3_securityname/> <snmpv3_securitylevel>0</snmpv3_securitylevel> <snmpv3_authprotocol>0</snmpv3_authprotocol> <snmpv3_authpassphrase/> <snmpv3_privprotocol>0</snmpv3_privprotocol> <snmpv3_privpassphrase/> <params/> <ipmi_sensor/> <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/> <preprocessing/> <interface_ref>if1</interface_ref> <master_item/> </item> <item> <name>available memory</name> <type>0</type> <snmp_community/> <snmp_oid/> Printed on 2017/10/16 15:32

5 2017/10/16 15:32 5/20 3 Hosts <key>vm.memory.size[available]</key> <delay>1m</delay> <history>1w</history> <trends>365d</trends> <status>0</status> <value_type>3</value_type> <allowed_hosts/> <units>b</units> <snmpv3_contextname/> <snmpv3_securityname/> <snmpv3_securitylevel>0</snmpv3_securitylevel> <snmpv3_authprotocol>0</snmpv3_authprotocol> <snmpv3_authpassphrase/> <snmpv3_privprotocol>0</snmpv3_privprotocol> <snmpv3_privpassphrase/> <params/> <ipmi_sensor/> <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/> <preprocessing/> <interface_ref>if1</interface_ref> <master_item/> </item> <item> <name>available memory</name> <type>18</type> <snmp_community/> <snmp_oid/> <key>dependent.am</key> <delay>0</delay> <history>90d</history> <trends>365d</trends> <status>0</status> <value_type>3</value_type> <allowed_hosts/> <units/> <snmpv3_contextname/> Zabbix Documentation

6 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts <snmpv3_securityname/> <snmpv3_securitylevel>0</snmpv3_securitylevel> <snmpv3_authprotocol>0</snmpv3_authprotocol> <snmpv3_authpassphrase/> <snmpv3_privprotocol>0</snmpv3_privprotocol> <snmpv3_privpassphrase/> <params/> <ipmi_sensor/> <authtype>0</authtype> <username/> <password/> <publickey/> <privatekey/> <port/> <description/> <inventory_link>0</inventory_link> <applications/> <valuemap/> <logtimefmt/> <preprocessing/> <jmx_endpoint/> <master_item> <key>vm.memory.size[available]</key> </master_item> </item> </items> <discovery_rules> <discovery_rule> <name>mounted filesystem discovery</name> <type>0</type> <snmp_community/> <snmp_oid/> <key>vfs.fs.discovery</key> <delay>1h</delay> <status>0</status> <allowed_hosts/> <snmpv3_contextname/> <snmpv3_securityname/> <snmpv3_securitylevel>0</snmpv3_securitylevel> <snmpv3_authprotocol>0</snmpv3_authprotocol> <snmpv3_authpassphrase/> <snmpv3_privprotocol>0</snmpv3_privprotocol> <snmpv3_privpassphrase/> <params/> <ipmi_sensor/> <authtype>0</authtype> <username/> <password/> <publickey/> <privatekey/> Printed on 2017/10/16 15:32

7 2017/10/16 15:32 7/20 3 Hosts <port/> <filter> <evaltype>0</evaltype> <formula/> <conditions> <condition> <macro>{#fstype}</macro> <value>@file systems for discovery</value> <operator>8</operator> <formulaid>a</formulaid> </condition> </conditions> </filter> <lifetime>30d</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/> <snmp_oid/> <key>vfs.fs.size[{#fsname},free]</key> <delay>1m</delay> <history>1w</history> <trends>365d</trends> <status>0</status> <value_type>3</value_type> <allowed_hosts/> <units>b</units> <snmpv3_contextname/> <snmpv3_securityname/> <snmpv3_securitylevel>0</snmpv3_securitylevel> <snmpv3_authprotocol>0</snmpv3_authprotocol> <snmpv3_authpassphrase/> <snmpv3_privprotocol>0</snmpv3_privprotocol> <snmpv3_privpassphrase/> <params/> <ipmi_sensor/> <authtype>0</authtype> <username/> <password/> <publickey/> <privatekey/> <port/> <description/> <inventory_link>0</inventory_link> <applications> <application> <name>filesystems</name> Zabbix Documentation

8 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts </application> </applications> <valuemap/> <logtimefmt/> <preprocessing/> <application_prototypes> <application_prototype> <name>{#fsname}</name> </application_prototype> </application_prototypes> <interface_ref>if1</interface_ref> <master_item_prototype/> </item_prototype> </item_prototypes> <trigger_prototypes> <trigger_prototype> <expression>{zabbix server 2:vfs.fs.size[{#FSNAME},pfree].last()}<20</expression> <recovery_mode>0</recovery_mode> <recovery_expression/> <name>free disk space is less than 20% on volume {#FSNAME}</name> <correlation_mode>0</correlation_mode> <correlation_tag/> <url/> <status>0</status> <priority>2</priority> <description/> <type>0</type> <manual_close>0</manual_close> <dependencies/> <tags/> </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> Printed on 2017/10/16 15:32

9 2017/10/16 15:32 9/20 3 Hosts <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> <host_prototypes/> <interface_ref>if1</interface_ref> </discovery_rule> </discovery_rules> <httptests> <httptest> <name>zabbix</name> <application/> <delay>1m</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/> Zabbix Documentation

10 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts <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> <posts/> <variables/> <headers/> <follow_redirects>1</follow_redirects> <retrieve_mode>0</retrieve_mode> <timeout>1m</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> </zabbix_export> Element tags Printed on 2017/10/16 15:32

11 2017/10/16 15:32 11/20 3 Hosts Element tag values are explained in the table below. Host tags groups Root element for groups. group Individual group. name Unique group name. hosts host Root element for hosts. Individual host. host Unique host name. name Visible host name. description text Host description. status ipmi_authtype ipmi_privilege 0 - monitored 1 - not monitored -1 - default 0 - none 1 - MD2 2 - MD5 4 - straight 5 - OEM 6 - RMCP+ 1 - callback 2 - user 3 - operator 4 - admin 5 - OEM Host status. IPMI session authentication type. IPMI session privilege level. ipmi_username Username for IPMI checks. ipmi_password Password for IPMI checks. tls_connect tls_accept 1 - unencrypted 2 - TLS with PSK 4 - TLS with certificate 1 - unencrypted 2 - TLS with PSK 3 - unencrypted and TLS with PSK 4 - TLS with certificate 5 - unencrypted and TLS with certificate 6 - TLS with PSK or certificate 7 - unencrypted and TLS with PSK or certificate Type of outgoing connection. Type of incoming connection. tls_issuer Allowed agent/proxy certificate issuer. tls_subject Allowed agent/proxy certificate subject. tls_psk_indentity PSK identity. tls_psk PSK value. Zabbix Documentation

12 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts proxy name Proxy. Name of the proxy (if any) that monitors the host. templates template interfaces interface Root element for linked templates. Individual template. name Template name. default type useip 0 - secondary 1 - primary (default) 0 - unknown 1 - Zabbix agent 2 - SNMP 3 - IPMI 4 - JMX Root element for host interfaces. Individual interface. Interface status. Only one primary interface of one type can be on a host. Interface type. 0 - use DNS Interface to use for connecting to the name host. 1 - use IP address ip IP address, can be either IPv4 or IPv6. dns DNS name. port Port number. bulk interface_ref 0 - disable 1 - enable Use bulk requests for SNMP. Interface reference name to be used in items. applications application name Root element for applications. Individual application. Application name. macros macro name value Root element for macros. Individual macro. User macro name. User macro value. Host item tags items Root element for items. item Individual item. name Item name. Printed on 2017/10/16 15:32

13 2017/10/16 15:32 13/20 3 Hosts type snmp_community 0 - Zabbix agent 1 - SNMPv1 agent 2 - Zabbix trapper 3 - simple check 4 - SNMPv2 agent 5 - internal 6 - SNMPv3 agent 7 - Zabbix agent (active) 8 - aggregate 9 - HTTP test (web monitoring scenario step) 10 - external 11 - database monitor 12 - IPMI agent 13 - SSH agent 14 - Telnet agent 15 - calculated 16 - JMX agent 17 - SNMP trap 18 - Dependent item Item type. SNMP community name if 'type' is 1,4. snmp_oid SNMP object ID. key Item key. delay history trends status value_type allowed_hosts 0 - enabled 1 - disabled 0 - float 1 - character 2 - log 3 - unsigned 4 - text Update interval of the item. Seconds, time unit with suffix, custom intervals or user macros. A time unit of how long the history data should be stored. Time unit with suffix or user macro. A time unit of how long the trends data should be stored. Time unit with suffix or user macro. Item status. Received value type. List of IP addresses (comma delimited) of hosts allowed sending data for the item if 'type' is 2. Zabbix Documentation

14 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts units Units of returned values (bps, B). snmpv3_contextname SNMPv3 context name. snmpv3_securityname SNMPv3 security name. snmpv3_securitylevel snmpv3_authprotocol snmpv3_authpassphrase snmpv3_privprotocol snmpv3_privpassphrase params 0 - MD5 1 - SHA 0 - DES 1 - AES text 0 - noauthnopriv 1 - authnopriv 2 - authpriv SNMPv3 security level. SNMPv3 authentication protocol. SNMPv3 authentication passphrase. SNMPv3 privacy protocol. SNMPv3 privacy passphrase. Name of the Executed script if 'type' is 13,14 SQL query field if 'type' is 11 Formula field if 'type' is 15 ipmi_sensor IPMI sensor ID if 'type' is 12. authtype 0 - password 1 - key Authentication type if 'type' is 13. username User name if 'type' is 11,13,14. password Password if 'type' is 11,13,14. publickey privatekey Name of the public key file if 'type' is 13. Name of the private key file if 'type' is 13. port Custom port for the item. description text Item description. inventory_link logtimefmt 0 - no link number - number of field in the 'host_inventory' table Use item value to populate this inventory field. Format of the time in log entries. Used only by log items. interface_ref Reference to host interface. value map applications application preprocessing step name name Value map. Name of the value map to use for the item. Root element for applications. Individual application. Application name. Item value preprocessing. Individual item value preprocessing step. Printed on 2017/10/16 15:32

15 2017/10/16 15:32 15/20 3 Hosts type params 1 - custom multiplier 2 - right trim 3 - left trim 4 - trim from both sides 5 - regular expression matching 6 - boolean to decimal 7 - octal to decimal Type of the item value 8 - hexadecimal to preprocessing step. decimal 9 - simple change; calculated as (received valueprevious value) 10 - change per second; calculated as (received valueprevious value)/(time nowtime of last check) Parameters of the item value preprocessing step. master_item key Individual item master item data. Dependent item master item key value. Host low-level discovery rule tags discovery_rules discovery_rule For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below. lifetime Root element for low-level discovery rules. Individual low-level discovery rule. Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro. filter Individual filter. Zabbix Documentation

16 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts evaltype formula conditions 0 - And/or logic 1 - And logic 2 - Or logic 3 - custom formula Logic to use for checking lowlevel discovery rule filter conditions. Custom calculation formula for filter conditions. Root element for filter conditions. condition macro value operator. formulaid character Individual filter condition. Low-level discovery macro name. Filter value: regular expression or global regular expression. Filter condition ID. Used in the custom calculation formula. item_prototypes item_prototype application_prototypes application_prototype For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to item_prototypes, are described below. name Root element for item_prototypes. Individual item_prototype. Root element for application prototypes. Individual application prototype. Application prototype name. master_item_prototype key Individual item prototype master item prototype data. Dependent item prototype master item prototype key value. Host trigger tags triggers Root element for triggers. trigger Individual trigger. expression Trigger expression. Printed on 2017/10/16 15:32

17 2017/10/16 15:32 17/20 3 Hosts dependencies dependency tags tag recovery_mode recovery_expression 0 - expression 1 - recovery expression 2 - none name Trigger name. correlation_mode correlation_tag 0 - no event correlation 1 - event correlation by tag Basis for generating OK events. Trigger recovery expression. Correlation mode. url Trigger URL. status priority 0 - enabled 1 - disabled 0 - not classified 1 - information 2 - warning 3 - average 4 - high 5 - disaster The tag name to be used for event correlation. Trigger status. Trigger severity. description text Trigger description. type manual_close 0 - single problem event 1 - multiple problem events 0 - not allowed 1 - allowed Event generation type. Manual closing of problem events. Root element for dependencies. Individual dependency. name Dependency trigger name. expression Dependency trigger expression. recovery_expression Dependency trigger recovery expression. Root element for event tags. Individual event tag. tag Tag name. value Tag value. Host graph tags graphs graph Root element for graphs. Individual graph. name Graph name. width Graph width, in pixels. Used for preview and for pie/exploded graphs. Zabbix Documentation

18 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts graph_items graph_item height yaxismin yaxismax show_work_period show_triggers type show_legend show_3d percent_left percent_right ymin_type_1 ymax_type_1 double double 0 - no 1 - yes 0 - no 1 - yes 0 - no 1 - yes 0-2D 1-3D double double 0 - normal 1 - stacked 2 - pie 3 - exploded 4-3D pie 5-3D exploded 0 - calculated 1 - fixed 2 - last value of the selected item 0 - calculated 1 - fixed 2 - last value of the selected item Graph height, in pixels. Used for preview and for pie/exploded graphs. Value of Y axis minimum if 'ymin_type_1' is 1. Value of Y axis maximum if 'ymax_type_1' is 1. Highlight non-working hours if 'type' is 0,1. Display simple trigger values as a line if 'type' is 0,1. Graph type. Display graph legend. Enable 3D style if 'type' is 2,3. Show the percentile line for left axis if 'type' is 0. Show the percentile line for right axis if 'type' is 0. Minimum value of Y axis if 'type' is 0,1. Maximum value of Y axis if 'type' is 0,1. ymin_item_1 null or item details Item details if 'ymin_type_1' is 2. ymax_item_1 null or item details Item details if 'ymax_type_1' is 2. sortorder drawtype 0 - single line 1 - filled region 2 - bold line 3 - dotted line 4 - dashed line Root element for graph items. Individual graph item. Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another. Draw style if graph 'type' is 0. color Element colour (6 symbols, hex). yaxisside 0 - left axis 1 - right axis Y axis position (left or right) the element belongs to if graph 'type' is 0,1. Printed on 2017/10/16 15:32

19 2017/10/16 15:32 19/20 3 Hosts calc_fnc type 1 - minimum 2 - average 4 - maximum 7 - all (minimum, average and maximum, if graph 'type' is 0) 9 - last (if graph 'type' is not 0,1) Data to draw if more than one value exists for an item. 1 - value of the item is represented proportionally on the pie Draw type for pie/exploded graphs. 2 - value of the item represents the whole pie (graph sum) item Individual item. host Item host. key Item key. Host web scenario tags Element httptests httptest Element property Type Range Description Root element for web scenarios. Individual web scenario. name Web scenario name. delay Frequency of executing the web scenario. Seconds, time unit with suffix or user macro. attempts 1-10 The number of attempts for executing web scenario steps. agent http_proxy variables text Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers. Specify an HTTP proxy to use, using the format: List of scenario-level variables (macros) that may be used in scenario steps. headers text HTTP headers that will be sent when performing a request. status authentication 0 - enabled Web scenario status. 1 - disabled 0 - none 1 - basic 2 - NTLM Authentication method. http_user Authentication user name. http_password Authentication password for specified user name. verify_peer verify_host 0 - no 1 - yes 0 - no 1 - yes Verify the SSL certificate of the web server. Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches. ssl_cert_file Name of the SSL certificate file used for client authentication. ssl_key_file Name of the SSL private key file used for client authentication. Zabbix Documentation

20 Last update: 2017/08/02 07:06 manual:xml_export_import:hosts Element steps step Element property ssl_key_password Type Range Description SSL private key file password. Root element for web scenario steps. Individual web scenario step. name Web scenario step name. url URL for monitoring. posts text List of 'Post' variables. variables text List of step-level variables (macros) that should be applied after this step. If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix headers text HTTP headers that will be sent when performing a request. follow_redirects retrieve_mode 0 - no 1 - yes Follow HTTP redirects. 0 - content 1 - HTTP response retrieve mode. headers only timeout Timeout of step execution. Seconds, time unit with suffix or user macro. required Required. Ignored if empty. status_codes A comma delimited list of accepted status codes. Ignored if empty. For example: , From: - Zabbix Documentation 3.4 Permanent link: Last update: 2017/08/02 07:06 Printed on 2017/10/16 15:32