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

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 zbx_export_hosts.xml.

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

Note that before Zabbix 4.4.4, when a host is imported and updated, it can only be linked to additional templates and never be unlinked from any.

A success or failure message of the import will be displayed in the frontend.

Import rules:

Rule	Description
Update existing	Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.
Create new	The import will add new elements using data from the import file. Otherwise it will not add them.
Delete missing	The import will remove existing elements not present in the import file. Otherwise it will not remove them. If Delete missing is marked for template linkage (only available since 4.4.4), existing template linkage not present in the import file will be removed from the host along with all entities inherited from the potentially unlinked templates (items, triggers, etc).

Export format

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>4.4</version>
           <date>2019-10-23T07:47:33Z</date>
           <groups>
               <group>
                   <name>Discovered hosts</name>
               </group>
               <group>
                   <name>Zabbix servers</name>
               </group>
           </groups>
           <hosts>
               <host>
                   <host>Zabbix server 1</host>
                   <name>Main Zabbix server</name>
                   <proxy>
                       <name>Remote proxy</name>
                   </proxy>
                   <tls_connect>TLS_PSK</tls_connect>
                   <tls_accept>
                       <option>NO_ENCRYPTION</option>
                       <option>TLS_PSK</option>
                   </tls_accept>
                   <tls_psk_identity>z112</tls_psk_identity>
                   <tls_psk>1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952</tls_psk>
                   <templates>
                       <template>
                           <name>Template App Zabbix Server</name>
                       </template>
                       <template>
                           <name>Template OS Linux</name>
                       </template>
                   </templates>
                   <groups>
                       <group>
                           <name>Discovered hosts</name>
                       </group>
                       <group>
                           <name>Zabbix servers</name>
                       </group>
                   </groups>
                   <interfaces>
                       <interface>
                           <ip>192.168.1.1</ip>
                           <interface_ref>if1</interface_ref>
                       </interface>
                   </interfaces>
                   <items>
                       <item>
                           <name>Zabbix trap</name>
                           <type>TRAP</type>
                           <key>trap</key>
                           <delay>0</delay>
                           <history>1w</history>
                           <applications>
                               <application>
                                   <name>Zabbix server</name>
                               </application>
                           </applications>
                           <preprocessing>
                               <step>
                                   <type>MULTIPLIER</type>
                                   <params>8</params>
                               </step>
                           </preprocessing>
                           <triggers>
                               <trigger>
                                   <expression>{last()}=0</expression>
                                   <name>Last value is zero</name>
                                   <priority>WARNING</priority>
                                   <tags>
                                       <tag>
                                           <tag>Process</tag>
                                           <value>Internal test</value>
                                       </tag>
                                   </tags>
                               </trigger>
                           </triggers>
                       </item>
                   </items>
                   <tags>
                       <tag>
                           <tag>Process</tag>
                           <value>Zabbix</value>
                       </tag>
                   </tags>
                   <macros>
                       <macro>
                           <macro>{$HOST.MACRO}</macro>
                           <value>123</value>
                       </macro>
                   </macros>
                   <inventory>
                       <type>Zabbix server</type>
                       <name>yyyyyy-HP-Pro-3010-Small-Form-Factor-PC</name>
                       <os>Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64</os>
                   </inventory>
                   <inventory_mode>AUTOMATIC</inventory_mode>
               </host>
           </hosts>
           <graphs>
               <graph>
                   <name>CPU utilization server</name>
                   <show_work_period>NO</show_work_period>
                   <show_triggers>NO</show_triggers>
                   <graph_items>
                       <graph_item>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>FF5555</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,steal]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>1</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>55FF55</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,softirq]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>2</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>009999</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,interrupt]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>3</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>990099</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,nice]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>4</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>999900</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,iowait]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>5</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>990000</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,system]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>6</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>000099</color>
                           <calc_fnc>MIN</calc_fnc>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,user]</key>
                           </item>
                       </graph_item>
                       <graph_item>
                           <sortorder>7</sortorder>
                           <drawtype>FILLED_REGION</drawtype>
                           <color>009900</color>
                           <item>
                               <host>Zabbix server 1</host>
                               <key>system.cpu.util[,idle]</key>
                           </item>
                       </graph_item>
                   </graph_items>
               </graph>
           </graphs>
       </zabbix_export>

