4 Hosts

Übersicht

Hosts werden exportiert zusammen mit vielen zugehörigen Objekten und Objektbeziehungen.

Der Host-Export enthält:

  • Verknüpfte Host-Gruppen
  • Host-Daten
  • Vorlagen-Verknüpfung
  • Host-Gruppen-Verknüpfung
  • Host-Schnittstellen
  • Direkt verknüpfte Datenpunkte
  • Direkt verknüpfte Auslöser
  • Direkt verknüpfte Discovery-Regeln mit allen Prototypen
  • Direkt verknüpfte Webszenarien
  • Host-Makros
  • Host-Inventardaten
  • Wertezuordnungen
  • Verknüpfte Graphen

Exportieren

Um Hosts zu exportieren, gehen Sie wie folgt vor:

  1. Gehen Sie zu Datenerfassung → Hosts.
  2. Aktivieren Sie die Kontrollkästchen der zu exportierenden Hosts.
  3. Klicken Sie unterhalb der Liste auf Exportieren.

Je nach ausgewähltem Format werden Hosts in eine lokale Datei mit einem Standardnamen exportiert:

  • zabbix_export_hosts.yaml - beim YAML-Export (Standardoption für den Export);
  • zabbix_export_hosts.xml - beim XML-Export;
  • zabbix_export_hosts.json - beim JSON-Export.

Importieren

Um Hosts zu importieren, gehen Sie wie folgt vor:

  1. Gehen Sie zu Datenaufzeichnung → Hosts.
  2. Klicken Sie oben rechts auf Importieren.
  3. Wählen Sie die Importdatei aus.
  4. Klicken Sie unten rechts im Konfigurationsformular auf Importieren.

Wenn Sie das Kontrollkästchen Erweiterte Optionen aktivieren, wird eine detaillierte Liste aller importierbaren Elemente angezeigt - markieren oder deaktivieren Sie jede Importregel nach Bedarf.

Wenn Sie das Kontrollkästchen in der Zeile Alle aktivieren, werden alle darunterliegenden Elemente markiert/deaktiviert.

Importregeln:

Rule Description
Update existing Vorhandene Elemente werden mit Daten aus der Importdatei aktualisiert. Andernfalls werden sie nicht aktualisiert.
Create new Neue Elemente werden mit Daten aus der Importdatei erstellt. Andernfalls werden sie nicht erstellt.
Delete missing Vorhandene Elemente, die in der Importdatei nicht vorhanden sind, werden entfernt. Andernfalls werden sie nicht entfernt.
Wenn Delete missing für Template linkage aktiviert ist, wird die aktuelle Vorlagenverknüpfung, die in der Importdatei nicht vorhanden ist, aufgehoben. Von den getrennten Vorlagen geerbte Entitäten (Datenpunkte, Auslöser, Graphen usw.) werden nicht entfernt (es sei denn, die Option Delete missing ist auch für jede Entität ausgewählt).

Eine Erfolgs- oder Fehlermeldung des Imports wird im Frontend angezeigt.

Exportformat

Exportformat in YAML:

zabbix_export:
  version: '7.0'
  host_groups:
    - uuid: f2481361f99448eea617b7b1d4765566
      name: 'Discovered hosts'
    - uuid: 6f6799aa69e844b4b3918f779f2abf08
      name: 'Zabbix servers'
  hosts:
    - host: 'Zabbix server 1'
      name: 'Main Zabbix server'
      monitored_by: 'SERVER'
      templates:
        - name: 'Linux by Zabbix agent'
        - name: 'Zabbix server health'
      groups:
        - name: 'Discovered hosts'
        - name: 'Zabbix servers'
      interfaces:
        - ip: 192.168.1.1
          interface_ref: if1
      items:
        - name: 'Zabbix trap'
          type: TRAP
          key: trap
          delay: '0'
          history: 1w
          preprocessing:
            - type: MULTIPLIER
              parameters:
                - '8'
          tags:
            - tag: component
              value: 'raw'
          triggers:
            - expression: 'last(/Zabbix server 1/trap)=0'
              name: 'Letzter Wert ist null'
              priority: WARNING
              tags:
                - tag: scope
                  value: 'availability'
      tags:
        - tag: service
          value: zabbix-server
      macros:
        - macro: '{$HOST.MACRO}'
          value: '123'
        - macro: '{$PASSWORD1}'
          type: SECRET_TEXT
      inventory:
        type: 'Zabbix server'
        name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
        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'
      inventory_mode: AUTOMATIC
  graphs:
    - name: 'CPU-Auslastung Server'
      show_work_period: 'NO'
      show_triggers: 'NO'
      graph_items:
        - drawtype: FILLED_REGION
          color: FF5555
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,steal]'
        - sortorder: '1'
          drawtype: FILLED_REGION
          color: 55FF55
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,softirq]'
        - sortorder: '2'
          drawtype: FILLED_REGION
          color: '009999'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,interrupt]'
        - sortorder: '3'
          drawtype: FILLED_REGION
          color: '990099'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,nice]'
        - sortorder: '4'
          drawtype: FILLED_REGION
          color: '999900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,iowait]'
        - sortorder: '5'
          drawtype: FILLED_REGION
          color: '990000'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,system]'
        - sortorder: '6'
          drawtype: FILLED_REGION
          color: '000099'
          calc_fnc: MIN
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,user]'
        - sortorder: '7'
          drawtype: FILLED_REGION
          color: '009900'
          item:
            host: 'Zabbix server 1'
            key: 'system.cpu.util[,idle]'

