[comment]: # ({950cd7fb-dfa1aefb})
# 23 Problemi

[comment]: # ({/950cd7fb-dfa1aefb})

[comment]: # ({205f6423-c733131f})
### Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) nei metodi `dashboard.create` e `dashboard.update`.

::: noteimportant
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](/manual/web_interface/frontend_sections/dashboards/widgets) e creare [widget personalizzati](/devel/modules/tutorials/widget), 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.
:::

[comment]: # ({/205f6423-c733131f})

[comment]: # ({c08c04cf-07abd3fb})
### Parametri

I seguenti parametri sono supportati per il widget *Problems*.

|Parametro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervallo di aggiornamento*|<|0|rf_rate|0 - Nessun aggiornamento;<br>10 - 10 secondi;<br>30 - 30 secondi;<br>60 - *(predefinito)* 1 minuto;<br>120 - 2 minuti;<br>600 - 10 minuti;<br>900 - 15 minuti.|
|*Mostra*|<|0|show|1 - *(predefinito)* Problemi recenti;<br>2 - Cronologia;<br>3 - Problemi.|
|*Gruppi di host*|<|2|groupids.0|ID del [gruppo di host](/manual/api/reference/hostgroup/get).<br><br>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à.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Gruppi di host (Widget)*|1|groupids.\_reference|Invece dell'ID del [gruppo di host](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati per i gruppi di host.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Escludi gruppi di host*|<|2|exclude_groupids.0|ID del [gruppo di host](/manual/api/reference/hostgroup/get).<br><br>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à.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Host*|<|3|hostids.0|ID dell'[host](/manual/api/reference/host/get).<br><br>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.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Host (Widget/Dashboard)*|1|hostids.\_reference|Invece dell'ID dell'[host](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - imposta il [selettore host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) della dashboard come origine dati per gli host;<br>`ABCDE._hostids` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati per gli host.<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Problema*|<|1|problem|[Nome evento](/manual/config/triggers/trigger#configuration) del problema (senza distinzione tra maiuscole e minuscole, nome completo o parte di esso).|
|*Gravità*|<|0|severities.0|0 - Non classificato;<br>1 - Informazione;<br>2 - Avviso;<br>3 - Media;<br>4 - Alta;<br>5 - Disastro.<br><br>Predefinito: vuoto (tutti abilitati).<br><br>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;<br>2 - Or.|
|^|*Nome tag*|1|tags.0.tag|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se si configurano i *Tag del problema*|
|^|*Operatore*|0|tags.0.operator|0 - Contiene;<br>1 - Uguale;<br>2 - Non contiene;<br>3 - Diverso da;<br>4 - Esiste;<br>5 - Non esiste.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se si configurano i *Tag del problema*|
|^|*Valore tag*|1|tags.0.value|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required* se si configurano i *Tag del problema*|
|*Mostra tag*|<|0|show_tags|0 - *(predefinito)* Nessuno;<br>1 - 1;<br>2 - 2;<br>3 - 3.|
|*Nome tag* (formato)|<|0|tag_name_format|0 - *(predefinito)* Completo;<br>1 - Abbreviato;<br>2 - Nessuno.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* se *Mostra tag* è impostato su "1", "2" o "3"|
|*Priorità di visualizzazione dei tag*|<|1|tag_priority|Elenco di tag separati da virgole.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* se *Mostra tag* è impostato su "1", "2" o "3"|
|*Mostra dati operativi*|<|0|show_opdata|0 - *(predefinito)* Nessuno;<br>1 - Separatamente;<br>2 - Con il nome del problema.|
|*Mostra problemi soppressi*|<|0|show_suppressed|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Stato del riconoscimento*|<|0|acknowledgement_status|0 - *(predefinito)* tutti;<br>1 - Non riconosciuti; <br>2 - Riconosciuti.|
|*Da me*|<|0|acknowledged_by_me|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Ordina voci per*|<|0|sort_triggers|1 - Gravità (decrescente);<br>2 - Host (crescente);<br>3 - Ora (crescente);<br>4 - *(predefinito)* Ora (decrescente);<br>13 - Gravità (crescente);<br>14 - Host (decrescente);<br>15 - Problema (crescente);<br>16 - Problema (decrescente).<br><br>Per tutti i valori, eccetto "Ora (decrescente)" e "Ora (crescente)", il parametro *Mostra timeline* deve essere impostato su "Disabilitato".<br><br>I valori "Host (crescente)" e "Host (decrescente)" non sono supportati se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Mostra timeline*|<|0|show_timeline|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* se *Ordina voci per* è impostato su "Ora (decrescente)" o "Ora (crescente)"|
|*Evidenzia l'intera riga*|<|0|highlight_row|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>Questo parametro non è supportato nei temi ad alto contrasto.|
|*Mostra righe*|<|0|show_lines|I valori possibili vanno da 1 a 100.<br><br>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.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|

[comment]: # ({/c08c04cf-07abd3fb})

[comment]: # ({8a68f84b-c49bef65})
### 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`](/manual/api/reference/dashboard/create).

[comment]: # ({/8a68f84b-c49bef65})

[comment]: # ({253704d3-1317b036})
#### 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](/manual/api#performing-requests):

```json
{
    "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:

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

[comment]: # ({/253704d3-1317b036})

[comment]: # ({e9d30322-a778f187})
### Vedi anche

- [Campo del widget della dashboard](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-a778f187})