Element tags

Element tag values are explained in the table below.

Host tags

Element	Element property	Required	Type	Range¹	Description
groups		x			Root element for host groups.
group		x			Individual host group.
	name	x	`string`		Host group name.
hosts		-			Root element for hosts.
host		-			Individual host.
	host	x	`string`		Unique host name.
	name	-	`string`		Visible host name.
	description	-	`text`		Host description.
	status	-	`string`	0 - ENABLED (default) 1 - DISABLED	Host status.
	ipmi_authtype	-	`string`	-1 - DEFAULT (default) 0 - NONE 1 - MD2 2 - MD5 4 - STRAIGHT 5 - OEM 6 - RMCP_PLUS	IPMI session authentication type.
	ipmi_privilege	-	`string`	1 - CALLBACK 2 - USER (default) 3 - OPERATOR 4 - ADMIN 5 - OEM	IPMI session privilege level.
	ipmi_username	-	`string`		Username for IPMI checks.
	ipmi_password	-	`string`		Password for IPMI checks.
	tls_connect	-	`string`	1 - NO_ENCRYPTION (default) 2 - TLS_PSK 4 - TLS_CERTIFICATE	Type of outgoing connection.
tls_accept		-			Root element for incoming connection options.
	option	-	`string`	1 - NO_ENCRYPTION (default) 2 - TLS_PSK 4 - TLS_CERTIFICATE	Type of incoming connection. If both unencrypted and encrypted connection is allowed, the <option> property is used twice, one time with NO_ENCRYPTION and another with the encryption option (see example above).
	tls_issuer	-	`string`		Allowed agent/proxy certificate issuer.
	tls_subject	-	`string`		Allowed agent/proxy certificate subject.
	tls_psk_identity	-	`string`		PSK identity string. Required if either tls_connect or tls_accept has PSK enabled.
	tls_psk	-	`string`		The preshared key string, at least 32 hex digits. Required if either tls_connect or tls_accept has PSK enabled.
proxy		-			Proxy.
	name	x	`string`		Name of the proxy (if any) that monitors the host.
templates		-			Root element for linked templates.
template		-			Individual template.
	name	x	`string`		Template name.
interfaces		-			Root element for host interfaces.
interface		-			Individual interface.
	default	-	`string`	0 - NO 1 - YES (default)	Whether this is the primary host interface. There can be only one primary interface of one type on a host.
	type	-	`string`	1 - ZABBIX (default) 2 - SNMP 3 - IPMI 4 - JMX	Interface type.
	useip	-	`string`	0 - NO 1 - YES (default)	Whether to use IP as the interface for connecting to the host (if not, DNS will be used).
	ip	-	`string`		IP address, can be either IPv4 or IPv6. Required if the connection is made via IP.
	dns	-	`string`		DNS name. Required if the connection is made via DNS.
	port	-	`string`		Port number. Supports user macros.
	bulk	-	`string`	0 - NO 1 - YES (default)	Use bulk requests for SNMP.
	interface_ref	x	`string`	Format: `if<N>`	Interface reference name to be used in items.
items		-			Root element for items.
item		-			Individual item.
	For item element tag values, see host item tags.
tags		-			Root element for host tags.
tag		-			Individual host tag.
	tag	x	`string`		Tag name.
	value	-	`string`		Tag value.
macros		-			Root element for macros.
macro		-			Individual macro.
	name	-			User macro name.
	value	-			User macro value.
inventory		-			Root element for host inventory.
	<inventory_property>	-			Individual inventory property. All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).
	inventory_mode	-	`string`	-1 - DISABLED 0 - MANUAL (default) 1 - AUTOMATIC	Inventory mode.