Exportierte Elemente

Exportierte Elemente werden in den folgenden Tabellen erläutert.

Element Type Description
version string (erforderlich) Zabbix-Version.
host_groups (erforderlich) Wurzelelement für Host-Gruppen.
uuid string (erforderlich) Eindeutiger Bezeichner für diese Host-Gruppe.
name string (erforderlich) Name der Host-Gruppe.
hosts Wurzelelement für Hosts.

Hosts

Element Type Description
host string (erforderlich) Eindeutiger Hostname.
name string Sichtbarer Hostname.
description text Host-Beschreibung.
monitored_by string Host wird überwacht von: SERVER, PROXY oder PROXY_GROUP.
proxy Stammelement für Proxy.
name string (erforderlich) Name des Proxys (falls vorhanden), der den Host überwacht.
proxy_group Stammelement für Proxy-Gruppe.
name string (erforderlich) Name der Proxy-Gruppe (falls vorhanden), die zur Überwachung des Hosts verwendet wird.
status string Host-Status.
Mögliche Werte:1 ENABLED (0, Standard), DISABLED (1).
ipmi_authtype string Authentifizierungstyp der IPMI-Sitzung.
Mögliche Werte:1 DEFAULT (-1, Standard), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6).
ipmi_privilege string Berechtigungsstufe der IPMI-Sitzung.
Mögliche Werte:1 CALLBACK (1), USER (2, Standard), OPERATOR (3), ADMIN (4), OEM (5).
ipmi_username string Benutzername für IPMI-Prüfungen.
ipmi_password string Passwort für IPMI-Prüfungen.
templates Stammelement für verknüpfte Vorlagen.
name string (erforderlich) Vorlagenname.
groups Stammelement für Host-Gruppen, zu denen der Host gehört.
name string (erforderlich) Host-Gruppenname.
interfaces Stammelement für Host-Schnittstellen.
items Stammelement für Host-Datenpunkte.
discovery_rules Stammelement für Low-Level-Discovery-Regeln des Hosts.
http_tests Stammelement für Web-Szenarien des Hosts.
tags Stammelement für Host-Tags.
tag string (erforderlich) Tag-Name.
value string Tag-Wert.
macros Stammelement für Host-Makros.
macro string (erforderlich) Name des Benutzer-Makros.
type string Typ des Benutzer-Makros.
Mögliche Werte:1 TEXT (0, Standard), SECRET_TEXT (1), VAULT (2).
value string Wert des Benutzer-Makros.
description string Beschreibung des Benutzer-Makros.
inventory Stammelement für das Host-Inventar.
<inventory_property> string Inventareigenschaft. Alle Eigenschaften haben ihr jeweiliges Element (type, name, os usw.; siehe beispielsweise Exportformat).
inventory_mode string Inventarmodus.
Mögliche Werte:1 DISABLED (-1), MANUAL (0, Standard), AUTOMATIC (1).
valuemaps Stammelement für Host-Wertzuordnungen.

Siehe auch: Host-Objekt (verweisen Sie auf die entsprechende Eigenschaft mit demselben Namen).

Host-Schnittstellen

