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

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

[comment]: # ({eaf2d1f3-5c2abed1})
### Descripción


Estos parámetros y los valores posibles de propiedad  para los objetos de campo del widget del tablero respectivo permiten configurar
el widget [*Gráfico*](/manual/web_interface/frontend_sections/dashboards/widgets/graph) en los métodos `dashboard.create` y `dashboard.update`.

::: noteimportant
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero.
Esto permite a los usuarios modificar los [widgets integrados](/manual/web_interface/frontend_sections/dashboards/widgets) y crear [widgets personalizados](/devel/modules/tutorials/widget), pero también introduce el riesgo de crear o actualizar widgets. incorrectamente.
Para garantizar la creación o actualización exitosa del widget *Gráfico*, consulte el comportamiento de los parámetros descrito en las tablas siguientes.
:::

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

[comment]: # ({86c426f8-75d80010})
### Parámetros

Los siguientes parámetros son compatibles con el widget *Gráfico*.

|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Intervalo de actualización*|0|rf_rate|0 - Sin actualización;<br>10 - 10 segundos;<br>30 - 30 segundos;<br>60 - *(predeterminado)* 1 minuto;<br>120 - 2 minutos;<br>600 - 10 minutos;<br>900 - 15 minutos.|

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

[comment]: # ({59cea80f-9cf31911})
#### Conjunto de datos

Los siguientes parámetros son compatibles para configurar un *conjunto de datos*.

::: noteclassic
El primer número en el nombre de la propiedad (por ejemplo, ds.hosts.0.0, ds.items.0.0) representa el conjunto de datos particular.
mientras que el segundo número, si está presente, representa el equipo o métrica configurada.
:::

