[comment]: # ({65c03452-e03ef403})
# 15 Tarjeta de métrica

[comment]: # ({/65c03452-e03ef403})

[comment]: # ({50641221-cb7939c5})
### Descripción

Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de panel permiten configurar
el widget [*Tarjeta de métrica*](/manual/web_interface/frontend_sections/dashboards/widgets/item_card) en los métodos `dashboard.create` y `dashboard.update`.

::: noteimportant
Las propiedades `fields` del widget no se validan durante la creación o actualización de un panel.
Esto permite a los usuarios modificar [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 *Tarjeta de métrica*, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
:::

[comment]: # ({/50641221-cb7939c5})

[comment]: # ({8318f93b-b004895d})
### Parámetros

Se admiten los siguientes parámetros para el widget *Tarjeta de elemento*.

|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 - *(por defecto)* 1 minuto;<br>120 - 2 minutos;<br>600 - 10 minutos;<br>900 - 15 minutos.|
|*Elemento*|<|4|itemid.0|ID de [Elemento](/manual/api/reference/item/get).<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si *Elemento (Widget)* no está establecido|
|<|*Elemento (Widget)*|1|itemid.\_reference|En lugar del ID de [Elemento](/manual/api/reference/item/get):<br>`ABCDE._itemid` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Referencia* configurado en "`ABCDE`") como fuente de datos para el elemento.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si *Elemento* no está establecido|
|*Mostrar*|<|0|sections.0|0 - Descripción;<br>1 - Texto de error;<br>2 - Métricas;<br>3 - Últimos datos;<br>4 - Tipo de información;<br>5 - Disparadores;<br>6 - Interfaz del host;<br>7 - Tipo;<br>8 - Inventario del host;<br>9 - Etiquetas.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la sección en la lista de secciones. Para configurar varias secciones, cree un objeto de campo de widget de panel para cada sección con un número incrementado en el nombre de la propiedad.|
|*Sobrescribir host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Referencia* configurado en "`ABCDE`") como fuente de datos para los hosts;<br>`DASHBOARD._hostid` - establezca el [selector de host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) del panel como fuente de datos para los hosts.<br><br>Por defecto: `""` (vacío)<br><br>Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|

[comment]: # ({/8318f93b-b004895d})

[comment]: # ({6fb91e67-7444d2e3})
#### Sparkline

Se admiten los siguientes parámetros si *Mostrar* está configurado en "Últimos datos".

|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Ancho*|<|0|sparkline.width|Los valores posibles van de 0 a 10.<br><br>Por defecto: 1.|
|*Relleno*|<|0|sparkline.fill|Los valores posibles van de 0 a 10.<br><br>Por defecto: 3.|
|*Color*|<|1|sparkline.color|Código de color hexadecimal (por ejemplo, `FF0000`).<br><br>Por defecto: `42A5F5`.|
|*Período de tiempo*|<|1|sparkline.time_period.\_reference|`DASHBOARD._timeperiod` - establece el [selector de período de tiempo](/manual/web_interface/time_period_selector) del dashboard como fuente de datos;<br>`ABCDE._timeperiod` - establece un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro `reference` igual a `ABCDE`) como fuente de datos.<br><br>Por defecto: `""` (vacío)<br><br>Alternativamente, puede establecer el período de tiempo solo en los parámetros *Desde* y *Hasta*.|
|<|*Desde*|1|sparkline.time_period.from|Cadena de tiempo válida en sintaxis absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Por defecto: now-1h.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *admitido* si *Período de tiempo* no está establecido<br>- *obligatorio* si se establece `sparkline.time_period.to`|
|^|*Hasta*|1|sparkline.time_period.from|Cadena de tiempo válida en sintaxis absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Por defecto: now.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *admitido* si *Período de tiempo* no está establecido<br>- *obligatorio* si se establece `time_period.to`|
|*Datos históricos*|<|0|sparkline.history|0 - *(por defecto)* Auto;<br>1 - Historial;<br>2 - Tendencias.|

[comment]: # ({/6fb91e67-7444d2e3})

[comment]: # ({7148225f-f146ed91})
### Ejemplos

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

[comment]: # ({/7148225f-f146ed91})

[comment]: # ({a1691adf-3e0437fc})
#### Configuración de un widget *Tarjeta de métrica*

Configure un widget *Tarjeta de métrica* que muestre estas secciones: "Descripción", "Últimos datos", "Disparadores" y "Etiquetas".

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

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "Mi panel",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "itemcard",
                        "name": "Tarjeta de métrica",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42257
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 9
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

[comment]: # ({/a1691adf-3e0437fc})

[comment]: # ({e9d30322-25bd508b})
### Véase también

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

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