[comment]: # ({167707a1-6d33dfbd})
# 8 Gràfic

[comment]: # ({/167707a1-6d33dfbd})

[comment]: # ({eaf2d1f3-5c2abed1})
### 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
[*Gràfic*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) 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/dashboards/widgets) i crear [ginys personalitzats](/devel/modules/tutorials/widget), però també afegeix el risc de creació o actualització incorrectes dels ginys.
Per garantir la creació o actualització correcta del giny *Gràfic*, consulteu el comportament dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/eaf2d1f3-5c2abed1})

[comment]: # ({86c426f8-75d80010})
### Paràmetres

Els paràmetres següents s'admeten al giny de *Gràfic*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|-----|-------------------|
|*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|

[comment]: # ({/86c426f8-75d80010})

[comment]: # ({59cea80f-9cf31911})
#### Conjunt de dades

Els paràmetres següents són compatibles per configurar un *conjunt de dades*.

::: noteclassic
El primer nombre del nom de la propietat (p. ex., ds.hosts.0.0, ds.items.0.0) representa el conjunt de dades concret;
mentre que el segon nombre, si està present, representa l'equip o l'element configurat.
:::

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Tipus de conjunt de dades*|<|0|ds.dataset_type.0|0 - Llista d'elements;<br>1 - *(per defecte)* Patró d'element.|
|Paràmetres si *Tipus de conjunt de dades* s'estableix a "Llista d'elements"|<|<|<|<|
|<|*Items*|4|ds.itemids.0.0|Identificador de [Item](/manual/api/reference/item/get).<br><br>Nota: per configurar diversos elements, creeu un camp de giny de tauler objecte per a cada element.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|^|*Color*|1|ds.color.0.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *obligatori*|
|Paràmetres si *Tipus de conjunt de dades* s'estableix en "Patró d'element"|<|<|<|<|
|<|*Patró d'equip*|1|ds.hosts.0.0|[Equip](/manual/api/reference/host/get) nom o patró (p. ex., "Zabbix\*").<br><br> [Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|^|*Patró d'element*|1|ds.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex., "\*: Nombre de \*valors per segon" processats) ).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|^|*Color*|1|ds.color.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `FF465C`.|
|*Dibuix*|<|0|ds.type.0|0 - *(per defecte)* Línia;<br>1 - Punts;<br>2 - Escala;<br>3 - Barra.|
|*Stacked*|<|0|ds.stacked.0|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>El paràmetre *Stacked* no és disponible si *Dibuix* s'ha establert a "Punts".|
|*Amplada*|<|0|ds.width.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 1.<br><br>El paràmetre *Amplada* no és disponible si *Dibuix* s'ha establert a "Punts" o "Barra".|
|*Mida del punt*|<|0|ds.pointsize.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 3.<br><br>Paràmetre *Mida del punt* no disponible si *Dibuix* s'estableix a "Línia", "Escala" o "Barra".|
|*Transparència*|<|0|ds.transparency.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 5.|
|*Emplenat*|<|0|ds.fill.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Emplenat* no és disponible si *Dibuix* s'ha establert a "Punts" o "Barra".|
|*Manquen dades*|<|0|ds.missingdatafunc.0|0 - *(per defecte)* Cap;<br>1 - Connectat;<br>2 - Tracta com a 0;<br>3 - Darrer conegut.< br><br>El paràmetre *Manquen dades* no és disponible si *Dibuix* s'estableix a "Punts" o "Barra".|
|*Eix Y*|<|0|ds.axisy.0|0 - *(per defecte)* Esquerra;<br>1 - Dreta.|
|*Desplaçament de temps*|<|1|ds.timeshift.0|Cadena de temps vàlida (p. ex., `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/sufixos #sufixos-temps). També es permeten valors negatius.<br><br>Per defecte: `""` (buida).|
|*Funció d'afegit*|<|0|ds.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte;<br>5 - suma;<br>6 - primer;<br>7 - darrer.|
|*Interval d'afegit*|<|1|ds.aggregate_interval.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes #sufixos de temps).<br><br>Per defecte: `1h`.|
|*Afegit*|<|0|ds.aggregate_grouping.0|0 - *(per defecte)* Cada element;<br>1 - Conjunt de dades.<br><br>Paràmetre *Afegit* no disponible si *Funció d'afegit* s'estableix a "cap".|
|*Aproximació*|<|0|ds.approximation.0|1 - mín;<br>2 - *(per defecte)* mitjana;<br>4 - màxim;<br>7 - tot.|
|*Etiqueta del conjunt de dades*|<|1|ds.data_set_label.0|Qualsevol valor de cadena.<br><br>Per defecte: `""` (buida).|

[comment]: # ({/59cea80f-9cf31911})

[comment]: # ({1114c542-1e2d4083})
#### Opcions de visualització

S'admeten els paràmetres següents per configurar les *Opcions de visualització*.

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Tria de dades de l'historial*|<|0|font|0 - *(per defecte)* Automàtic;<br>1 - Historial;<br>2 - Tendències.|
|*Triggers simples*|<|0|activadors_simples|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Temps de treball*|<|0|working_time|0 - *(per defecte)* Inhabilitat;<br>1 - Activat.|
|*Línia percentil (esquerra)* (paràmetre disponible si *Eix Y* (a la configuració del *Conjunt de dades*) s'ha establert a "Esquerra")|<|<|<|<|
|<|*Estat*|0|percentile_left|0 - *(per defecte)* Inhabilitat;<br>1 - Activat.|
|^|*Valor*|0|valor_percentil_esquerra|Els valors vàlids oscil·len entre 1 i 100.|
|*Línia percentil (dreta)* (paràmetre disponible si *eix Y* (a la configuració *Conjunt de dades*) s'ha establert a "Dreta")|<|<|<|<|
|<|*Estat*|0|percentile_right|0 - *(per defecte)* Inhabilitat;<br>1 - Activat.|
|^|*Valor*|0|valor_percentil_dret|Els valors vàlids oscil·len entre 1 i 100.|

[comment]: # ({/1114c542-1e2d4083})

[comment]: # ({36354072-2fc4e743})
#### Període de temps

S'admeten els paràmetres següents per configurar el *Període de temps*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Estableix un període de temps personalitzat*|0|graph_time|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Des de*|1|time_from|Cadena d'hora vàlida en format `AAAA-MM-DD hh:mm:ss`.<br>[Període de temps relatiu](/manual/config/visualization/graphs/simple#time-period -selector) també són compatibles (`now`, `now/d`, `now/w-1w`, etc.) també són compatibles.<br><br>Per defecte: `now-1h`.|
|*Fins a*|1|time_to|Valor de cadena de temps vàlid en format `AAAA-MM-DD hh:mm:ss`.<br>[Període de temps relatiu](/manual/config/visualization/graphs/simple#time- selector de períodes) també s'admeten valors (`now`, `now/d`, `ara/w-1w`, etc.) també s'admeten.<br><br>Per defecte: `now`.|

[comment]: # ({/36354072-2fc4e743})

[comment]: # ({a0674fde-bca60ab8})
#### Eixos

S'admeten els paràmetres següents per configurar els *Eixos*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Left Y*|0|lefty|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.<br><br>Paràmetre disponible si l'*eix Y* (a la configuració del *Conjunt de dades*) s'ha establert a "Esquerra".|
|*Right Y*|0|righty|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>Paràmetre disponible si s'estableix *Eix Y* (a la configuració del *Conjunt de dades*) a "Dreta".|
|*Min*|1|lefty_min|Qualsevol valor numèric.<br><br>Per defecte: `""` (buit).|
|^|^|righty_min|^|
|*Max*|1|lefty_max|Qualsevol valor numèric.<br><br>Per defecte: `""` (buit).|
|^|^|righty_max|^|
|*Units* (tipus)|0|unitats_esquerra|0 - *(per defecte)* Automàtic;<br>1 - Estàtic.|
|^|^|unitats_dretes|^|
|*Units* (valor)|1|lefty_static_units|Qualsevol valor de cadena.<br><br>Per defecte: `""` (buida).|
|^|^|unitats_estàtiques_dretes|^|
|*X-Axis*|0|xaxis|0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.|

[comment]: # ({/a0674fde-bca60ab8})

[comment]: # ({5048810c-09de7a04})
#### Llegenda

S'admeten els paràmetres següents per configurar la *Llegenda*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Mostra la llegenda*|0|llegenda|0 - Desactivat;<br>1 - *(per defecte)* Activat.|
|*Mostra min/max/avg*|0|legend_statistic|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Nombre de fileres*|0|línies_legenda|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 1.|
|*Nombre de columnes*|0|legend_columns|Els valors vàlids van d'1 a 4.<br><br>Per defecte: 4.|

[comment]: # ({/5048810c-09de7a04})

[comment]: # ({096b9803-82002e68})
#### Problemes

S'admeten els paràmetres següents per configurar els *Problemes*.

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Mostra problemes*|<|0|mostra_problemes|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Només elements seleccionats*|<|0|graph_item_problems|0 - Inhabilitat;<br>1 - *(per defecte)* Activat.|
|*Equips amb problemes*|<|1|problemhosts.0|Nom d'[Equip](/manual/api/reference/host/get).<br><br>Nota: el nombre del nom de la propietat fa referència a l'equip configurat. <br>Per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip.|
|*Gravetat*|<|0|graveses|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Per defecte: buit (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.|
|*Problema*|<|1|nom_problema|Problema [nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) (no distingeix entre majúscules i minúscules, nom complet o part d'aquest).|
|*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>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *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>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*|
|^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*|

[comment]: # ({/096b9803-82002e68})

[comment]: # ({b69e3838-4097ae32})
#### Anul·lacions

Els paràmetres següents s'admeten per configurar *Anul·lacions*.

::: noteclassic
El primer nombre del nom de la propietat (p. ex. or.hosts.0.0 o.items.0.0) representa el conjunt de dades concret; mentre que el segon nombre, si és present, representa l'equip o element configurat.
:::

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Patró d'equip*|1|or.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`).<br><br>[Comportament del paràmetre] (/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|*Patró d'element*|1|or.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de *valors per segon` processats).<br> <br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|
|*Color base*|1|o.color.0|Codi de color hexadecimal (per exemple, `FF0000`).|
|*Amplada*|0|o.amplada.0|Els valors vàlids oscil·len entre 1 i 10.|
|*Dibuix*|0|o.tipus.0|0 - Línia;<br>1 - Punts;<br>2 - Escala;<br>3 - Barra.|
|*Transparència*|0|o.transparència.0|Els valors vàlids van d'1 a 10.|
|*Emplenat*|0|or.fill.0|Els valors vàlids oscil·len entre 1 i 10.|
|*Mida del punt*|0|o.mida del punt.0|Els valors vàlids oscil·len entre 1 i 10.|
|*Manquen dades*|0|o.missingdatafunc.0|0 - Cap;<br>1 - Connectat;<br>2 - Tracta com a 0;<br>3 - Darrer conegut.|
|*Eix Y*|0|o.eix.0|0 - Esquerra;<br>1 - Dreta.|
|*Desplaçament de temps*|1|o.timeshift.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time-suffixes). Es permeten valors negatius.|