Element Typ Beschreibung
default string Gibt an, ob dies die primäre Host-Schnittstelle ist. Beachten Sie, dass es auf einem Host nur eine primäre Schnittstelle eines Typs geben kann.
Mögliche Werte:1 NO (0), YES (1, default).
type string Schnittstellentyp.
Mögliche Werte:1 ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).
useip string Gibt an, ob IP als Schnittstelle für die Verbindung zum Host verwendet werden soll (andernfalls wird DNS verwendet).
Mögliche Werte:1 NO (0), YES (1, default).
ip string (erforderlich für IP-Verbindungen) IP-Adresse (IPv4 oder IPv6).
dns string (erforderlich für DNS-Verbindungen) DNS-Name.
port string Portnummer.
details Stammelement für Schnittstellendetails.
version string Diese SNMP-Version verwenden.
Mögliche Werte:1 SNMPV1 (1), SNMP_V2C (2, default), SNMP_V3 (3).
community string (erforderlich für SNMPv1- und SNMPv2-Datenpunkte) SNMP-Community.
max_repetitions string Maximaler Wiederholungswert für native SNMP-Bulk-Anfragen (GetBulkRequest-PDUs).
Unterstützt für SNMPv2- und SNMPv3-Datenpunkte (discovery[]- und walk[]-Datenpunkte).
Standard: 10.
contextname string SNMPv3-Kontextname.
Unterstützt für SNMPv3-Datenpunkte.
securityname string SNMPv3-Sicherheitsname.
Unterstützt für SNMPv3-Datenpunkte.
securitylevel string SNMPv3-Sicherheitsstufe.
Unterstützt für SNMPv3-Datenpunkte.
Mögliche Werte:1 NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).
authprotocol string SNMPv3-Authentifizierungsprotokoll.
Unterstützt für SNMPv3-Datenpunkte.
Mögliche Werte:1 MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).
authpassphrase string SNMPv3-Authentifizierungs-Passphrase.
Unterstützt für SNMPv3-Datenpunkte.
privprotocol string SNMPv3-Datenschutzprotokoll.
Unterstützt für SNMPv3-Datenpunkte.
Mögliche Werte:1 DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).
privpassphrase string SNMPv3-Datenschutz-Passphrase.
Unterstützt für SNMPv3-Datenpunkte.
bulk string Bulk-Anfragen für SNMP verwenden.
Mögliche Werte:1 NO (0), YES (1, default).
interface_ref string Referenzname der Schnittstelle, der in Datenpunkten verwendet werden soll (Format: if<N>).

Siehe auch: Host interface object (verweisen Sie auf die entsprechende Eigenschaft mit passendem Namen).

Host-Datenpunkte