Host item tags

Element	Element property	Required	Type	Range¹	Description
items		-			Root element for items.
item		-			Individual item.
	name	x	`string`		Item name.
	type	-	`string`	0 - ZABBIX_PASSIVE (default) 1 - SNMPV1 2 - TRAP 3 - SIMPLE 4 - SNMPV2 5 - INTERNAL 6 - SNMPV3 7 - ZABBIX_ACTIVE 8 - AGGREGATE 10 - EXTERNAL 11 - ODBC 12 - IPMI 13 - SSH 14 - TELNET 15 - CALCULATED 16 - JMX 17 - SNMP_TRAP 18 - DEPENDENT 19 - HTTP_AGENT	Item type.
	snmp_community	-	`string`		SNMP community. Required by SNMPv1 and SNMPv2 items.
	snmp_oid	-	`string`		SNMP object ID. Required by SNMP items.
	key	x	`string`		Item key.
	delay	-	`string`	Default: 1m	Update interval of the item. Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d). Optionally one or more custom intervals can be specified either as flexible intervals or scheduling. Multiple intervals are separated by a semicolon. User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported. Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).
	history	-	`string`	Default: 90d	A time unit of how long the history data should be stored. Time unit with suffix, user macro or LLD macro.
	trends	-	`string`	Default: 365d	A time unit of how long the trends data should be stored. Time unit with suffix, user macro or LLD macro.
	status	-	`string`	0 - ENABLED (default) 1 - DISABLED	Item status.
	value_type	-	`string`	0 - FLOAT 1 - CHAR 2 - LOG 3 - UNSIGNED (default) 4 - TEXT	Received value type.
	allowed_hosts	-	`string`		List of IP addresses (comma delimited) of hosts allowed sending data for the item. Used by trapper and HTTP agent items.
	units	-	`string`		Units of returned values (bps, B, etc).
	snmpv3_contextname	-	`string`		SNMPv3 context name. Used only by SNMPv3 items.
	snmpv3_securityname	-	`string`		SNMPv3 security name. Used only by SNMPv3 items.
	snmpv3_securitylevel	-	`string`	0 - NOAUTHNOPRIV (default) 1 - AUTHNOPRIV 2 - AUTHPRIV	SNMPv3 security level. Used only by SNMPv3 items.
	snmpv3_authprotocol	-	`string`	0 - MD5 (default) 1 - SHA	SNMPv3 authentication protocol. Used only by SNMPv3 items.
	snmpv3_authpassphrase	-	`string`		SNMPv3 authentication passphrase. Used only by SNMPv3 items.
	snmpv3_privprotocol	-	`string`	0 - DES (default) 1 - AES	SNMPv3 privacy protocol. Used only by SNMPv3 items.
	snmpv3_privpassphrase	-	`string`		SNMPv3 privacy passphrase. Used only by SNMPv3 items.
	params	-	`text`		Additional parameters depending on the type of the item: - executed script for SSH and Telnet items; - SQL query for database monitor items; - formula for calculated items.
	ipmi_sensor	-	`string`		IPMI sensor. Used only by IPMI items.
	authtype	-	`string`	Authentication type for SSH agent items: 0 - PASSWORD (default) 1 - PUBLIC_KEY Authentication type for HTTP agent items: 0 - NONE (default) 1 - BASIC 2 - NTLM	Authentication type. Used only by SSH and HTTP agent items.
	username	-	`string`		Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items. Required by SSH and Telnet items. When used by JMX agent, password should also be specified together with the username or both properties should be left blank.
	password	-	`string`		Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items. When used by JMX agent, username should also be specified together with the password or both properties should be left blank.
	publickey	-	`string`		Name of the public key file. Required for SSH agent items.
	privatekey	-	`string`		Name of the private key file. Required for SSH agent items.
	port	-	`string`		Custom port monitored by the item. Can contain user macros. Used only by SNMP items.
	description	-	`text`		Item description.
	inventory_link	-	`string`	0 - NONE Capitalized host inventory field name. For example: 4 - ALIAS 6 - OS_FULL 14 - HARDWARE etc.	Host inventory field that is populated by the item. Refer to the host inventory page for a list of supported host inventory fields and their IDs.
	logtimefmt	-	`string`		Format of the time in log entries. Used only by log items.
	interface_ref	-	`string`	Format: `if<N>`	Reference to the host interface.
	jmx_endpoint	-	`string`		JMX endpoint. Used only by JMX agent items.
	url	-	`string`		URL string. Required only for HTTP agent items.
	allow_traps	-	`string`	0 - NO (default) 1 - YES	Allow to populate value as in a trapper item. Used only by HTTP agent items.
	follow_redirects	-	`string`	0 - NO 1 - YES (default)	Follow HTTP response redirects while pooling data. Used only by HTTP agent items.
