Dienst-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der service API.

Service

Das Service-Objekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
serviceid ID ID des Service.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
algorithm integer Regel zur Statusberechnung. Nur anwendbar, wenn untergeordnete Services vorhanden sind.

Mögliche Werte:
0 - Status auf OK setzen;
1 - kritischster Status, wenn alle untergeordneten Services Probleme haben;
2 - kritischster Status der untergeordneten Services.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
name string Name des Service.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
sortorder integer Position des Service, die für die Sortierung verwendet wird.

Mögliche Werte: 0-999.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
weight integer Gewichtung des Service.

Mögliche Werte: 0-1000000.

Standard: 0.
propagation_rule integer Regel für die Statusweitergabe.

Mögliche Werte:
0 - (Standard) Service-Status unverändert weitergeben - ohne Änderungen;
1 - den weitergegebenen Status um den angegebenen propagation_value erhöhen (um 1 bis 5 Schweregrade);
2 - den weitergegebenen Status um den angegebenen propagation_value verringern (um 1 bis 5 Schweregrade);
3 - diesen Service ignorieren - der Status wird überhaupt nicht an den übergeordneten Service weitergegeben;
4 - festen Service-Status mit dem angegebenen propagation_value setzen.

Verhalten der Eigenschaft:
- erforderlich, wenn propagation_value gesetzt ist
propagation_value integer Wert für die Statusweitergabe.

Mögliche Werte, wenn propagation_rule auf "0" oder "3" gesetzt ist:
0 - Nicht klassifiziert.

Mögliche Werte, wenn propagation_rule auf "1" oder "2" gesetzt ist:
1 - Information;
2 - Warnung;
3 - Durchschnittlich;
4 - Hoch;
5 - Katastrophe.

Mögliche Werte, wenn propagation_rule auf "4" gesetzt ist:
-1 - OK;
0 - Nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - Durchschnittlich;
4 - Hoch;
5 - Katastrophe.

Verhalten der Eigenschaft:
- erforderlich, wenn propagation_rule gesetzt ist
status integer Gibt an, ob sich der Service im Zustand OK oder Problem befindet.

Wenn sich der Service im Problemzustand befindet, ist status gleich:
- dem Schweregrad des kritischsten Problems;
- dem höchsten Status eines untergeordneten Service im Problemzustand.

Wenn sich der Service im Zustand OK befindet, ist status gleich: -1.

Verhalten der Eigenschaft:
- schreibgeschützt
description string Beschreibung des Service.
uuid string Universell eindeutige Kennung, die verwendet wird, um importierte Services mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn sie nicht angegeben wird.
created_at integer Unix-Zeitstempel, wann der Service erstellt wurde.
readonly integer Zugriff auf den Service.

Mögliche Werte:
0 - Lesen und Schreiben;
1 - Schreibgeschützt.

Verhalten der Eigenschaft:
- schreibgeschützt

Statusregel

Das Statusregel-Objekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
type integer Bedingung zum Setzen des Status (Neuer Status).

Mögliche Werte:
0 - wenn mindestens (N) untergeordnete Services den Status (Status) oder höher haben;
1 - wenn mindestens (N%) der untergeordneten Services den Status (Status) oder höher haben;
2 - wenn weniger als (N) untergeordnete Services den Status (Status) oder niedriger haben;
3 - wenn weniger als (N%) der untergeordneten Services den Status (Status) oder niedriger haben;
4 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder höher mindestens (W) beträgt;
5 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder höher mindestens (N%) beträgt;
6 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder niedriger kleiner als (W) ist;
7 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder niedriger kleiner als (N%) ist.

Wobei:
- N (W) ist limit_value;
- (Status) ist limit_status;
- (Neuer Status) ist new_status.

Verhalten der Eigenschaft:
- erforderlich
limit_value integer Grenzwert.

Mögliche Werte:
- für N und W: 1-100000;
- für N%: 1-100.

Verhalten der Eigenschaft:
- erforderlich
limit_status integer Grenzstatus.

Mögliche Werte:
-1 - OK;
0 - Nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - Durchschnittlich;
4 - Hoch;
5 - Katastrophe.

Verhalten der Eigenschaft:
- erforderlich
new_status integer Neuer Statuswert.

Mögliche Werte:
0 - Nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - Durchschnittlich;
4 - Hoch;
5 - Katastrophe.

Verhalten der Eigenschaft:
- erforderlich

Service-Tag

Das Service-Tag-Objekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
tag string Name des Service-Tags.

Verhalten der Eigenschaft:
- erforderlich
value string Wert des Service-Tags.

Service-Alarm

Service-Alarme können nicht direkt über die Zabbix API erstellt, aktualisiert oder gelöscht werden.

Die Service-Alarm-Objekte stellen eine Zustandsänderung eines Service dar. Sie verfügen über die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
clock timestamp Zeitpunkt, zu dem die Zustandsänderung des Service eingetreten ist.
value integer Status des Service.

Eine Liste der möglichen Werte finden Sie in der status-Eigenschaft des Service.

Problem-Tag

Problem-Tags ermöglichen die Verknüpfung von Services mit Problemereignissen. Das Problem-Tag-Objekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
tag string Name des Problem-Tags.

Verhalten der Eigenschaft:
- erforderlich
operator integer Zuordnungsbedingung operator.

Mögliche Werte:
0 - (Standard) Gleich;
2 - Enthält.
value string Wert des Problem-Tags.