4 Hosts

    Overview

    Host export contains:

    • linked host groups
    • host data
    • template linkage
    • host group linkage
    • host interfaces
    • directly linked items
    • directly linked triggers
    • directly linked graphs
    • directly linked discovery rules with all prototypes
    • directly linked web scenarios
    • host macros
    • value maps

    Exporting

    To export hosts, do the following:

    • Go to: Data collection → Hosts
    • Mark the checkboxes of the hosts to export
    • Click on Export below the list

    • zabbix_export_hosts.yaml - in YAML export (default option for export)
    • zabbix_export_hosts.xml - in XML export
    • zabbix_export_hosts.json - in JSON export

    Importing

    To import hosts, do the following:

    • Go to: Data collection → Hosts
    • Click on Import to the right
    • Select the import file
    • Click on Import

    4 Hosts - 图2

    If you mark the Advanced options checkbox, a detailed list of all importable elements will be displayed - mark or unmark each import rule as required.

    Import rules:

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

    Export format

    Export format in YAML:

    Element tags

    Host tags
    ElementElement propertyRequiredTypeRange1Description
    host_groupsxRoot element for host groups.
    uuidxUnique identifier for this host group.
    namexstringHost group name.
    hosts-Root element for hosts.
    hostxstringUnique host name.
    name-stringVisible host name.
    description-textHost description.
    status-string0 - 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-string1 - CALLBACK
    2 - USER (default)
    3 - OPERATOR
    4 - ADMIN
    5 - OEM    		IPMI session privilege level.
    ipmi_username-stringUsername for IPMI checks.
    ipmi_password-stringPassword for IPMI checks.
    proxy-Proxy.
    namexstringName of the proxy (if any) that monitors the host.
    templates-Root element for linked templates.
    namexstringTemplate name.
    interfaces-Root element for host interfaces.
    default-string0 - 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-string1 - ZABBIX (default)
    2 - SNMP
    3 - IPMI
    4 - JMX    		Interface type.
    useip-string0 - NO
    1 - YES (default)    		Whether to use IP as the interface for connecting to the host (if not, DNS will be used).
    ip-stringIP address, can be either IPv4 or IPv6.

    Required if the connection is made via IP.
    dns-stringDNS name.

    Required if the connection is made via DNS.
    port-stringPort number. Supports user macros.
    interface_refxstringFormat: if<N>Interface reference name to be used in items.
    details-Root element for interface details.
    version-string1 - SNMPV1
    2 - SNMP_V2C (default)
    3 - SNMP_V3    		Use this SNMP version.
    community-stringSNMP community.

    Required by SNMPv1 and SNMPv2 items.
    contextname-stringSNMPv3 context name.

    Used only by SNMPv3 items.
    securityname-stringSNMPv3 security name.

    Used only by SNMPv3 items.
    securitylevel-string0 - NOAUTHNOPRIV (default)
    1 - AUTHNOPRIV
    2 - AUTHPRIV    		SNMPv3 security level.

    Used only by SNMPv3 items.
    authprotocol-string0 - MD5 (default)
    1 - SHA1
    2 - SHA224
    3 - SHA256
    4 - SHA384
    5 - SHA512    		SNMPv3 authentication protocol.

    Used only by SNMPv3 items.
    authpassphrase-stringSNMPv3 authentication passphrase.

    Used only by SNMPv3 items.
    privprotocol-string0 - DES (default)
    1 - AES128
    2 - AES192
    3 - AES256
    4 - AES192C
    5 - AES256C    		SNMPv3 privacy protocol.

    Used only by SNMPv3 items.
    privpassphrase-stringSNMPv3 privacy passphrase.

    Used only by SNMPv3 items.
    bulk-string0 - NO
    1 - YES (default)    		Use bulk requests for SNMP.
    items-Root element for items.
    For item element tag values, see host tags.
    tags-Root element for host tags.
    tagxstringTag name.
    value-stringTag value.
    macros-Root element for macros.
    macroxUser macro name.
    type-string0 - TEXT (default)
    1 - SECRET_TEXT
    2 - VAULT    		Type of the macro.
    value-stringUser macro value.
    description-stringUser macro description.
    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.
    valuemaps-Root element for host value maps.
    namexstringValue map name.
    mapping-Root element for mappings.
    valuexstringValue of a mapping.
    newvaluexstringNew value of a mapping.
    Host item tags
    Host low-level discovery rule tags
    ElementElement propertyRequiredTypeRange1Description
    discovery_rules-Root element for low-level discovery rules.
    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-string0 - ZABBIX_PASSIVE (default)
    2 - TRAP
    3 - SIMPLE
    5 - INTERNAL
    7 - ZABBIX_ACTIVE
    10 - EXTERNAL
    11 - ODBC
    12 - IPMI
    13 - SSH
    14 - TELNET
    16 - JMX
    18 - DEPENDENT
    19 - HTTP_AGENT
    20 - SNMP_AGENT    		Item type.
    lifetime-stringDefault: 30dTime period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.
    filterIndividual filter.
    evaltype-string0 - AND_OR (default)
    1 - AND
    2 - OR
    3 - FORMULA    		Logic to use for checking low-level discovery rule filter conditions.
    formula-stringCustom calculation formula for filter conditions.
    conditions-Root element for filter conditions.
    macroxstringLow-level discovery macro name.
    value-stringFilter value: regular expression or global regular expression.
    operator-string8 - MATCHES_REGEX (default)
    9 - NOT_MATCHES_REGEX    		Condition operator.
    formulaidxcharacterArbitrary 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_macroxstringLow-level discovery macro name.
    pathxstringSelector 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.
    typexstring5 - 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
    25 - STR_REPLACE
    27 - XML_TO_JSON    		Type of the item value preprocessing step.
    trigger_prototypes-Root element for trigger prototypes.
    For trigger prototype element tag values, see regular tags.
    graph_prototypes-Root element for graph prototypes.
    For graph prototype element tag values, see regular host graph tags.
    host_prototypes-Root element for host prototypes.
    For host prototype element tag values, see regular tags.
    item_prototypes-Root element for item prototypes.
    For item prototype element tag values, see regular host item tags.
    master_item-Individual item prototype master item/item prototype data.
    keyxstringDependent item prototype master item/item prototype key value.

    Required for a dependent item.
    Host trigger tags
    Host graph tags
    ElementElement propertyRequiredTypeRangeDescription
    graphs-Root element for graphs.
    namexGraph name.
    width-integer20-65535 (default: 900)Graph width, in pixels. Used for preview and for pie/exploded graphs.
    height-integer20-65535 (default: 200)Graph height, in pixels. Used for preview and for pie/exploded graphs.
    yaxismin-doubleDefault: 0Value of Y axis minimum.

    Used if ‘ymin_type_1’ is FIXED.
    yaxismax-doubleDefault: 0Value of Y axis maximum.

    Used if ‘ymax_type_1’ is FIXED.
    show_work_period-string0 - NO
    1 - YES (default)    		Highlight non-working hours.

    Used by normal and stacked graphs.
    show_triggers-string0 - NO
    1 - YES (default)    		Display simple trigger values as a line.

    Used by normal and stacked graphs.
    type-string0 - NORMAL (default)
    1 - STACKED
    2 - PIE
    3 - EXPLODED    		Graph type.
    show_legend-string0 - NO
    1 - YES (default)    		Display graph legend.
    show_3d-string0 - NO (default)
    1 - YES    		Enable 3D style.

    Used by pie and exploded pie graphs.
    percent_left-doubleDefault:0Show the percentile line for left axis.

    Used only for normal graphs.
    percent_right-doubleDefault:0Show the percentile line for right axis.

    Used only for normal graphs.
    ymin_type_1-string0 - CALCULATED (default)
    1 - FIXED
    2 - ITEM    		Minimum value of Y axis.

    Used by normal and stacked graphs.
    ymax_type_1-string0 - 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.
    hostxstringItem host.
    keyxstringItem key.
    ymax_item_1-Individual item details.

    Required if ‘ymax_type_1’ is ITEM.
    hostxstringItem host.
    keyxstringItem key.
    graph_itemsxRoot element for graph items.
    sortorder-integerDraw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.
    drawtype-string0 - 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-stringElement color (6 symbols, hex).
    yaxisside-string0 - 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-string1 - 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-string0 - SIMPLE (default)
    2 - GRAPH_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)    		Graph item type.
    itemxIndividual item.
    hostxstringItem host.
    keyxstringItem key.
    Host web scenario tags
    Footnotes

    1 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.