headers		-			Root element for HTTP(S) request headers, where header name is used as key and header value as value. Used only by HTTP agent items.
header		-			Individual header.
	name	x	`string`		Header name.
	value	x	`string`		Header value.
	http_proxy	-	`string`		HTTP(S) proxy connection string. Used only by HTTP agent items.
	output_format	-	`string`	0 - RAW (default) 1 - JSON	How to process response. Used only by HTTP agent items.
	post_type	-	`string`	0 - RAW (default) 2 - JSON 3 - XML	Type of post data body. Used only by HTTP agent items.
	posts	-	`string`		HTTP(S) request body data. Used only by HTTP agent items.
query_fields		-			Root element for query parameters. Used only by HTTP agent items.
query_field		-			Individual query parameter.
	name	x	`string`		Parameter name.
	value	-	`string`		Parameter value.
	request_method	-	`string`	0 - GET (default) 1 - POST 2 - PUT 3 - HEAD	Request method. Used only by HTTP agent items.
	retrieve_mode	-	`string`	0 - BODY (default) 1 - HEADERS 2 - BOTH	What part of response should be stored. Used only by HTTP agent items.
	ssl_cert_file	-	`string`		Public SSL Key file path. Used only by HTTP agent items.
	ssl_key_file	-	`string`		Private SSL Key file path. Used only by HTTP agent items.
	ssl_key_password	-	`string`		Password for SSL Key file. Used only by HTTP agent items.
	status_codes	-	`string`		Ranges of required HTTP status codes separated by commas. Supports user macros. Example: 200,200-{$M},{$M},200-400 Used only by HTTP agent items.
	timeout	-	`string`		Item data polling request timeout. Supports user macros. Used only by HTTP agent items.
	verify_host	-	`string`	0 - NO (default) 1 - YES	Validate if host name in URL is in Common Name field or a Subject Alternate Name field of host certificate. Used only by HTTP agent items.
	verify_peer	-	`string`	0 - NO (default) 1 - YES	Validate if host certificate is authentic. Used only by HTTP agent items.
value map		-			Value map.
	name	x	`string`		Name of the value map to use for the item.
applications		-			Root element for applications.
application		-			Individual application.
	name	x	`string`		Application name.
preprocessing		-			Root element for item value preprocessing.
step		-			Individual item value preprocessing step.
	type	x	`string`	1 - MULTIPLIER 2 - RTRIM 3 - LTRIM 4 - TRIM 5 - REGEX 6 - BOOL_TO_DECIMAL 7 - OCTAL_TO_DECIMAL 8 - HEX_TO_DECIMAL 9 - SIMPLE_CHANGE (calculated as (received value-previous value)) 10 - CHANGE_PER_SECOND (calculated as (received value-previous value)/(time now-time of last check)) 11 - XMLPATH 12 - JSONPATH 13 - IN_RANGE 14 - MATCHES_REGEX 15 - NOT_MATCHES_REGEX 16 - CHECK_JSON_ERROR 17 - CHECK_XML_ERROR 18 - CHECK_REGEX_ERROR 19 - DISCARD_UNCHANGED 20 - DISCARD_UNCHANGED_HEARTBEAT 21 - JAVASCRIPT 22 - PROMETHEUS_PATTERN 23 - PROMETHEUS_TO_JSON 24 - CSV_TO_JSON	Type of the item value preprocessing step.
	params	x	`string`		Parameters of the item value preprocessing step. Multiple parameters are separated by LF (\n) character.
	error_handler	-	`string`	0 - ORIGINAL_ERROR (default) 1 - DISCARD_VALUE 2 - CUSTOM_VALUE 3 - CUSTOM_ERROR	Action type used in case of preprocessing step failure.
	error_handler_params	-	`string`		Error handler parameters used with 'error_handler'.
