On this page
17 Navigatore item
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget Navigatore di elementi 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 di elementi, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Item navigator.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Host groups | 2 | groupids.0 | ID del Host group. Nota: per configurare più host group, crea un oggetto campo del widget della dashboard per ogni host group con un numero incrementato nel nome della proprietà. Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Host groups (Widget) | 1 | groupids._reference | Invece dell'ID del Host group:ABCDE._hostgroupids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host group.Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Hosts | 3 | hostids.0 | ID dell'Host. Nota: per configurare più host, crea un oggetto campo del widget della dashboard per ogni host con un numero incrementato nel nome della proprietà. Per più host, il parametro Host groups deve essere configurato con almeno un host group a cui appartengano gli host configurati, oppure non deve essere configurato affatto. Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Invece dell'ID dell'Host:DASHBOARD.hostid - imposta il selettore Host come origine dati per gli host;ABCDE._hostid - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host.Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Host tags | ||||
| Evaluation type | 0 | host_tags_evaltype | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Tag name | 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 configurano Host tags Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Operator | 0 | host_tags.0.operator | 0 - Contiene; 1 - Uguale a; 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 configurano Host tags Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Tag value | 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 configurano Host tags Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Item patterns | 1 | items.0 | Nome o pattern dell'Item. Nota: per configurare più pattern di item, crea un oggetto campo del widget della dashboard per ogni pattern di item con un numero incrementato nel nome della proprietà. |
|
| Item tags | ||||
| Evaluation type | 0 | item_tags_evaltype | 0 - (predefinito) And/Or; 2 - Or. |
|
| Tag name | 1 | item_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 configurano Item tags |
|
| Operator | 0 | item_tags.0.operator | 0 - Contiene; 1 - Uguale a; 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 configurano Item tags |
|
| Tag value | 1 | item_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 configurano Item tags |
|
| State | 0 | state | -1 - (predefinito) Tutti; 0 - Normale; 1 - Non supportato. |
|
| Show problems | 0 | show_problems | 0 - Tutti; 1 - (predefinito) Non soppressi; 2 - Nessuno. |
|
| Group by | ||||
| Attribute | 0 | group_by.0.attribute | 0 - Host group; 1 - Nome host; 2 - Valore del tag host; 3 - Valore del tag item. Nota: il numero nel nome della proprietà fa riferimento all'ordine dell'attributo nell'elenco degli attributi di raggruppamento. Comportamento del parametro: - obbligatorio se si configura Group by |
|
| Value | 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 Attribute. Comportamento del parametro: - obbligatorio se si configura Group by e Attribute è impostato su "Host tag value" o "Item tag value" |
|
| Item limit | 0 | show_lines | I valori possibili vanno da 1 a 9999. Predefinito: 100. |
|
| 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 Item navigator.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Navigatore item
Configurare un widget Navigatore item che visualizzi fino a 1000 item raggruppati per host e poi per il valore del tag item "component".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "itemnavigator",
"name": "Item navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 3
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "component"
},
{
"type": 0,
"name": "show_lines",
"value": 1000
},
{
"type": 1,
"name": "reference",
"value": "DFNLK"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}