Oggetto servizio

I seguenti oggetti sono direttamente correlati all'API service.

Service

L'oggetto service ha le seguenti proprietà.

Property Type Description
serviceid ID ID del service.

Property behavior:
- read-only
- required per le operazioni di aggiornamento
algorithm integer Regola di calcolo dello stato. Applicabile solo se esistono service figlio.

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

Property behavior:
- required per le operazioni di creazione
name string Nome del service.

Property behavior:
- required per le operazioni di creazione
sortorder integer Posizione del service usata per l'ordinamento.

Valori possibili: 0-999.

Property behavior:
- required per le operazioni di creazione
weight integer Peso del service.

Valori possibili: 0-1000000.

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

Valori possibili:
0 - (predefinito) propaga lo stato del service così com'è, senza alcuna modifica;
1 - aumenta lo stato propagato di un dato propagation_value (di 1-5 severità);
2 - diminuisce lo stato propagato di un dato propagation_value (di 1-5 severità);
3 - ignora questo service - lo stato non viene propagato al service padre;
4 - imposta uno stato fisso del service usando un dato propagation_value.

Property behavior:
- required 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.

Property behavior:
- required se propagation_rule è impostato
status integer Indica se il service si trova nello stato OK o di problema.

Se il service si trova in uno stato di problema, status è uguale alla gravità del problema più critico oppure allo stato più alto di un service figlio in stato di problema.

Se il service si trova nello stato OK, status è uguale a: -1.

Property behavior:
- read-only
description string Descrizione del service.
uuid string Identificatore univoco universale, usato per collegare i service importati a quelli già esistenti. Generato automaticamente, se non specificato.
created_at integer Timestamp Unix in cui il service è stato creato.
readonly integer Accesso al service.

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

Property behavior:
- read-only

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 del servizio

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

Gli oggetti allarme del servizio rappresentano una modifica dello stato di un servizio. Ha le seguenti proprietà.

Property Type Description
clock timestamp Ora in cui si è verificata la modifica dello 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à.

Property Type Description
tag string Nome del tag del problema.

Property behavior:
- required
operator integer Operatore della condizione di mapping.

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