master_item		-			Individual item master item. Required by dependent items.
	key	x	`string`		Dependent item master item key value. Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.
triggers		-			Root element for simple triggers.
trigger		-			Individual simple trigger.
	For trigger element tag values, see host trigger tags.

Host low-level discovery rule tags

Element	Element property	Required	Type	Range¹	Description
discovery_rules		-			Root element for low-level discovery rules.
discovery_rule		-			Individual low-level 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.
	type	-	`string`	0 - ZABBIX_PASSIVE (default) 1 - SNMPV1 2 - TRAP 3 - SIMPLE 4 - SNMPV2 5 - INTERNAL 6 - SNMPV3 7 - ZABBIX_ACTIVE 10 - EXTERNAL 11 - ODBC 12 - IPMI 13 - SSH 14 - TELNET 16 - JMX 18 - DEPENDENT 19 - HTTP_AGENT	Item type.
	lifetime	-	`string`	Default: 30d	Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.
filter					Individual filter.
	evaltype	-	`string`	0 - AND_OR (default) 1 - AND 2 - OR 3 - FORMULA	Logic to use for checking low-level discovery rule filter conditions.
	formula	-	`string`		Custom calculation formula for filter conditions.
conditions		-			Root element for filter conditions.
condition		-			Individual filter condition.
	macro	x	`string`		Low-level discovery macro name.
	value	-	`string`		Filter value: regular expression or global regular expression.
	operator	-	`string`	8 - MATCHES_REGEX (default) 9 - NOT_MATCHES_REGEX	Condition operator.
	formulaid	x	`character`		Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.
lld_macro_paths		-			Root element for LLD macro paths.
lld_macro_path		-			Individual LLD macro path.
	lld_macro	x	`string`		Low-level discovery macro name.
	path	x	`string`		Selector for value which will be assigned to the corresponding macro.
preprocessing		-			LLD rule value preprocessing.
step		-			Individual LLD rule value preprocessing step.
	For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.
	type	x	`string`	5 - REGEX 11 - XMLPATH 12 - JSONPATH 15 - NOT_MATCHES_REGEX 16 - CHECK_JSON_ERROR 17 - CHECK_XML_ERROR 20 - DISCARD_UNCHANGED_HEARTBEAT 21 - JAVASCRIPT 23 - PROMETHEUS_TO_JSON 24 - CSV_TO_JSON	Type of the item value preprocessing step.
trigger_prototypes		-			Root element for trigger prototypes.
trigger_prototype		-			Individual trigger prototype.
	For trigger prototype element tag values, see regular host trigger tags.
graph_prototypes		-			Root element for graph prototypes.
graph_prototype		-			Individual graph prototype.
	For graph prototype element tag values, see regular host graph tags.
host_prototypes		-			Root element for host prototypes.
host_prototype		-			Individual host prototype.
	For host prototype element tag values, see regular host tags.
item_prototypes		-			Root element for item prototypes.
item_prototype		-			Individual item prototype.
	For item prototype element tag values, see regular host item tags.
application_prototypes		-			Root element for application prototypes.
application_prototype		-			Individual application prototype.
	name	x	`string`		Application prototype name.
master_item		-			Individual item prototype master item/item prototype data.
	key	x	`string`		Dependent item prototype master item/item prototype key value. Required for a dependent item.

