23 Problemi

Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Problems nei metodi dashboard.create e dashboard.update.

Le proprietà fields del widget non vengono validate durante la creazione o l'aggiornamento di una dashboard. Ciò consente agli utenti di modificare i widget integrati e creare widget personalizzati, ma introduce anche il rischio di creare o aggiornare i widget in modo errato. Per garantire la corretta creazione o il corretto aggiornamento del widget Problems, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.

Parametri

I seguenti parametri sono supportati per il widget Problems.

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.
Mostra 0 show 1 - (predefinito) Problemi recenti;
2 - Cronologia;
3 - Problemi.
Gruppi di host 2 groupids.0 ID del gruppo di host.

Nota: Per configurare più gruppi di host, creare un oggetto campo widget dashboard per ciascun gruppo di host con un numero incrementale nel nome della proprietà.

Questo parametro non è supportato se si configura il widget in una dashboard template.
Gruppi di host (Widget) 1 groupids._reference Invece dell'ID del gruppo di host:
ABCDE._hostgroupids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per i gruppi di host.

Questo parametro non è supportato se si configura il widget in una dashboard template.
Escludi gruppi di host 2 exclude_groupids.0 ID del gruppo di host.

Nota: Per escludere più gruppi di host, creare un oggetto campo widget dashboard per ciascun gruppo di host con un numero incrementale nel nome della proprietà.

Questo parametro non è supportato se si configura il widget in una dashboard template.
Host 3 hostids.0 ID dell'host.

Nota: Per configurare più host, creare un oggetto campo widget dashboard per ciascun host con un numero incrementale nel nome della proprietà. Per più host, il parametro Gruppi di host non deve essere configurato affatto oppure deve essere configurato con almeno un gruppo di host a cui appartengono gli host configurati.

Questo parametro non è supportato se si configura il widget in una dashboard template.
Host (Widget/Dashboard) 1 hostids._reference Invece dell'ID dell'host:
DASHBOARD.hostids - imposta il selettore host della dashboard come origine dati per gli host;
ABCDE._hostids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host.

Questo parametro non è supportato se si configura il widget in una dashboard template.
Problema 1 problem Nome evento del problema (senza distinzione tra maiuscole e minuscole, nome completo o parte di esso).
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à.
Tag del problema
Tipo di valutazione 0 evaltype 0 - (predefinito) And/Or;
2 - Or.
Nome tag 1 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:
- required se si configurano i Tag del problema
Operatore 0 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:
- required se si configurano i Tag del problema
Valore tag 1 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:
- required se si configurano i Tag del problema
Mostra tag 0 show_tags 0 - (predefinito) Nessuno;
1 - 1;
2 - 2;
3 - 3.
Nome tag (formato) 0 tag_name_format 0 - (predefinito) Completo;
1 - Abbreviato;
2 - Nessuno.

Comportamento del parametro:
- supported se Mostra tag è impostato su "1", "2" o "3"
Priorità di visualizzazione dei tag 1 tag_priority Elenco di tag separati da virgole.

Comportamento del parametro:
- supported se Mostra tag è impostato su "1", "2" o "3"
Mostra dati operativi 0 show_opdata 0 - (predefinito) Nessuno;
1 - Separatamente;
2 - Con il nome del problema.
Mostra problemi soppressi 0 show_suppressed 0 - (predefinito) Disabilitato;
1 - Abilitato.
Stato del riconoscimento 0 acknowledgement_status 0 - (predefinito) tutti;
1 - Non riconosciuti;
2 - Riconosciuti.
Da me 0 acknowledged_by_me 0 - (predefinito) Disabilitato;
1 - Abilitato.
Ordina voci per 0 sort_triggers 1 - Gravità (decrescente);
2 - Host (crescente);
3 - Ora (crescente);
4 - (predefinito) Ora (decrescente);
13 - Gravità (crescente);
14 - Host (decrescente);
15 - Problema (crescente);
16 - Problema (decrescente).

Per tutti i valori, eccetto "Ora (decrescente)" e "Ora (crescente)", il parametro Mostra timeline deve essere impostato su "Disabilitato".

I valori "Host (crescente)" e "Host (decrescente)" non sono supportati se si configura il widget in una dashboard template.
Mostra timeline 0 show_timeline 0 - Disabilitato;
1 - (predefinito) Abilitato.

Comportamento del parametro:
- supported se Ordina voci per è impostato su "Ora (decrescente)" o "Ora (crescente)"
Evidenzia l'intera riga 0 highlight_row 0 - (predefinito) Disabilitato;
1 - Abilitato.

Questo parametro non è supportato nei temi ad alto contrasto.
Mostra righe 0 show_lines I valori possibili vanno da 1 a 100.

Predefinito: 25.
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:
- required

Esempi

Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Problems. Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.

Configurazione di un widget Problems

Configurare un widget Problems che visualizzi i problemi per il gruppo host "4" che soddisfano le seguenti condizioni:

  • Problemi che hanno un tag con nome "scope" che contiene i valori "performance" o "availability", oppure "capacity".
  • Problemi che hanno le seguenti severità: "Warning", "Average", "High", "Disaster".

Inoltre, configurare il widget in modo che mostri i tag e i dati operativi.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "name": "Problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "performance"
                            },
                            {
                                "type": 1,
                                "name": "tags.1.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.1.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.1.value",
                                "value": "availability"
                            },
                            {
                                "type": 1,
                                "name": "tags.2.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.2.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.2.value",
                                "value": "capacity"
                            },
                            {
                                "type": 0,
                                "name": "severities.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "severities.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "severities.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "severities.3",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "show_tags",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show_opdata",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Vedi anche