[comment]: # ({/b69e3838-4097ae32})

[comment]: # ({0d773487-5887cb51})
### 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 *Gràfic*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/0d773487-5887cb51})

[comment]: # ({9f956f09-102e83b4})
#### Configurar un giny *Gràfic*

Configura un giny *Gràfic* de la manera següent:

- 2 conjunts de dades per a un total de 9 elements en 1 equip.
- El primer conjunt de dades és de tipus "Llista d'elements" i consta de 3 elements que es representen per línies amb un color diferent, però amb la mateixa amplada, transparència i farciment.
- El segon conjunt de dades és de tipus "Patró d'elements", consta de 6 elements, té una agregació configurada i es representa amb una línia amb un color, amplada, transparència i farciment personalitzats.
- El segon conjunt de dades també té una etiqueta de conjunt de dades personalitzada.
- Les dades del gràfic es mostren durant un període de temps de les últimes 3 hores.
- Els problemes del gràfic només es mostren per als elements configurats.
- El gràfic té dos eixos Y dels quals l'eix Y dret només mostra valors per al segon conjunt de dades.
- La llegenda del gràfic mostra els elements configurats en 4 files, així com els valors mínims, màxims i mitjans dels conjunts de dades.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "El meu tauler",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "svggraph",
                        "name": "Graph",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "ds.dataset_type.0",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.1",
                                "value": 23264
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.1",
                                "value": "FF0000"
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.2",
                                "value": 23269
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.2",
                                "value": "BF00FF"
                            },
                            {
                                "type": 4,
                                "name": "ds.itemids.0.3",
                                "value": 23257
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0.3",
                                "value": "0040FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.width.0",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.0",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.0",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.hosts.1.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.items.1.0",
                                "value": "*: Number of processed *values per second"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.1",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.1",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.1",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.axisy.1",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_function.1",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.aggregate_interval.1",
                                "value": "1m"
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_grouping.1",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.data_set_label.1",
                                "value": "Number of processed values per second"
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_from",
                                "value": "now-3h"
                            },
                            {
                                "type": 0,
                                "name": "legend_statistic",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "show_problems",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/9f956f09-102e83b4})

[comment]: # ({e9d30322-3c27dd53})
### 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-3c27dd53})