Host trigger tags

Element	Element property	Required	Type	Range¹	Description
triggers		-			Root element for triggers.
trigger		-			Individual trigger.
	expression	x	`string`		Trigger expression.
	recovery_mode	-	`string`	0 - EXPRESSION (default) 1 - RECOVERY_EXPRESSION 2 - NONE	Basis for generating OK events.
	recovery_expression	-	`string`		Trigger recovery expression.
	name	x	`string`		Trigger name.
	correlation_mode	-	`string`	0 - DISABLED (default) 1 - TAG_VALUE	Correlation mode (no event correlation or event correlation by tag).
	correlation_tag	-	`string`		The tag name to be used for event correlation.
	url	-	`string`		URL associated with the trigger.
	status	-	`string`	0 - ENABLED (default) 1 - DISABLED	Trigger status.
	priority	-	`string`	0 - NOT_CLASSIFIED (default) 1 - INFO 2 - WARNING 3 - AVERAGE 4 - HIGH 5 - DISASTER	Trigger severity.
	description	-	`text`		Trigger description.
	type	-	`string`	0 - SINGLE (default) 1 - MULTIPLE	Event generation type (single problem event or multiple problem events).
	manual_close	-	`string`	0 - NO (default) 1 - YES	Manual closing of problem events.
dependencies		-			Root element for dependencies.
dependency		-			Individual trigger dependency.
	name	x	`string`		Dependency trigger name.
	expression	x	`string`		Dependency trigger expression.
	recovery_expression	-	`string`		Dependency trigger recovery expression.
tags		-			Root element for event tags.
tag		-			Individual event tag.
	tag	x	`string`		Tag name.
	value	-	`string`		Tag value.

Host graph tags

Element	Element property	Required	Type	Range¹	Description
graphs		-			Root element for graphs.
graph		-			Individual graph.
	name	x	`string`		Graph name.
	width	-	`integer`	20-65535 (default: 900)	Graph width, in pixels. Used for preview and for pie/exploded graphs.
	height	-	`integer`	20-65535 (default: 200)	Graph height, in pixels. Used for preview and for pie/exploded graphs.
	yaxismin	-	`double`	Default: 0	Value of Y axis minimum. Used if 'ymin_type_1' is FIXED.
	yaxismax	-	`double`	Default: 0	Value of Y axis maximum. Used if 'ymax_type_1' is FIXED.
	show_work_period	-	`string`	0 - NO 1 - YES (default)	Highlight non-working hours. Used by normal and stacked graphs.
	show_triggers	-	`string`	0 - NO 1 - YES (default)	Display simple trigger values as a line. Used by normal and stacked graphs.
	type	-	`string`	0 - NORMAL (default) 1 - STACKED 2 - PIE 3 - EXPLODED	Graph type.
	show_legend	-	`string`	0 - NO 1 - YES (default)	Display graph legend.
	show_3d	-	`string`	0 - NO (default) 1 - YES	Enable 3D style. Used by pie and exploded pie graphs.
	percent_left	-	`double`	Default:0	Show the percentile line for left axis. Used only for normal graphs.
	percent_right	-	`double`	Default:0	Show the percentile line for right axis. Used only for normal graphs.
	ymin_type_1	-	`string`	0 - CALCULATED (default) 1 - FIXED 2 - ITEM	Minimum value of Y axis. Used by normal and stacked graphs.
	ymax_type_1	-	`string`	0 - CALCULATED (default) 1 - FIXED 2 - ITEM	Maximum value of Y axis. Used by normal and stacked graphs.
ymin_item_1		-			Individual item details. Required if 'ymin_type_1' is ITEM.
	host	x	`string`		Item host.
	key	x	`string`		Item key.
ymax_item_1		-			Individual item details. Required if 'ymax_type_1' is ITEM.
	host	x	`string`		Item host.
	key	x	`string`		Item key.