Element Type Description
name string (required) Datenpunktname.
type string Datenpunkttyp.
Mögliche Werte:1 ZABBIX_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
snmp_oid string (required for SNMP_AGENT items) SNMP-Objekt-ID.
key string (required) Datenpunktschlüssel.
delay string Aktualisierungsintervall des Datenpunkts.
Standard: 1m. Der Wert ist für TRAP-Datenpunkte immer 0.
history string Zeitraum (unter Verwendung von Zeitsuffix, Benutzermakro oder LLD-Makro), für den die Verlaufsdaten gespeichert werden sollen.
Standard: 31d.
trends string Zeitraum (unter Verwendung von Zeitsuffix, Benutzermakro oder LLD-Makro), für den die Trenddaten gespeichert werden sollen.
Standard: 365d.
status string Datenpunktstatus.
Mögliche Werte:1 ENABLED (0, default), DISABLED (1).
value_type string Typ des empfangenen Werts.
Mögliche Werte:1 FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).
allowed_hosts string Liste der durch Kommas getrennten IP-Adressen von Hosts, die Daten für den Datenpunkt senden dürfen.
Unterstützt für TRAP- und HTTP_AGENT-Datenpunkte.
units string Einheiten des empfangenen Werts (bps, B, usw.).
params text Zusätzliche Parameter abhängig vom Typ des Datenpunkts (ausgeführtes Skript für SSH- und TELNET-Datenpunkte; SQL-Abfrage für ODBC-Datenpunkte; Formel für CALCULATED-Datenpunkte; das Skript für ITEM_TYPE_SCRIPT- und ITEM_TYPE_BROWSER-Datenpunkte).
ipmi_sensor string IPMI-Sensor.
Unterstützt für IPMI-Datenpunkte.
authtype string Authentifizierungstyp.
Unterstützt für SSH- und HTTP_AGENT-Datenpunkte.
Mögliche Werte für SSH-Datenpunkte:1 PASSWORD (0, default), PUBLIC_KEY (1).
Mögliche Werte für HTTP_AGENT-Datenpunkte:1 NONE (0, default), BASIC (1), NTLM (2), Kerberos (3) oder Digest (4).
username string (required for SSH and TELNET items) Benutzername für die Authentifizierung.
Unterstützt für SIMPLE-, ODBC-, JMX- und HTTP_AGENT-Datenpunkte.
Wenn für JMX-Datenpunkte verwendet, sollte auch password (siehe unten) angegeben werden oder beide Elemente sollten leer bleiben.
password string (required for SSH and TELNET items) Passwort für die Authentifizierung.
Unterstützt für SIMPLE-, ODBC-, JMX- und HTTP_AGENT-Datenpunkte.
Wenn für JMX-Datenpunkte verwendet, sollte auch username (siehe oben) angegeben werden oder beide Elemente sollten leer bleiben.
publickey string (required for SSH items) Name der Datei mit dem öffentlichen Schlüssel.
privatekey string (required for SSH items) Name der Datei mit dem privaten Schlüssel.
description text Datenpunktbeschreibung.
inventory_link string Host-Inventarfeld, das vom Datenpunkt befüllt wird.
Mögliche Werte:1 NONE (0), ALIAS (4), usw. (siehe Host inventory für unterstützte Felder).
valuemap Wurzelelement für Wertzuordnungen des Datenpunkts.
name string (required) Name der für den Datenpunkt zu verwendenden Wertzuordnung.
logtimefmt string Format der Zeit in Protokolleinträgen.
Unterstützt für Datenpunkte vom Werttyp LOG.
preprocessing Wurzelelement für die Vorverarbeitung von Datenpunktwerten.
step Wurzelelement für Vorverarbeitungsschritte von Host-Datenpunkten.
interface_ref string Verweis auf die Host-Schnittstelle (Format: if<N>).
jmx_endpoint string JMX-Endpunkt.
Unterstützt für JMX-Datenpunkte.
master_item (required for DEPENDENT items) Wurzelelement für das Master-Datenpunkt des abhängigen Datenpunkts.
key string (required) Schlüssel des Master-Datenpunkts des abhängigen Datenpunkts.
timeout string Zeitüberschreitung für die Abfrageanforderung der Datenpunktdaten.
Unterstützt für die Liste der Datenpunkttypen Timeouts.
url string (required for HTTP_AGENT items) URL-Zeichenfolge.
query_fields Wurzelelement für Abfrageparameter.
Unterstützt für HTTP_AGENT-Datenpunkte.
name string (required for HTTP_AGENT items) Name des Abfrageparameters.
value string Wert des Abfrageparameters.
Unterstützt für HTTP_AGENT-Datenpunkte.
parameters Wurzelelement für benutzerdefinierte Parameter.
Unterstützt für ITEM_TYPE_SCRIPT- und ITEM_TYPE_BROWSER-Datenpunkte.
name string (required for ITEM_TYPE_SCRIPT and ITEM_TYPE_BROWSER items) Name des benutzerdefinierten Parameters.
value string Wert des benutzerdefinierten Parameters.
Unterstützt für ITEM_TYPE_SCRIPT- und ITEM_TYPE_BROWSER-Datenpunkte.
posts string Daten des HTTP(S)-Anforderungstexts.
Unterstützt für HTTP_AGENT-Datenpunkte.
status_codes string Durch Kommas getrennte Bereiche erforderlicher HTTP-Statuscodes.
Unterstützt für HTTP_AGENT-Datenpunkte.
follow_redirects string Weiterleitungen der Antwort beim Abrufen von Daten folgen.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 NO (0), YES (1, default).
post_type string Typ des Post-Datenkörpers.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 RAW (0, default), JSON (2), XML (3).
http_proxy string Verbindungszeichenfolge für HTTP(S)-Proxy.
Unterstützt für HTTP_AGENT-Datenpunkte.
headers Wurzelelement für HTTP(S)-Anforderungsheader.
Unterstützt für HTTP_AGENT-Datenpunkte.
name string (required for HTTP_AGENT items) Name des Headers.
value string (required for HTTP_AGENT items) Wert des Headers.
retrieve_mode string Welcher Teil der Antwort gespeichert werden soll.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 BODY (0, default), HEADERS (1), BOTH (2).
request_method string Typ der Anforderungsmethode.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 GET (0, default), POST (1), PUT (2), HEAD (3).
output_format string Wie die Antwort verarbeitet werden soll.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 RAW (0, default), JSON (1).
allow_traps string Erlaubt das Befüllen des Werts ähnlich wie beim Trapper-Datenpunkt.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 NO (0, default), YES (1).
ssl_cert_file string Pfad zur öffentlichen SSL-Schlüsseldatei.
Unterstützt für HTTP_AGENT-Datenpunkte.
ssl_key_file string Pfad zur privaten SSL-Schlüsseldatei.
Unterstützt für HTTP_AGENT-Datenpunkte.
ssl_key_password string Passwort für die SSL-Schlüsseldatei.
Unterstützt für HTTP_AGENT-Datenpunkte.
verify_peer string Ob geprüft werden soll, dass das Zertifikat des Hosts gültig ist.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 NO (0, default), YES (1).
verify_host string Ob geprüft werden soll, dass der Hostname der Verbindung mit dem im Zertifikat des Hosts übereinstimmt.
Unterstützt für HTTP_AGENT-Datenpunkte.
Mögliche Werte:1 NO (0, default), YES (1).
tags Wurzelelement für Datenpunkt-Tags.
tag string (required) Tag-Name.
value string Tag-Wert.
triggers Wurzelelement für Host-Datenpunkt-Auslöser.

Siehe auch: Datenpunkt-Objekt (verweisen Sie auf die jeweilige Eigenschaft mit passendem Namen).

