[comment]: # ({093ad1f3-8b285a74})
# 3 Vista general de les dades

[comment]: # ({/093ad1f3-8b285a74})

[comment]: # ({77f1ca42-ecbfa4b1})
::: noteimportant
Aquest giny és obsolet i s'eliminarà a la propera versió principal.
Penseu en emprar el giny [*Equips principals*](/manual/api/reference/dashboard/widget_fields/top_hosts).
:::

[comment]: # ({/77f1ca42-ecbfa4b1})

[comment]: # ({46c56c9f-4a755106})
### Descripció

Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny
de [*visualització de dades*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) als mètodes `dashboard.create` i `dashboard.update`.

::: noteimportant
Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler.
Això permet als usuaris modificarels  [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys.
Per garantir la creació o actualització correcta del giny *Visualització de dades*, consulteu els requisits dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/46c56c9f-4a755106})

[comment]: # ({a0b55785-06bdb405})
### Paràmetres

Els paràmetres següents són compatibles amb el giny *Visió general de dades*.

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|
|*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.|
|*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips , creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar amb almenys un grup d'equips al qual pertanyen els equips configurats.|
|*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<|
|<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.|
|^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>Cal el paràmetre *Nom de l'etiqueta* si es configura *Etiquetes*.|
|^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>El paràmetre *Operador* és necessari si es configura *Etiquetes*.|
|^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>El paràmetre *Valor de l'etiqueta* és necessari si es configura *Etiquetes*.|
|*Veure els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Ubicació de l'equip*|<|0|style|0 - *(per defecte)* Esquerra;<br>1 - A dalt.|

[comment]: # ({/a0b55785-06bdb405})

[comment]: # ({7663ef93-ea5f1a97})
### Exemples

Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Vista general de dades*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/7663ef93-ea5f1a97})

[comment]: # ({56f59830-2a2d8ed8})
#### Configuració d'un giny *Visió general de dades*

Configura un giny *Visió general de dades* que ensenya dades de l'equip "10084" i només per als elements per als quals l'etiqueta amb el nom "component" conté el valor "cpu".
A més, ensenya les dades amb els equips situats a la part superior.

Petició:

```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "dataover",
"name": "Data overview",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 3,
"name": "hostids",
"value": 10084
},
{
"type": 1,
"name": "tags.tag.0",
"value": "component"
},
{
"type": 0,
"name": "tags.operator.0",
"value": 0
},
{
"type": 1,
"name": "tags.value.0",
"value": "cpu"
},
{
"type": 0,
"name": "style",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```

Resposta:

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

[comment]: # ({/56f59830-2a2d8ed8})

[comment]: # ({e9d30322-27a42ae9})
### Veieu també

-   [Camp de giny de tauler](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

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