graph_items		x			Root element for graph items.
graph_item		x			Individual graph item.
	sortorder	-	`integer`		Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.
	drawtype	-	`string`	0 - SINGLE_LINE (default) 1 - FILLED_REGION 2 - BOLD_LINE 3 - DOTTED_LINE 4 - DASHED_LINE 5 - GRADIENT_LINE	Draw style of the graph item. Used only by normal graphs.
	color	-	`string`		Element colour (6 symbols, hex).
	yaxisside	-	`string`	0 - LEFT (default) 1 - RIGHT	Side of the graph where the graph item's Y scale will be drawn. Used by normal and stacked graphs.
	calc_fnc	-	`string`	1 - MIN 2 - AVG (default) 4 - MAX 7 - ALL (minimum, average and maximum; used only by simple graphs) 9 - LAST (used only by pie and exploded pie graphs)	Data to draw if more than one value exists for an item.
	type	-	`string`	0 - SIMPLE (default) 2 - GRAPH_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)	Graph item type.
item		x			Individual item.
	host	x	`string`		Item host.
	key	x	`string`		Item key.

Host web scenario tags

Element	Element property	Required	Type	Range¹	Description
httptests		-			Root element for web scenarios.
httptest		-			Individual web scenario.
	name	x	`string`		Web scenario name.
	delay	-	`string`	Default: 1m	Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.
	attempts	-	`integer`	1-10 (default: 1)	The number of attempts for executing web scenario steps.
	agent	-	`string`	Default: Zabbix	Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.
	http_proxy	-	`string`		Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.mycompany.com[:port]`
variables		-			Root element for scenario-level variables (macros) that may be used in scenario steps.
variable		-			Individual variable.
	name	x	`text`		Variable name.
	value	x	`text`		Variable value.
headers		-			Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.
header		-			Individual header.
	name	x	`text`		Header name.
	value	x	`text`		Header value.
	status	-	`string`	0 - ENABLED (default) 1 - DISABLED	Web scenario status.
	authentication	-	`string`	0 - NONE (default) 1 - BASIC 2 - NTLM	Authentication method.
	http_user	-	`string`		User name used for basic, HTTP or NTLM authentication.
	http_password	-	`string`		Password used for basic, HTTP or NTLM authentication.
	verify_peer	-	`string`	0 - NO (default) 1 - YES	Verify the SSL certificate of the web server.
	verify_host	-	`string`	0 - NO (default) 1 - YES	Verify that the Common Name field or the Subject Alternate Name field of the web server certificate matches.
	ssl_cert_file	-	`string`		Name of the SSL certificate file used for client authentication (must be in PEM format).
	ssl_key_file	-	`string`		Name of the SSL private key file used for client authentication (must be in PEM format).
	ssl_key_password	-	`string`		SSL private key file password.
steps		x			Root element for web scenario steps.
step		x			Individual web scenario step.
	name	x	`string`		Web scenario step name.
	url	x	`string`		URL for monitoring.
query_fields		-			Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.
query_field		-			Individual query field.
	name	x	`string`		Query field name.
	value	-	`string`		Query field value.
posts		-			HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).
post_field		-			Individual post field.
	name	x	`string`		Post field name.
	value	x	`string`		Post field value.
variables		-			Root element 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
variable		-			Individual variable.
	name	x	`string`		Variable name.
	value	x	`string`		Variable value.
headers		-			Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.
header		-			Individual header.
	name	x	`string`		Header name.
	value	x	`string`		Header value.
	follow_redirects	-	`string`	0 - NO 1 - YES (default)	Follow HTTP redirects.
	retrieve_mode	-	`string`	0 - BODY (default) 1 - HEADERS 2 - BOTH	HTTP response retrieve mode.
	timeout	-	`string`	Default: 15s	Timeout of step execution. Seconds, time unit with suffix or user macro.
	required	-	`string`		Text that must be present in the response. Ignored if empty.
	status_codes	-	`string`		A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299

Footnotes

¹ For string values, only the string will be exported (e.g. "ZABBIX_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only.

Documentation