Oggetto servizio

I seguenti oggetti sono direttamente correlati all'API service.

Servizio

L'oggetto servizio ha le seguenti proprietà.

Proprietà Tipo Descrizione
serviceid ID ID del servizio.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
algorithm integer Regola di calcolo dello stato. Applicabile solo se esistono servizi figli.

Valori possibili:
0 - imposta lo stato su OK;
1 - il più critico se tutti i figli hanno problemi;
2 - il più critico tra i servizi figli.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
name string Nome del servizio.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
sortorder integer Posizione del servizio utilizzata per l'ordinamento.

Valori possibili: 0-999.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
weight integer Peso del servizio.

Valori possibili: 0-1000000.

Predefinito: 0.
propagation_rule integer Regola di propagazione dello stato.

Valori possibili:
0 - (predefinito) propaga lo stato del servizio così com'è, senza alcuna modifica;
1 - aumenta lo stato propagato di un determinato propagation_value (da 1 a 5 livelli di gravità);
2 - diminuisce lo stato propagato di un determinato propagation_value (da 1 a 5 livelli di gravità);
3 - ignora questo servizio - lo stato non viene propagato al servizio padre in alcun modo;
4 - imposta uno stato fisso del servizio usando un determinato propagation_value.

Comportamento della proprietà:
- obbligatoria se propagation_value è impostato
propagation_value integer Valore di propagazione dello stato.

Valori possibili se propagation_rule è impostato su "0" o "3":
0 - Non classificato.

Valori possibili se propagation_rule è impostato su "1" o "2":
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.

Valori possibili se propagation_rule è impostato su "4":
-1 - OK;
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.

Comportamento della proprietà:
- obbligatoria se propagation_rule è impostato
status integer Indica se il servizio è nello stato OK o in stato di problema.

Se il servizio è in stato di problema, status è uguale a uno dei seguenti valori:
- la gravità del problema più critico;
- lo stato più alto di un servizio figlio in stato di problema.

Se il servizio è nello stato OK, status è uguale a: -1.

Comportamento della proprietà:
- sola lettura
description string Descrizione del servizio.
uuid string Identificatore univoco universale, utilizzato per collegare i servizi importati a quelli già esistenti. Generato automaticamente, se non fornito.
created_at integer Timestamp Unix della creazione del servizio.
readonly integer Accesso al servizio.

Valori possibili:
0 - Lettura-scrittura;
1 - Sola lettura.

Comportamento della proprietà:
- sola lettura

Regola di stato

L'oggetto regola di stato ha le seguenti proprietà.

Proprietà Type Descrizione
type integer Condizione per impostare lo stato (Nuovo stato).

Valori possibili:
0 - se almeno (N) servizi figli hanno lo stato (Stato) o superiore;
1 - se almeno il (N%) dei servizi figli ha lo stato (Stato) o superiore;
2 - se meno di (N) servizi figli hanno lo stato (Stato) o inferiore;
3 - se meno del (N%) dei servizi figli ha lo stato (Stato) o inferiore;
4 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (W);
5 - se il peso dei servizi figli con stato (Stato) o superiore è almeno (N%);
6 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (W);
7 - se il peso dei servizi figli con stato (Stato) o inferiore è inferiore a (N%).

Dove:
- N (W) è limit_value;
- (Stato) è limit_status;
- (Nuovo stato) è new_status.

Comportamento della proprietà:
- required
limit_value integer Valore limite.

Valori possibili:
- per N e W: 1-100000;
- per N%: 1-100.

Comportamento della proprietà:
- required
limit_status integer Stato limite.

Valori possibili:
-1 - OK;
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.

Comportamento della proprietà:
- required
new_status integer Valore del nuovo stato.

Valori possibili:
0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.

Comportamento della proprietà:
- required

Tag del servizio

L'oggetto tag del servizio ha le seguenti proprietà.

Proprietà Type Descrizione
tag string Nome del tag del servizio.

Comportamento della proprietà:
- obbligatorio
value string Valore del tag del servizio.

Allarme di servizio

Gli allarmi di servizio non possono essere creati, aggiornati o eliminati direttamente tramite la API di Zabbix.

Gli oggetti allarme di servizio rappresentano un cambiamento di stato di un servizio. Hanno le seguenti proprietà.

Proprietà Tipo Descrizione
clock timestamp Ora in cui si è verificato il cambiamento di stato del servizio.
value integer Stato del servizio.

Fare riferimento alla proprietà status del servizio per un elenco dei valori possibili.

Tag del problema

I tag del problema consentono di collegare i servizi con gli eventi di problema. L'oggetto tag del problema ha le seguenti proprietà.

Proprietà Type Descrizione
tag string Nome del tag del problema.

Comportamento della proprietà:
- obbligatorio
operator integer Operatore della condizione di mappatura.

Valori possibili:
0 - (predefinito) Uguale;
2 - Contiene.
value string Valore del tag del problema.