Host-Datenpunkt-Werte-Preprocessing-Schritte
Element Type Description
type string (erforderlich) Der Typ des Preprocessing-Schritts für den Datenpunktwert.
Mögliche Werte:1 MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, berechnet: empfangener Wert - vorheriger Wert), CHANGE_PER_SECOND (10, berechnet: (empfangener Wert - vorheriger Wert)/(aktuelle Zeit - Zeit der letzten Prüfung)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters (erforderlich) Wurzelelement für Parameter des Preprocessing-Schritts für den Datenpunktwert.
parameter string Einzelner Parameter des Preprocessing-Schritts für den Datenpunktwert.
error_handler string Aktionstyp, der im Falle eines Fehlers beim Preprocessing verwendet wird.
Mögliche Werte:1 ORIGINAL_ERROR (0, Standard), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params string Parameter des Fehlerbehandlers.

Siehe auch: Item preprocessing object (verweist auf die entsprechende Eigenschaft mit demselben Namen).

Host-Datenpunkt-Auslöser
Element Type Description
uuid string (required) Eindeutige Kennung für diesen Auslöser.
expression string (required) Auslöserausdruck.
recovery_mode string Grundlage für die Generierung von OK-Ereignissen.
Mögliche Werte:1 EXPRESSION (0, default), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression string Ausdruck zur Wiederherstellung des Auslösers.
correlation_mode string Korrelationsmodus (keine Ereigniskorrelation oder Ereigniskorrelation nach Tag).
Mögliche Werte:1 DISABLED (0, default), TAG_VALUE (1).
correlation_tag string Der Tag-Name, der für die Ereigniskorrelation verwendet werden soll.
name string (required) Name des Auslösers.
event_name string Ereignisname.
opdata string Betriebsdaten.
url_name string Bezeichnung für die mit dem Auslöser verknüpfte URL.
url string Mit dem Auslöser verknüpfte URL.
status string Status des Auslösers.
Mögliche Werte:1 ENABLED (0, default), DISABLED (1).
priority string Schweregrad des Auslösers.
Mögliche Werte:1 NOT_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description text Beschreibung des Auslösers.
type string Typ der Ereignisgenerierung (einzelnes Problemereignis oder mehrere Problemereignisse).
Mögliche Werte:1 SINGLE (0, default), MULTIPLE (1).
manual_close string Manuelles Schließen von Problemereignissen.
Mögliche Werte:1 NO (0, default), YES (1).
dependencies Wurzelelement für Abhängigkeiten.
name string (required) Name des Abhängigkeitsauslösers.
expression string (required) Ausdruck des Abhängigkeitsauslösers.
recovery_expression string Wiederherstellungsausdruck des Abhängigkeitsauslösers.
tags Wurzelelement für Auslöser-Tags.
tag string (required) Tag-Name.
value string Tag-Wert.

Siehe auch: Trigger object (verweisen Sie auf die entsprechende Eigenschaft mit demselben Namen).

Host-Low-Level-Discovery-Regeln

Die meisten Elemente von Host-Low-Level-Discovery-Regeln sind dieselben wie bei Host-Datenpunkten. Die folgende Tabelle beschreibt nur die Elemente, die sich von Host-Datenpunkten unterscheiden.

Element Type Description
type string Datenpunkt-Typ.
Mögliche Werte:1 ZABBIX_PASSIVE (0, Standard), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key string (erforderlich) Der Schlüssel der Low-Level-Discovery-Regel.
filter Wurzelelement für Filter von Host-Low-Level-Discovery-Regeln.
lifetime string Zeitraum (in Sekunden, mit Zeitsuffix oder Benutzermakro), nach dessen Ablauf nicht mehr erkannte Ressourcen gelöscht werden.
Standard: 7d.
lifetime_type string Szenario zum Löschen verlorener LLD-Ressourcen.
Mögliche Werte: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime string Zeitraum (in Sekunden, mit Zeitsuffix oder Benutzermakro), nach dessen Ablauf nicht mehr erkannte Ressourcen deaktiviert werden.
enabled_lifetime_type string Szenario zum Deaktivieren verlorener LLD-Ressourcen.
Mögliche Werte: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes Wurzelelement für Host-Datenpunktprototypen, die dieselben sind wie bei Host-Datenpunkten.
trigger_prototypes Wurzelelement für Host-Auslöserprototypen, die dieselben sind wie bei Host-Datenpunkt-Auslösern.
graph_prototypes Wurzelelement für Host-Graphprototypen, die dieselben sind wie bei Host-Graphen.
host_prototypes Wurzelelement für Hostprototypen, die dieselben sind wie bei Hosts.
master_item string (erforderlich für DEPENDENT-Regeln) Wurzelelement für den Master-Datenpunkt der abhängigen Regel.
lld_macro_paths Wurzelelement für Makropfade der Low-Level-Discovery-Regel.
lld_macro string (erforderlich) Name des Low-Level-Discovery-Regel-Makros.
path string (erforderlich) Selektor für den Wert, der dem entsprechenden Makro zugewiesen wird.
preprocessing Wurzelelement für die Vorverarbeitung des Werts der Low-Level-Discovery-Regel.
step Wurzelelement für Elemente der Vorverarbeitungsschritte der Low-Level-Discovery-Regel; diese sind dieselben wie bei Vorverarbeitungsschritten von Host-Datenpunkten, jedoch mit weniger möglichen Werten. Siehe auch: LLD-Regel-Vorverarbeitungsobjekt.
overrides Wurzelelement für Überschreibungsregeln der Low-Level-Discovery-Regel.
name string (erforderlich) Eindeutiger Name der Überschreibung.
step string (erforderlich) Eindeutige Ordnungsnummer der Überschreibung.
stop string Die Verarbeitung weiterer Überschreibungen beenden, wenn eine Übereinstimmung vorliegt.
filter Wurzelelement für Filterelemente der Überschreibungsregel der Low-Level-Discovery-Regel; diese sind dieselben wie bei Filtern von Host-Low-Level-Discovery-Regeln.
operations Wurzelelement für Überschreibungsoperationen von Host-Low-Level-Discovery-Regeln.

Siehe auch: LLD-Regelobjekt (verweisen Sie auf die entsprechende Eigenschaft mit demselben Namen).

Host Low-Level-Discovery-Regelfilter
Element Type Beschreibung
evaltype string Überschreibt die Methode zur Auswertung der Filterbedingung.
Mögliche Werte:1 AND_OR (0, Standard), AND (1), OR (2), FORMULA (3).
formula string Benutzerdefinierte Berechnungsformel für Filterbedingungen.
conditions Wurzelelement für Filterbedingungen.
macro string (erforderlich) Der Name des Low-Level-Discovery-Makros, für das die Prüfung durchgeführt werden soll.
value string Wert, mit dem verglichen werden soll.
operator string Bedingungsoperator.
Mögliche Werte:1 MATCHES_REGEX (8, Standard), NOT_MATCHES_REGEX (9).
formulaid string (erforderlich) Beliebige eindeutige ID, die verwendet wird, um in der benutzerdefinierten Ausdrucksformel auf eine Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer beim Ändern von Filterbedingungen definiert werden, wird jedoch bei einer späteren Abfrage neu generiert.

Siehe auch: LLD rule filter object (siehe die entsprechende Eigenschaft mit demselben Namen).

Host Low-Level-Discovery-Regel-Override-Operationen
Element Type Description
operationobject string Objekt, auf das die Operation angewendet wird.
Mögliche Werte:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Operator der Override-Bedingung.
Mögliche Werte:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value string Ein regulärer Ausdruck oder eine Zeichenfolge für den Operator der Override-Bedingung.
status string Status des Objekts nach der Override-Operation.
discover string Ob das Objekt als Ergebnis der Erkennung hinzugefügt wird.
delay string Für den Datenpunkt-Prototyp nach der Override-Operation festgelegtes Aktualisierungsintervall.
history string Für den Datenpunkt-Prototyp nach der Override-Operation festgelegte Speicherfrist für Historie.
trends string Für den Datenpunkt-Prototyp nach der Override-Operation festgelegte Speicherfrist für Trends.
severity string Für den Auslöser-Prototyp nach der Override-Operation festgelegte Schweregradstufe.
tags Wurzelelement für die Tags, die für das Objekt nach der Override-Operation festgelegt werden.
tag string (erforderlich) Tag-Name.
value string Tag-Wert.
templates Wurzelelement für die mit dem Host-Prototyp verknüpften Vorlagen nach der Override-Operation.
name string (erforderlich) Vorlagenname.
inventory_mode string Für den Host-Prototyp nach der Override-Operation festgelegter Inventarmodus.

Siehe auch: LLD rule override operation object (siehe die entsprechende Eigenschaft mit demselben Namen).

Host-Webszenarien

Element Type Beschreibung
uuid string (erforderlich) Eindeutige Kennung für dieses Webszenario.
name string (erforderlich) Name des Webszenarios.
delay string Häufigkeit der Ausführung des Webszenarios (unter Verwendung von Sekunden, Zeitsuffixen oder Benutzermakros).
Standard: 1m.
attempts integer Die Anzahl der Versuche zur Ausführung der Webszenario-Schritte.
Mögliche Werte: 1-10 (Standard: 1).
agent string Client-Agent. Zabbix gibt sich als der ausgewählte Browser aus.
Dies ist nützlich, wenn eine Website für verschiedene Browser unterschiedliche Inhalte zurückgibt.
Standard: Zabbix.
http_proxy string Proxy, der vom Webszenario verwendet wird, angegeben als: http://[username[:password]@]proxy.example.com[:port]
variables Stammelement für Webszenario-Variablen, die in Szenario-Schritten verwendet werden können.
name string (erforderlich) Variablenname.
value text (erforderlich) Variablenwert.
headers Stammelement für HTTP-Header, die beim Ausführen einer Anfrage gesendet werden.
Header sollten mit derselben Syntax aufgeführt werden, wie sie im HTTP-Protokoll erscheinen würden.
name string (erforderlich) Header-Name.
value text (erforderlich) Header-Wert.
status string Status des Webszenarios.
Mögliche Werte:1 ENABLED (0, Standard), DISABLED (1).
authentication string Authentifizierungsmethode.
Mögliche Werte:1 NONE (0, Standard), BASIC (1), NTLM (2), Kerberos (3) oder Digest (4).
http_user string Benutzername für die BASIC-(HTTP)-, NTLM-, Kerberos- oder Digest-Authentifizierung.
http_password string Passwort für die BASIC-(HTTP)-, NTLM-, Kerberos- oder Digest-Authentifizierung.
verify_peer string Das SSL-Zertifikat des Webservers überprüfen.
Mögliche Werte:1 NO (0, Standard), YES (1).
verify_host string Überprüfen, ob das Feld Common Name oder das Feld Subject Alternate Name des Webserver-Zertifikats übereinstimmt.
Mögliche Werte:1 NO (0, Standard), YES (1).
ssl_cert_file string Name der SSL-Zertifikatsdatei, die für die Client-Authentifizierung verwendet wird (muss im PEM-Format vorliegen).
ssl_key_file string Name der SSL-Private-Key-Datei, die für die Client-Authentifizierung verwendet wird (muss im PEM-Format vorliegen).
ssl_key_password string Passwort der SSL-Private-Key-Datei.
steps (erforderlich) Stammelement für Host-Webszenario-Schritte.
tags Stammelement für Webszenario-Tags.
tag string (erforderlich) Tag-Name.
value string Tag-Wert.

Siehe auch: Web scenario object (siehe die entsprechende Property mit übereinstimmendem Namen).

Schritte des Host-Webszenarios
Element Typ Beschreibung
name string (erforderlich) Name des Webszenario-Schritts.
url string (erforderlich) URL für die Überwachung.
query_fields Stammelement für Abfrageparameter (ein Array von HTTP-Feldern, die beim Ausführen einer Anfrage zur URL hinzugefügt werden).
name string (erforderlich) Name des Abfrageparameters.
value string Wert des Abfrageparameters.
posts Stammelement für HTTP-POST-Variablen (eine Zeichenkette (Rohdaten des POST) oder ein Array von HTTP-Feldern (Formularfelddaten)).
name string (erforderlich) Name des POST-Felds.
value string (erforderlich) Wert des POST-Felds.
variables Stammelement der Variablen (Makros) auf Schritt-Ebene, die nach diesem Schritt angewendet werden sollen.
Wenn der Variablenwert das Präfix 'regex:' hat, wird sein Wert aus den von diesem Schritt zurückgegebenen Daten entsprechend dem regulären Ausdrucksmuster nach dem Präfix 'regex:' extrahiert
name string (erforderlich) Name der Variablen.
value text (erforderlich) Wert der Variablen.
headers Stammelement für HTTP-Header, die beim Ausführen einer Anfrage gesendet werden.
name string (erforderlich) Name des Headers.
value text (erforderlich) Wert des Headers.
follow_redirects string HTTP-Weiterleitungen folgen.
Mögliche Werte:1 NO (0), YES (1, Standard).
retrieve_mode string Abrufmodus der HTTP-Antwort.
Mögliche Werte:1 BODY (0, Standard), HEADERS (1), BOTH (2).
timeout string Timeout (unter Verwendung von Sekunden, Zeitsuffix oder Benutzermakro) für die Schrittausführung.
Standard: 15s.
required string Text, der in der Antwort vorhanden sein muss (wird ignoriert, wenn leer).
status_codes string Eine durch Kommas getrennte Liste akzeptierter HTTP-Statuscodes (z. B. 200-201,210-299; wird ignoriert, wenn leer).

Siehe auch: Objekt für Webszenario-Schritte (siehe die entsprechende Property mit übereinstimmendem Namen).

Host-Grafiken

Element Type Beschreibung
uuid string Eindeutige Kennung der Grafik.
name string (erforderlich) Name der Grafik.
width integer Breite der Grafik in Pixeln.
Wird für die Vorschau und für Kreis-/aufgeschnittene Kreisdiagramme verwendet.
Mögliche Werte:1 20-65535 (Standard: 900).
height integer Höhe der Grafik in Pixeln.
Wird für die Vorschau und für Kreis-/aufgeschnittene Kreisdiagramme verwendet.
Mögliche Werte:1 20-65535 (Standard: 900).
yaxismin double Wert des Minimums der Y-Achse.
Unterstützt für den FIXED-Mindestwert der Y-Achse.
Standard: 0.
yaxismax double Wert des Maximums der Y-Achse.
Unterstützt für den FIXED-Mindestwert der X-Achse.
Standard: 0.
show_work_period string Nicht-Arbeitszeiten hervorheben.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 NO (0), YES (1, Standard).
show_triggers string Einfache Auslöserwerte als Linie anzeigen.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 NO (0), YES (1, Standard).
type string Grafiktyp.
Mögliche Werte:1 NORMAL (0, Standard), STACKED (1), PIE (2), EXPLODED (3).
show_legend string Grafiklegende anzeigen.
Mögliche Werte:1 NO (0), YES (1, Standard).
show_3d string 3D-Stil aktivieren.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 NO (0, Standard), YES (1).
percent_left double Perzentillinie für die linke Achse anzeigen.
Unterstützt für NORMAL-Grafiken.
Standard: 0.
percent_right double Perzentillinie für die rechte Achse anzeigen.
Unterstützt für NORMAL-Grafiken.
Standard: 0.
ymin_type_1 string Mindestwert der Y-Achse.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 CALCULATED (0, Standard), FIXED (1), ITEM (2).
ymin_item_1 (erforderlich, wenn ymin_type_1 auf ITEM gesetzt ist) Wurzelelement für die Details einzelner Datenpunkte.
host string (erforderlich) Host des Datenpunkts.
key string (erforderlich) Schlüssel des Datenpunkts.
ymax_type_1 string Maximalwert der Y-Achse.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 CALCULATED (0, Standard), FIXED (1), ITEM (2).
ymax_item_1 (erforderlich, wenn ymax_type_1 auf ITEM gesetzt ist) Wurzelelement für die Details einzelner Datenpunkte.
host string (erforderlich) Host des Datenpunkts.
key string (erforderlich) Schlüssel des Datenpunkts.
graph_items (erforderlich) Wurzelelement für Host-Grafikelemente.

Siehe auch: Graph object (verweisen Sie auf die entsprechende Eigenschaft mit passendem Namen).

Host-Grafikelemente
Element < Type Description
sortorder < integer Zeichenreihenfolge. Der kleinere Wert wird zuerst gezeichnet. Kann verwendet werden, um Linien oder Bereiche hinter (oder vor) einem anderen zu zeichnen.
drawtype < string Zeichenstil des Grafikelements.
Unterstützt für NORMAL-Grafiken.
Mögliche Werte:1 SINGLE_LINE (0, Standard), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5).
color < string Elementfarbe (6 Zeichen, Hex).
yaxisside < string Seite der Grafik, auf der die Y-Skala des Grafikelements gezeichnet wird.
Unterstützt für NORMAL- und STACKED-Grafiken.
Mögliche Werte:1 LEFT (0, Standard), RIGHT (1).
calc_fnc < string Daten, die gezeichnet werden, wenn für einen Datenpunkt mehr als ein Wert vorhanden ist.
Mögliche Werte:1 MIN (1), AVG (2, Standard), MAX (4), ALL (7; Minimum, Durchschnitt und Maximum; unterstützt für einfache Grafiken), LAST (9, unterstützt für Kreis-/aufgesplittete Kreisgrafiken).
type < string Typ des Grafikelements.
Mögliche Werte:1 SIMPLE (0, Standard), GRAPH_SUM (2; der Wert des Datenpunkts stellt den gesamten Kreis dar; unterstützt für Kreis-/aufgesplittete Kreisgrafiken).
item < (erforderlich) Einzelner Datenpunkt.
< host string (erforderlich) Host des Datenpunkts.
^ key string (erforderlich) Schlüssel des Datenpunkts.

Siehe auch: Graph item object (siehe die entsprechende Eigenschaft mit passendem Namen).

Host-Wertzuordnungen

Element Type Description
uuid string (erforderlich) Eindeutiger Bezeichner für diese Wertzuordnung.
name string (erforderlich) Name der Wertzuordnung.
mapping Stammelement für Zuordnungen.
type string Zuordnungsmatch-Typ.
Mögliche Werte:1 EQUAL (0, Standard), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
value string Ursprünglicher Wert.
newvalue string (erforderlich) Wert, dem der ursprüngliche Wert zugeordnet wird.

Siehe auch: Value map object (beziehen Sie sich auf die entsprechende Eigenschaft mit demselben Namen).

Fußnoten

1 API-Ganzzahlwerte in Klammern, zum Beispiel ENABLED (0), werden nur als Referenz angegeben. Weitere Informationen finden Sie auf der verlinkten API-Objektseite im Tabelleneintrag oder am Ende jedes Abschnitts.