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

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

[comment]: # ({c2d12536-4bb44173})
### 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/monitoring/dashboard/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/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 *Gràfic*, consulteu els requisits dels paràmetres que es descriuen a les taules següents.
:::

[comment]: # ({/c2d12536-4bb44173})

[comment]: # ({86c426f8-153fd258})
### 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-153fd258})

[comment]: # ({84088409-7bb6f7c8})
#### 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 h iés present, representa l'equip o l'element configurat.
:::

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|***Patró d'equip***<br>(obligatori)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`). |
|***Patró d'element***<br>(obligatori)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de processats *valors per segon`).|
|*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.|
|*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 està disponible si *Dibuix* s'estableix 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>El paràmetre *Mida del punt* no està disponible si *Draw* és establir a "Línia", "Escala" o "Bar".|
|*Transparència*|0|ds.transparency.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 5.|
|*Fill*|0|ds.fill.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Fill* no està disponible si *Draw* està establert en "Punts" o "Barra".|
|*Falten dades*|0|ds.missingdatafunc.0|0 - *(per defecte)* Cap;<br>1 - Connectat;<br>2 - Tracta com a 0.<br><br>Paràmetre *Falquen dades* no disponible si *Draw* està establert a "Punts" o "Barra".|
|*Eix Y*|0|ds.axisy.0|0 - *(per defecte)* Esquerra;<br>1 - Dreta.|
|*Time shift*|1|ds.timeshift.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos). També es permeten valors negatius.<br><br>Per defecte: `""` (buida).|
|*Funció d'agregació*|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'agregació*|1|ds.aggregate_interval.0|Cadena de temps vàlida (p. ex., `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos).<br><br>Per defecte: `1h`.|
|*Afegit*|0|ds.aggregate_grouping.0|0 - *(per defecte)* Cada element;<br>1 - Conjunt de dades.<br><br>El paràmetre *Afegit* no és pas disponible si la *funció d'agregació* és establerta a "cap".|

[comment]: # ({/84088409-7bb6f7c8})

[comment]: # ({54acedd8-065c780b})
#### Opcions de visualització

Els paràmetres següents són compatibles per configurar les *Opcions de visualització*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Selecció de dades de l'historial*|0|font|0 - *(per defecte)* Automàtic;<br>1 - Historial;<br>2 - Tendències.|

[comment]: # ({/54acedd8-065c780b})

[comment]: # ({36354072-3919b8dd})
#### 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-3919b8dd})

[comment]: # ({a0674fde-5b9b0680})
#### 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-5b9b0680})

[comment]: # ({07ca4559-12287620})
#### Llegenda

Els paràmetres següents són compatibles per configurar la *Llegenda*.

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|*Mostra la llegenda*|0|legend|0 - Desactivat;<br>1 - *(per defecte)* Activat.|
|*Nombre de files*|0|legend_lines|Els valors vàlids van d'1 a 5.<br><br>Per defecte: 1.|

[comment]: # ({/07ca4559-12287620})

[comment]: # ({64d6609b-e89fa375})
#### Problemes

Els paràmetres següents són compatibles per configurar *Problemes*.

|Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-|--------|--|---------|---------------------------- -----|
|*Veure problemes*|<|0|show_problems|0 - *(per defecte)* Desactivat;<br>1 - Activat.|
|*Només els elements seleccionats*|<|0|graph_item_problems|0 - Inhabilitat;<br>1 - *(per defecte)* Activat.|
|*Equips amb problemes*|<|1|problemhosts.0|Nom de [Host](/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|severities|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|problem_name|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>El paràmetre *Nom de l'etiqueta* és necessari 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 *Operator* é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*.|

[comment]: # ({/64d6609b-e89fa375})

[comment]: # ({7f3903f6-f2e36a05})
#### Anul·lació

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 l'element configurat.
:::

|Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor|
|-----|-|------|-------------------|
|***Patró d'equip***<br>(obligatori)|1|or.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`). |
|***Patró d'element***<br>(obligatori)|1|or.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de processats *valors per segon`).|
|*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 - Bar.|
|*Transparència*|0|o.transparència.0|Els valors vàlids van d'1 a 10.|
|*Emplenament*|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.|
|*Falten dades*|0|o.missingdatafunc.0|0 - Cap;<br>1 - Connectat;<br>2 - Tractar com a 0.|
|*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 -sufixos). Es permeten valors negatius.|

[comment]: # ({/7f3903f6-f2e36a05})

[comment]: # ({0d773487-0a1ab554})
### 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-0a1ab554})

[comment]: # ({f11b369f-6c20191c})
#### Configuració d'un giny *Gràfic*

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

- 4 conjunts de dades per a un total de 9 elements d'1 equip.
- Cada conjunt de dades consta d'una línia que té un color, amplada, transparència i farciment personalitzats.
- El conjunt de dades 4 té un afegit configurat.
- Les dades del gràfic es mostren durant un període de temps de les darreres 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 conjunt de dades 4.
- La llegenda del gràfic mostra els elements configurats en 2 files.

Petició:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "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": 1,
                                "name": "ds.hosts.0.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.items.0.0",
                                "value": "Zabbix server: Utilization of poller data collector processes, in %"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.0",
                                "value": "FF0000"
                            },
                            {
                                "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": "Zabbix server: Utilization of trapper data collector processes, in %"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.1",
                                "value": "BF00FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.width.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.1",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.hosts.2.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.items.2.0",
                                "value": "Zabbix server: Utilization of history syncer internal processes, in %"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.2",
                                "value": "0040FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.width.2",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.2",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.2",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.hosts.3.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.items.3.0",
                                "value": "*: Number of processed *values per second"
                            },
                            {
                                "type": 1,
                                "name": "ds.color.3",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.transparency.3",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.fill.3",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.axisy.3",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_function.3",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.aggregate_interval.3",
                                "value": "1m"
                            },
                            {
                                "type": 0,
                                "name": "ds.aggregate_grouping.3",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_from",
                                "value": "now-3h"
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "show_problems",
                                "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]: # ({/f11b369f-6c20191c})

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