14 Navigatore degli host
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget Navigatore degli host nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard.
Questo consente agli utenti di modificare i widget built-in e creare widget personalizzati, ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget Navigatore degli host, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Host navigator.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Intervallo di aggiornamento | 0 | rf_rate | 0 - Nessun aggiornamento; 10 - 10 secondi; 30 - 30 secondi; 60 - (predefinito) 1 minuto; 120 - 2 minuti; 600 - 10 minuti; 900 - 15 minuti. |
|
| Gruppi host | 2 | groupids.0 | ID del gruppo host. Nota: Per configurare più gruppi host, creare un oggetto campo widget dashboard per ciascun gruppo host con un numero incrementale nel nome della proprietà. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Gruppi host (Widget) | 1 | groupids._reference | Invece dell'ID del gruppo host:ABCDE._hostgroupids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per i gruppi host.Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Pattern host | 1 | hosts.0 | Nome o pattern dell'host. Nota: Per configurare più pattern host, creare un oggetto campo widget dashboard per ciascun pattern host con un numero incrementale nel nome della proprietà. Per più pattern host, il parametro Gruppi host non deve essere configurato affatto oppure deve essere configurato con almeno un gruppo host a cui appartengono gli host che corrispondono ai pattern host configurati. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Stato host | 0 | status | -1 - (predefinito) Qualsiasi; 0 - Abilitato; 1 - Disabilitato. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Tag host | ||||
| Tipo di valutazione | 0 | host_tags_evaltype | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Nome tag | 1 | host_tags.0.tag | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Operatore | 0 | host_tags.0.operator | 0 - Contiene; 1 - Uguale; 2 - Non contiene; 3 - Diverso da; 4 - Esiste; 5 - Non esiste. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Valore tag | 1 | host_tags.0.value | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag. Comportamento del parametro: - obbligatorio se si configura Tag host Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Gravità | 0 | severities.0 | 0 - Non classificato; 1 - Informazione; 2 - Avviso; 3 - Media; 4 - Alta; 5 - Disastro. Predefinito: vuoto (tutti abilitati). Nota: Per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementale nel nome della proprietà. |
|
| Mostra host in manutenzione | 0 | maintenance | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Mostra problemi | 0 | show_problems | 0 - Tutti; 1 - (predefinito) Non soppressi; 2 - Nessuno. |
|
| Raggruppa per | ||||
| Attributo | 0 | group_by.0.attribute | 0 - Gruppo host; 1 - Valore tag; 2 - Gravità. Nota: Il numero nel nome della proprietà fa riferimento all'ordine degli attributi nell'elenco degli attributi di raggruppamento. Comportamento del parametro: - obbligatorio se si configura Raggruppa per |
|
| Valore | 1 | group_by.0.tag_name | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà fa riferimento all'attributo di raggruppamento impostato nel parametro Attributo. Comportamento del parametro: - obbligatorio se si configura Raggruppa per e Attributo è impostato su "Valore tag" |
|
| Limite host | 0 | show_lines | I valori possibili vanno da 1 a 9999. Predefinito: 100. Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
| Reference | 1 | reference | Qualsiasi valore stringa composto da 5 caratteri (ad esempio, ABCDE o JBPNL). Questo valore deve essere univoco all'interno della dashboard a cui appartiene il widget.Comportamento del parametro: - obbligatorio |
|
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Host navigator.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Navigatore host
Configurare un widget Navigatore host che visualizza gli host raggruppati per gruppo host e, successivamente, per il valore del tag "city".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "hostnavigator",
"name": "Host navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 2
},
{
"type": 2,
"name": "groupids.1",
"value": 4
},
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 1
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "city"
},
{
"type": 1,
"name": "reference",
"value": "SWKLB"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}