[comment]: # ({d052d97c-b1d00045})
# 17 Navegador de métricas

[comment]: # ({/d052d97c-b1d00045})

[comment]: # ({8f5d8398-a8620fa9})
### Descripción

Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo de widget de panel permiten configurar el widget [*Navegador de métricas*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator) 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 *Navegador de métricas*, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
:::

[comment]: # ({/8f5d8398-a8620fa9})

[comment]: # ({7bff23dc-43b2c246})
### Parámetros

Los siguientes parámetros son compatibles con el widget *Item navigator*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Refresh interval*|<|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.|
|*Host groups*|<|2|groupids.0|ID del [Host group](/manual/api/reference/hostgroup/get).<br><br>Nota: Para configurar varios host groups, cree un objeto de campo de widget de dashboard para cada host group con un número incrementado en el nombre de la propiedad.<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Host groups (Widget)*|1|groupids.\_reference|En lugar del ID de [Host group](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Reference* establecido en "`ABCDE`") como fuente de datos para host groups.<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Hosts*|<|3|hostids.0|ID de [Host](/manual/api/reference/host/get).<br><br>Nota: Para configurar varios hosts, cree un objeto de campo de widget de dashboard para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro *Host groups* no debe estar configurado en absoluto o debe estar configurado con al menos un host group al que pertenezcan los hosts configurados.<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|En lugar del ID de [Host](/manual/api/reference/host/get):<br>`DASHBOARD.hostid` - establezca el [selector *Host*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) como fuente de datos para hosts;<br>`ABCDE._hostid` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Reference* establecido en "`ABCDE`") como fuente de datos para hosts.<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Host tags*|<|<|<|<|
|<|*Evaluation type*|0|host_tags_evaltype|0 - *(predeterminado)* And/Or;<br>2 - Or.<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag name*|1|host_tags.0.tag|Cualquier valor de cadena.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Host tags*<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Operator*|0|host_tags.0.operator|0 - Contiene;<br>1 - Igual a;<br>2 - No contiene;<br>3 - No es igual a;<br>4 - Existe;<br>5 - No existe.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Host tags*<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|^|*Tag value*|1|host_tags.0.value|Cualquier valor de cadena.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Host tags*<br><br>Este parámetro no es compatible si se configura el widget en un [template dashboard](/manual/api/reference/templatedashboard/object).|
|*Item patterns*|<|1|items.0|Nombre o patrón de [Item](/manual/api/reference/item/get).<br><br>Nota: Para configurar varios patrones de item, cree un objeto de campo de widget de dashboard para cada patrón de item con un número incrementado en el nombre de la propiedad.|
|*Item tags*|<|<|<|<|
|<|*Evaluation type*|0|item_tags_evaltype|0 - *(predeterminado)* And/Or;<br>2 - Or.|
|^|*Tag name*|1|item_tags.0.tag|Cualquier valor de cadena.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Item tags*|
|^|*Operator*|0|item_tags.0.operator|0 - Contiene;<br>1 - Igual a;<br>2 - No contiene;<br>3 - No es igual a;<br>4 - Existe;<br>5 - No existe.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Item tags*|
|^|*Tag value*|1|item_tags.0.value|Cualquier valor de cadena.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configuran *Item tags*|
|*State*|<|0|state|-1 - *(predeterminado)* Todos;<br>0 - Normal;<br>1 - No soportado.|
|*Show problems*|<|0|show_problems|0 - Todos;<br>1 - *(predeterminado)* Sin suprimir;<br>2 - Ninguno.|
|*Group by*|<|<|<|<|
|<|*Attribute*|0|group_by.0.attribute|0 - Host group;<br>1 - Nombre del host;<br>2 - Valor de etiqueta de host;<br>3 - Valor de etiqueta de item.<br><br>Nota: El número en el nombre de la propiedad hace referencia al orden del atributo en la lista de atributos de agrupación.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configura *Group by*|
|^|*Value*|1|group_by.0.tag_name|Cualquier valor de cadena.<br><br>Nota: El número en el nombre de la propiedad hace referencia al atributo de agrupación establecido en el parámetro *Attribute*.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio* si se configura *Group by* y *Attribute* está establecido en "Host tag value" o "Item tag value"|
|*Item limit*|<|0|show_lines|Los valores posibles van de 1 a 9999.<br><br>Predeterminado: 100.|
|*Reference*|<|1|reference|Cualquier valor de cadena compuesto por 5 caracteres (por ejemplo, `ABCDE` o `JBPNL`). Este valor debe ser único dentro del dashboard al que pertenece el widget.<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatorio*|

[comment]: # ({/7bff23dc-43b2c246})

[comment]: # ({ffdf4230-d96958ab})
### Ejemplos

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

[comment]: # ({/ffdf4230-d96958ab})

[comment]: # ({437d3f78-ae3ed50a})
#### Configuración de un widget *Navegador de métricas*

Configure un widget *Navegador de métricas* que muestre hasta 1000 métricas agrupadas por su equipo y, luego, por el valor de la etiqueta de métrica "component".

[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": "itemnavigator",
                        "name": "Item navigator",
                        "x": "0",
                        "y": "0",
                        "width": "12",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 0,
                                "name": "group_by.0.attribute",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "group_by.1.attribute",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "group_by.1.tag_name",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "show_lines",
                                "value": 1000
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "DFNLK"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Respuesta:

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

[comment]: # ({/437d3f78-ae3ed50a})

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