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.
| 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 di host | 2 | groupids.0 | ID del gruppo di host. Nota: per configurare più gruppi di host, creare un oggetto campo del widget dashboard per ogni gruppo di host, incrementando il numero nel nome della proprietà. Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Gruppi di host (widget) | 1 | groupids._reference | Invece dell'ID del gruppo di host:ABCDE._hostgroupids - impostare un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per i gruppi di host.Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Host | 3 | hostids.0 | ID dell'host. Nota: per configurare più host, creare un oggetto campo del widget dashboard per ogni host, incrementando il numero nel nome della proprietà. Per più host, il parametro Gruppi di host deve essere non configurato oppure configurato con almeno un gruppo di host a cui appartengono gli host configurati. Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Host (widget/dashboard) | 1 | hostids._reference | Invece dell'ID dell'host:DASHBOARD.hostid - impostare il selettore di host della dashboard come origine dati per gli host;ABCDE._hostid - impostare un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host.Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Tag degli host | ||||
| Tipo di valutazione | 0 | host_tags_evaltype | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Nome del 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 degli host Questo parametro non è supportato quando si configura il widget su una dashboard di 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 degli host Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Valore del 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 degli host Questo parametro non è supportato quando si configura il widget su una dashboard di template. |
|
| Pattern degli item | 1 | items.0 | Nome o pattern dell'item. Nota: per configurare più pattern di item, creare un oggetto campo del widget dashboard per ogni pattern di item, incrementando il numero nel nome della proprietà. |
|
| Tag degli item | ||||
| Tipo di valutazione | 0 | item_tags_evaltype | 0 - (predefinito) And/Or; 2 - Or. |
|
| Nome del tag | 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 configura Tag degli item |
|
| Operatore | 0 | item_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 degli item |
|
| Valore del tag | 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 configura Tag degli item |
|
| Stato | 0 | state | -1 - (predefinito) Tutti; 0 - Normale; 1 - Non supportato. |
|
| Mostra problemi | 0 | show_problems | 0 - Tutti; 1 - (predefinito) Non soppressi; 2 - Nessuno. |
|
| Raggruppa per | ||||
| Attributo | 0 | group_by.0.attribute | 0 - Gruppo di host; 1 - Nome host; 2 - Valore del tag dell'host; 3 - Valore del tag dell'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 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 del tag dell'host" o "Valore del tag dell'item" |
|
| Limite degli item | 0 | show_lines | I valori possibili sono compresi tra 1 e 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
}