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 Problemi.

Parametro tipo nome valore
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 del widget dashboard per ogni gruppo di host, incrementando il numero nel nome della proprietà.

Questo parametro non è supportato se si configura il widget in 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 se si configura il widget in una dashboard di 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 del widget dashboard per ogni gruppo di host, incrementando il numero nel nome della proprietà.

Questo parametro non è supportato se si configura il widget in 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 completamente non configurato oppure 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 di template.
Host (widget/dashboard) 1 hostids._reference Invece dell'ID dell'host:
DASHBOARD.hostids - impostare il selettore di host della dashboard come origine dati per gli host;
ABCDE._hostids - impostare 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 di template.
Problema 1 problem Nome dell'evento Problema event name (senza distinzione tra maiuscole e minuscole, nome completo o parte del nome).
Gravità 0 severities.0 0 - Non classificato;
1 - Informazioni;
2 - Avviso;
3 - Media;
4 - Alta;
5 - Disastro.

Predefinito: vuoto (tutti abilitati).

Nota: per configurare più valori, creare un oggetto campo del widget dashboard per ogni valore, incrementando il numero nel nome della proprietà.
Tag dei problemi
Tipo di valutazione 0 evaltype 0 - (predefinito) And/Or;
2 - Or.
Nome del 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:
- obbligatorio se si configura Tag dei problemi
Operatore 0 tags.0.operator 0 - Contiene;
1 - Uguale;
2 - Non contiene;
3 - Non uguale;
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 dei problemi
Valore del 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:
- obbligatorio se si configura Tag dei problemi
Mostra tag 0 show_tags 0 - (predefinito) Nessuno;
1 - 1;
2 - 2;
3 - 3.
Nome del tag (formato) 0 tag_name_format 0 - (predefinito) Completo;
1 - Abbreviato;
2 - Nessuno.

Comportamento del parametro:
- supportato 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:
- supportato 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 di 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, ad eccezione di "Ora (decrescente)" e "Ora (crescente)", il parametro Mostra sequenza temporale deve essere impostato su "Disabilitato".

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

Comportamento del parametro:
- supportato se Ordina voci per è impostato su "Ora (decrescente)" o "Ora (crescente)"
Evidenzia 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 sono compresi tra 1 e 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:
- obbligatorio

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