|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Tipo de conjunto de datos*|<|0|ds.dataset_type.0|0 - Lista de elementos;<br>1 - *(predeterminado)* Patrón de elementos.|
|Parámetros si *Tipo de conjunto de datos* está establecido en "Lista de elementos"|<|<|<|<|
|<|*Items*|4|ds.itemids.0.0|[Métrica](/manual/api/reference/item/get) ID.<br><br>Nota: Para configurar varias métricas, cree un campo de widget de panel objeto para cada métrica.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|^|*Color*|1|ds.color.0.0|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br >- *obligatorio*|
|Parámetros si *Tipo de conjunto de datos* está establecido en "Patrón de elemento"|<|<|<|<|
|<|*Patrón de equipo*|1|ds.hosts.0.0|Nombre de [equipo](/manual/api/reference/host/get)  o patrón (por ejemplo, "Zabbix\*").<br><br> [Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|^|*Patrón de métrica*|1|ds.items.0.0|Nombre de [métrica](/manual/api/reference/item/get) o patrón (por ejemplo, "\*: Número de \*valores procesados por segundo" ).<br><br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|^|*Color*|1|ds.color.0|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Predeterminado: `FF465C`.|
|*Dibujar*|<|0|ds.type.0|0 - *(predeterminado)* Línea;<br>1 - Puntos;<br>2 - Escalera;<br>3 - Barra.|
|*Apilado*|<|0|ds.stacked.0|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.<br><br>El parámetro *Apilado* no está disponible si *Dibujar* está configurado en "Puntos".|
|*Ancho*|<|0|ds.width.0|Los valores válidos oscilan entre 1 y 10.<br><br>Predeterminado: 1.<br><br>El parámetro *Ancho* no está disponible si *Dibujo* está establecido en "Puntos" o "Barra".|
|*Tamaño de punto*|<|0|ds.pointsize.0|Los valores válidos oscilan entre 1 y 10.<br><br>Predeterminado: 3.<br><br>El parámetro *Tamaño de punto* no está disponible si *Dibuja * está configurado en "Línea", "Escalera" o "Bar".|
|*Transparencia*|<|0|ds.transparency.0|Los valores válidos oscilan entre 1 y 10.<br><br>Predeterminado: 5.|
|*Relleno*|<|0|ds.fill.0|Los valores válidos oscilan entre 1 y 10.<br><br>Predeterminado: 3.<br><br>El parámetro *Fill* no está disponible si *Dibujar* está establecido en "Puntos" o "Barra".|
|*Datos faltantes*|<|0|ds.missingdatafunc.0|0 - *(predeterminado)* Ninguno;<br>1 - Conectado;<br>2 - Tratar como 0;<br>3 - Último conocido.< br><br>El parámetro *Falta datos* no está disponible si *Dibujo* está configurado en "Puntos" o "Barra".|
|*Eje Y*|<|0|ds.axisy.0|0 - *(predeterminado)* Izquierda;<br>1 - Derecha.|
|*Timeshift*|<|1|ds.timeshift.0|Cadena de tiempo válida (por ejemplo, `3600`, `1h`, etc.).<br>Puede usar [sufijos de tiempo](/manual/appendix/suffixes #sufijos de tiempo). También se permiten valores negativos.<br><br>Predeterminado: `""` (vacío).|
|*Función de agregación*|<|0|ds.aggregate_function.0|0 - *(predeterminado)* ninguno;<br>1 - min;<br>2 - max;<br>3 - promedio;<br>4 - contar;<br>5 - suma;<br>6 - primero;<br>7 - último.|
|*Intervalo de agregación*|<|1|ds.aggregate_interval.0|Cadena de tiempo válida (por ejemplo, `3600`, `1h`, etc.).<br>Puede usar [sufijos de tiempo](/manual/appendix/suffixes #sufijos de tiempo).<br><br>Predeterminado: `1h`.|
|*Agregar*|<|0|ds.aggregate_grouping.0|0 - *(predeterminado)* Cada elemento;<br>1 - Conjunto de datos.<br><br>Parámetro *Agregar* no disponible si *Función de agregación* está configurado en "ninguno".|
|*Aproximación*|<|0|ds.approximation.0|1 - min;<br>2 - *(predeterminado)* promedio;<br>4 - máx;<br>7 - todos.|
|*Etiqueta del conjunto de datos*|<|1|ds.data_set_label.0|Cualquier valor de cadena.<br><br>Predeterminado: `""` (vacío).|

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

[comment]: # ({1114c542-1e2d4083})
#### Opciones de visualización

Los siguientes parámetros son compatibles para configurar *Opciones de visualización*.

|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Selección de datos del historial*|<|0|source|0 - *(predeterminado)* Automático;<br>1 - Historial;<br>2 - Tendencias.|
|*Iniciadores simples*|<|0|simple_triggers|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|*Tiempo de trabajo*|<|0|working_time|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|*Línea percentil (izquierda)* (parámetro disponible si *eje Y* (en la configuración del *conjunto de datos*) está establecido en "Izquierda")|<|<|<|<|
|<|*Estado*|0|percentile_left|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|^|*Valor*|0|percentile_left_value|Los valores válidos oscilan entre 1 y 100.|
|*Línea percentil (derecha)* (parámetro disponible si *eje Y* (en la configuración del *conjunto de datos*) está establecido en "Derecha")|<|<|<|<|
|<|*Estado*|0|percentile_right|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|^|*Valor*|0|percentile_right_value|Los valores válidos oscilan entre 1 y 100.|

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

[comment]: # ({36354072-2fc4e743})
#### Periodo de tiempo

Los siguientes parámetros son compatibles para configurar *Período de tiempo*.

|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Establecer período de tiempo personalizado*|0|graph_time|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|*Desde*|1|time_from|Cadena de tiempo válida en formato `AAAA-MM-DD hh:mm:ss`.<br>[Periodo de tiempo relativo](/manual/config/visualization/graphs/simple#time-period -selector) (`now`, `now/d`, `now/w-1w`, etc.) también son compatibles.<br><br>Predeterminado: `now-1h`.|
|*Hasta*|1|time_to|Valor de cadena de tiempo válido en formato `AAAA-MM-DD hh:mm:ss`.<br>[Periodo de tiempo relativo](/manual/config/visualization/graphs/simple#time- period-selector) también se admiten valores (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Predeterminado: `now`.|

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

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

Los siguientes parámetros son compatibles para configurar *Ejes*.

|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Izquierda Y*|0|lefty|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.<br><br>Parámetro disponible si *Eje Y* (en la configuración del *Conjunto de datos*) está configurado a "Izquierda".|
|*Derecha Y*|0|righty|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.<br><br>Parámetro disponible si *Eje Y* (en la configuración del *Conjunto de datos*) está configurado a "Derecha".|
|*Min*|1|lefty_min|Cualquier valor numérico.<br><br>Predeterminado: `""` (vacío).|
|^|^|righty_min|^|
|*Max*|1|lefty_max|Cualquier valor numérico.<br><br>Predeterminado: `""` (vacío).|
|^|^|righty_max|^|
|*Unidades* (tipo)|0|lefty_units|0 - *(predeterminado)* Automático;<br>1 - Estático.|
|^|^|unidades_derechas|^|
|*Unidades* (valor)|1|lefty_static_units|Cualquier valor de cadena.<br><br>Predeterminado: `""` (vacío).|
|^|^|righty_static_units|^|
|*Eje X*|0|xaxis|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.|

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

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

Los siguientes parámetros son compatibles para configurar *Leyenda*.

|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Mostrar leyenda*|0|legend|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.|
|*Mostrar mínimo/máximo/promedio*|0|legend_statistic|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|*Número de filas*|0|legend_lines|Los valores válidos oscilan entre 1 y 10.<br><br>Predeterminado: 1.|
|*Número de columnas*|0|legend_columns|Los valores válidos oscilan entre 1 y 4.<br><br>Predeterminado: 4.|

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

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

Los siguientes parámetros son compatibles para configurar *Problemas*.

|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Mostrar problemas*|<|0|show_problems|0 - *(predeterminado)* Deshabilitado;<br>1 - Habilitado.|
|*Solo métricas seleccionadas*|<|0|graph_item_problems|0 - Deshabilitado;<br>1 - *(predeterminado)* Habilitado.|
|*Equipos con probemas*|<|1|problemhosts.0|Nombre de [equipo](/manual/api/reference/host/get).<br><br>Nota: El número en el nombre de la propiedad hace referencia al equipo configurado. <br>Para configurar varios equipos, cree un objeto de campo de widget de tablero para cada equipo.|
|*Gravedad*|<|0|severities|0 - No clasificado;<br>1 - Información;<br>2 - Advertencia;<br>3 - Promedio;<br>4 - Alto;<br>5 - Desastre .<br><br>Predeterminado: vacio (todos habilitados).<br><br>Nota: Para configurar múltiples valores, cree un objeto de campo de widget de panel para cada valor.|
|*Problema*|<|1|problem_name|[nombre del evento](/manual/config/triggers/trigger#configuration)  del problema (no distingue entre mayúsculas y minúsculas, nombre completo o parte del mismo).|
|*Etiquetas* (el número en el nombre de la propiedad (por ejemplo, etiquetas.tag.0) hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas)|<|<|<|<|
|<|*Tipo de evaluación*|0|evaltype|0 - *(predeterminado)* Y/O;<br>2 - O.|
|^|*Nombre de etiqueta*|1|tags.tag.0|Cualquier valor de cadena.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si configura *Etiquetas*|
|^|*Operador*|0|tags.operator.0|0 - Contiene;<br>1 - Es igual;<br>2 - No contiene;<br>3 - No es igual;<br>4 - Existe ;<br>5 - No existe.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Etiquetas*|
|^|*Valor de etiqueta*|1|tags.value.0|Cualquier valor de cadena.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si configura *Etiquetas*|

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

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

Los siguientes parámetros son compatibles para configurar *Anulaciones*.

::: noteclassic
El primer número en el nombre de la propiedad (por ejemplo, or.hosts.0.0 o.items.0.0) representa el conjunto de datos particular.
mientras que el segundo número, si está presente, representa el equipo o métrica configurada.
:::

|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Patrón de equipo*|1|or.hosts.0.0|Nombre de [equipo](/manual/api/reference/host/get)  o patrón (por ejemplo, `Zabbix*`).<br><br>[Comportamiento de parámetros] (/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|*Patrón de métrica*|1|or.items.0.0|Nombre de [métrica](/manual/api/reference/item/get) o patrón (por ejemplo, `*: Número de *valores procesados por segundo`).<br> <br>[Comportamiento de parámetros](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|
|*Color base*|1|o.color.0|Código de color hexadecimal (por ejemplo, `FF0000`).|
|*Ancho*|0|o.width.0|Los valores válidos oscilan entre 1 y 10.|
|*Dibujar*|0|o.type.0|0 - Línea;<br>1 - Puntos;<br>2 - Escalera;<br>3 - Barra.|
|*Transparencia*|0|o.transparency.0|Los valores válidos oscilan entre 1 y 10.|
|*Relleno*|0|o.fill.0|Los valores válidos oscilan entre 1 y 10.|
|*Tamaño de punto*|0|o.pointsize.0|Los valores válidos oscilan entre 1 y 10.|
|*Datos faltantes*|0|or.missingdatafunc.0|0 - Ninguno;<br>1 - Conectado;<br>2 - Tratar como 0;<br>3 - Último conocido.|
|*Eje Y*|0|o.axisy.0|0 - Izquierda;<br>1 - Derecha.|
|*Timeshift*|1|o.timeshift.0|Cadena de tiempo válida (por ejemplo, `3600`, `1h`, etc.).<br>Puede usar [sufijos de tiempo](/manual/appendix/suffixes#time -sufijos). Se permiten valores negativos.|

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

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


Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del dashboard para el widget *Graph*.
Para obtener más información sobre la configuración de un dashboard, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).

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

[comment]: # ({9f956f09-102e83b4})
#### Configuración de un widget *Gráfico*

Configure un widget *Gráfico* de la siguiente manera:

- 2 conjuntos de datos para un total de 9 métricas en 1 equipo.
- El primer conjunto de datos es del tipo "Lista de métricas" y consta de 3 métricas que están representadas por líneas de diferente color, pero del mismo ancho, transparencia y relleno.
- El segundo conjunto de datos es del tipo "Patrón de métricas", consta de 6 métricas, tiene una agregación configurada y está representado por una línea con un color, ancho, transparencia y relleno personalizados.
- El segundo conjunto de datos también tiene una etiqueta de conjunto de datos personalizada.
- Los datos del gráfico se muestran durante un período de tiempo de las últimas 3 horas.
- Los problemas en el gráfico se muestran solo para las métricas configuradas.
- El gráfico tiene dos ejes Y, de los cuales el eje Y derecho muestra valores solo para el segundo conjunto de datos.
- La leyenda del gráfico muestra las métricas configuradas en 4 filas, así como los valores mínimo, máximo y promedio de los conjuntos de datos.

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

```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": 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
}
```

Respuesta:

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

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

[comment]: # ({e9d30322-3c27dd53})
### Ver también

-[Campo de widget de 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-3c27dd53})