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:
- read-only
- required für Update-Operationen
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:
- required für Create-Operationen
name string Name des Service.

Property behavior:
- required für Create-Operationen
sortorder integer Position des Service, die für die Sortierung verwendet wird.

Mögliche Werte: 0-999.

Property behavior:
- required für Create-Operationen
weight integer Gewichtung des Service.

Mögliche Werte: 0-1000000.

Standard: 0.
propagation_rule integer Regel zur Statusweitergabe.

Mögliche Werte:
0 - (Standard) den 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 - einen festen Service-Status mit einem angegebenen propagation_value setzen.

Property behavior:
- required 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 - Durchschnitt;
4 - Hoch;
5 - Desaster.

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

Property behavior:
- required wenn propagation_rule gesetzt ist
status integer Gibt an, ob sich der Service im OK- oder Problemzustand befindet.

Wenn sich der Service in einem Problemzustand befindet, entspricht status entweder dem Schweregrad 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:
- read-only
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, zu dem der Service erstellt wurde.
readonly integer Zugriff auf den Service.

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

Property behavior:
- read-only

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 Objekte für Service-Alarme repräsentieren eine Zustandsänderung eines Service. Sie haben die folgenden Eigenschaften.

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

Siehe die Eigenschaft status des Service 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.