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.

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.
Show 0 show 1 - (predefinito) Problemi recenti;
2 - Cronologia;
3 - Problemi.
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.
Exclude host groups 2 exclude_groupids.0 ID del Host group.

Nota: per escludere 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.
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 non configurato oppure configurato con almeno un host group a cui appartengono gli host configurati.

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.hostids - imposta il selettore Host 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 il widget viene configurato su una template dashboard.
Problem 1 problem Nome dell'evento del problema (senza distinzione tra maiuscole e minuscole, nome completo o parte di esso).
Severity 0 severities.0 0 - Non classificato;
1 - Informazione;
2 - Warning;
3 - Medio;
4 - Alto;
5 - Disastro.

Predefinito: vuoto (tutti abilitati).

Nota: per configurare più valori, crea un oggetto campo del widget della dashboard per ogni valore con un numero incrementato nel nome della proprietà.
Problem tags
Evaluation type 0 evaltype 0 - (predefinito) And/Or;
2 - Or.
Tag name 1 tags.0.tag Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Problem tags
Operator 0 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 dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Problem tags
Tag value 1 tags.0.value Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Problem tags
Show tags 0 show_tags 0 - (predefinito) Nessuno;
1 - 1;
2 - 2;
3 - 3.
Tag name (format) 0 tag_name_format 0 - (predefinito) Completo;
1 - Abbreviato;
2 - Nessuno.

Comportamento del parametro:
- supportato se Show tags è impostato su "1", "2" o "3"
Tag display priority 1 tag_priority Elenco di tag separati da virgole.

Comportamento del parametro:
- supportato se Show tags è impostato su "1", "2" o "3"
Show operational data 0 show_opdata 0 - (predefinito) Nessuno;
1 - Separatamente;
2 - Con il nome del problema.
Show suppressed problems 0 show_suppressed 0 - (predefinito) Disabilitato;
1 - Abilitato.
Acknowledgement status 0 acknowledgement_status 0 - (predefinito) tutti;
1 - Non riconosciuti;
2 - Riconosciuti.
By me 0 acknowledged_by_me 0 - (predefinito) Disabilitato;
1 - Abilitato.
Sort entries by 0 sort_triggers 1 - Severità (decrescente);
2 - Host (crescente);
3 - Ora (crescente);
4 - (predefinito) Ora (decrescente);
13 - Severità (crescente);
14 - Host (decrescente);
15 - Problema (crescente);
16 - Problema (decrescente).

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

I valori "Host (crescente)" e "Host (decrescente)" non sono supportati se il widget viene configurato su una template dashboard.
Show timeline 0 show_timeline 0 - Disabilitato;
1 - (predefinito) Abilitato.

Comportamento del parametro:
- supportato se Sort entries by è impostato su "Ora (decrescente)" o "Ora (crescente)"
Highlight whole row 0 highlight_row 0 - (predefinito) Disabilitato;
1 - Abilitato.

Questo parametro non è supportato nei temi ad alto contrasto.

Questa opzione è supportata da Zabbix 7.4.3.
Show lines 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:
- 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