Dienst-Objekt

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

Service

Das Service-Objekt hat die folgenden Eigenschaften.

Property Type Description
serviceid ID ID des Service.

Property behavior:
- 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 - am kritischsten, wenn alle untergeordneten Elemente Probleme haben;
2 - am kritischsten unter den untergeordneten Services.

Property behavior:
- erforderlich für Erstellvorgänge
name string Name des Service.

Property behavior:
- erforderlich für Erstellvorgänge
sortorder integer Position des Service, verwendet für die Sortierung.

Mögliche Werte: 0-999.

Property behavior:
- erforderlich für Erstellvorgänge
weight integer Gewichtung des Service.

Mögliche Werte: 0-1000000.

Standard: 0.
propagation_rule integer Regel zur Statusweitergabe.

Mögliche Werte:
0 - (Standard) Service-Status unverändert weitergeben - ohne Änderungen;
1 - den weitergegebenen Status um einen angegebenen propagation_value erhöhen (um 1 bis 5 Schweregrade);
2 - den weitergegebenen Status um einen 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 einem angegebenen propagation_value setzen.

Property behavior:
- erforderlich, wenn propagation_value gesetzt ist
propagation_value integer Wert der 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.

Property behavior:
- erforderlich, wenn propagation_rule gesetzt ist
status integer Ob sich der Service im OK- oder Problemzustand befindet.

Wenn sich der Service in einem Problemzustand befindet, entspricht status entweder der Schwere des kritischsten Problems oder dem höchsten Status eines untergeordneten Service in einem Problemzustand.

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

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

Mögliche Werte:
0 - Lese- und Schreibzugriff;
1 - Nur Lesezugriff.

Property behavior:
- 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 repräsentieren eine Zustandsänderung eines Services. Sie haben die folgenden Eigenschaften.

Property Type Description
clock timestamp Zeitpunkt, zu dem die Zustandsänderung des Services stattgefunden hat.
value integer Status des Services.

Siehe die Eigenschaft status des Services für eine Liste möglicher Werte.

Problem-Tag

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

Property Type Description
tag string Name des Problem-Tags.

Property behavior:
- required
operator integer Zuordnungsbedingung operator.

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