Oggetto Task

I seguenti oggetti sono direttamente correlati all'API task.

Task

L'oggetto task ha le seguenti proprietà:

Property Type Description
taskid ID ID del task.

Property behavior:
- read-only
type integer Tipo del task.

Valori possibili:
1 - Informazioni diagnostiche;
2 - Aggiorna configurazione del proxy;
6 - Esegui ora.

A partire da Zabbix 7.4.3, gli utenti di tipo Admin e User possono creare task "Esegui ora".

Nota che task.get restituisce sempre "7" (Riepilogo esecuzione task).

Property behavior:
- required
status integer Stato del task.

Valori possibili:
1 - nuovo task;
2 - task in corso;
3 - task completato;
4 - task scaduto.

Property behavior:
- read-only
clock timestamp Ora in cui il task è stato creato.

Property behavior:
- read-only
ttl integer Tempo in secondi dopo il quale il task scade.

Property behavior:
- read-only
proxyid ID ID del proxy per il quale vengono raccolte le statistiche delle informazioni diagnostiche.

Property behavior:
- supported se type è impostato su "Informazioni diagnostiche" o "Aggiorna configurazione del proxy"
request object Oggetto richiesta del task in base al tipo di task:
L'oggetto del task "Esegui ora" è descritto in dettaglio di seguito;
L'oggetto del task "Aggiorna configurazione del proxy" è descritto in dettaglio di seguito;
L'oggetto del task "Informazioni diagnostiche" è descritto in dettaglio di seguito.

Property behavior:
- required
result object Oggetto risultato del task di informazioni diagnostiche.
Può contenere NULL se il risultato non è ancora pronto.
L'oggetto risultato è descritto in dettaglio di seguito.

Property behavior:
- read-only

Oggetto richiesta 'Execute now'

L'oggetto richiesta del task 'Execute now' ha le seguenti proprietà.

Property Type Description
itemid ID ID di item e delle regole di discovery a basso livello.

A partire da Zabbix 7.4.3, gli utenti di tipo Admin e User possono eseguire 'Execute now' sugli item degli host per i quali dispongono dell'autorizzazione read-write, oppure dell'autorizzazione read e dell'azione invoke_execute_now abilitata per il proprio ruolo. Lo stesso vale per gli utenti di tipo Admin per le regole di discovery a basso livello (LLD).

Oggetto richiesta 'Refresh proxy configuration'

L'oggetto richiesta del task 'Refresh proxy configuration' ha le seguenti proprietà.

Proprietà Type Descrizione
proxyids array ID dei proxy.

Oggetto richiesta 'Informazioni diagnostiche'

L'oggetto richiesta dell'attività di informazioni diagnostiche ha le seguenti proprietà. L'oggetto richiesta delle statistiche per tutti i tipi di proprietà è descritto in dettaglio di seguito.

Proprietà Tipo Descrizione
historycache object Richiesta di statistiche della cache della cronologia. Disponibile su server e proxy.
valuecache object Richiesta di statistiche della cache degli item. Disponibile sul server.
preprocessing object Richiesta di statistiche del gestore di preprocessing. Disponibile su server e proxy.
alerting object Richiesta di statistiche del gestore degli avvisi. Disponibile sul server.
lld object Richiesta di statistiche del gestore LLD. Disponibile sul server.
Oggetto di richiesta delle statistiche

L'oggetto di richiesta delle statistiche viene utilizzato per definire quale tipo di informazioni deve essere raccolto sui processi interni di server/proxy. Ha le seguenti proprietà.

Property Type Description
stats query Proprietà dell'oggetto statistico da restituire.
L'elenco dei campi disponibili per ciascun tipo di statistica delle informazioni diagnostiche è descritto in dettaglio di seguito.

Predefinito: extend restituirà tutti i campi statistici disponibili.
top object Oggetto per ordinare e limitare i valori statistici restituiti.
L'elenco dei campi disponibili per ciascun tipo di statistica delle informazioni diagnostiche è descritto in dettaglio di seguito.

Esempio: { “source.alerts”: 10 }
Elenco dei campi statistici disponibili per ciascun tipo di richiesta di informazioni diagnostiche

I seguenti campi statistici possono essere richiesti per ciascun tipo di proprietà della richiesta di informazioni diagnostiche.

Tipo diagnostico Campi disponibili Descrizione
historycache items Numero di item nella cache.
values Numero di valori nella cache.
memory Statistiche della memoria condivisa (spazio libero, numero di blocchi utilizzati, numero di blocchi liberi, dimensione massima del blocco libero).
memory.data Statistiche della memoria condivisa della cache dei dati storici.
memory.index Statistiche della memoria condivisa della cache dell'indice storico.
valuecache items Numero di item nella cache.
values Numero di valori nella cache.
memory Statistiche della memoria condivisa (spazio libero, numero di blocchi utilizzati, numero di blocchi liberi, dimensione massima del blocco libero).
mode Modalità della cache dei valori.
preprocessing values Numero di valori in coda.
preproc.values Numero di valori in coda con passaggi di preprocessing.
alerting alerts Numero di avvisi in coda.
lld rules Numero di regole in coda.
values Numero di valori in coda.
Elenco dei campi di ordinamento disponibili per ciascun tipo di richiesta di informazioni diagnostiche

I seguenti campi statistici possono essere utilizzati per ordinare e limitare le informazioni richieste.

Tipo diagnostico Campi disponibili Tipo
historycache values integer
valuecache values integer
request.values integer
preprocessing values integer
alerting media.alerts integer
source.alerts integer
lld values integer
Oggetto risultato statistico

L'oggetto risultato statistico viene recuperato nel campo result dell'oggetto task.

Proprietà Tipo Descrizione
status integer Stato del risultato del task.

Valori possibili:
-1 - si è verificato un errore durante l'esecuzione del task;
0 - il risultato del task è stato creato.

Comportamento della proprietà:
- sola lettura
data string/object Risultati in base all'oggetto richiesta statistica del particolare task di informazioni diagnostiche.
Contiene una stringa con il messaggio di errore se si è verificato un errore durante l'esecuzione del task.