En esta página
14 Navegador de equipos
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 equipos en los métodos dashboard.create y dashboard.update.
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 y crear widgets personalizados, 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 equipos, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Navegador de hosts.
| Parámetro | type | name | value | |
|---|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - (predeterminado) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Grupos de hosts | 2 | groupids.0 | ID del grupo de hosts. Nota: Para configurar varios grupos de hosts, cree un objeto de campo del widget del dashboard para cada grupo de hosts con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Grupos de hosts (widget) | 1 | groupids._reference | En lugar del ID del grupo de hosts:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Referencia establecido en "ABCDE") como origen de datos para los grupos de hosts.Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Patrones de hosts | 1 | hosts.0 | Nombre o patrón de host. Nota: Para configurar varios patrones de hosts, cree un objeto de campo del widget del dashboard para cada patrón de host con un número incrementado en el nombre de la propiedad. Para varios patrones de hosts, el parámetro Grupos de hosts debe no estar configurado o estar configurado con al menos un grupo de hosts al que pertenezcan los hosts que coincidan con los patrones configurados. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Estado del host | 0 | status | -1 - (predeterminado) Cualquiera; 0 - Habilitado; 1 - Deshabilitado. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Etiquetas de host | ||||
| Tipo de evaluación | 0 | host_tags_evaltype | 0 - (predeterminado) Y/O; 2 - O. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Nombre de etiqueta | 1 | host_tags.0.tag | Cualquier valor de cadena. Nota: El número del nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configura Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Operador | 0 | host_tags.0.operator | 0 - Contiene; 1 - Es igual a; 2 - No contiene; 3 - No es igual a; 4 - Existe; 5 - No existe. Nota: El número del nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configura Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Valor de etiqueta | 1 | host_tags.0.value | Cualquier valor de cadena. Nota: El número del nombre de la propiedad hace referencia al orden de la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configura Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Gravedad | 0 | severities.0 | 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Promedio; 4 - Alto; 5 - Desastre. Predeterminado: vacío (todos habilitados). Nota: Para configurar varios valores, cree un objeto de campo del widget del dashboard para cada valor con un número incrementado en el nombre de la propiedad. |
|
| Mostrar hosts en mantenimiento | 0 | maintenance | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Mostrar problemas | 0 | show_problems | 0 - Todos; 1 - (predeterminado) No suprimidos; 2 - Ninguno. |
|
| Agrupar por | ||||
| Atributo | 0 | group_by.0.attribute | 0 - Grupo de hosts; 1 - Valor de etiqueta; 2 - Gravedad. Nota: El número del nombre de la propiedad hace referencia al orden del atributo en la lista de atributos de agrupación. Comportamiento del parámetro: - obligatorio si se configura Agrupar por |
|
| Valor | 1 | group_by.0.tag_name | Cualquier valor de cadena. Nota: El número del nombre de la propiedad hace referencia al conjunto de atributos de agrupación establecido en el parámetro Atributo. Comportamiento del parámetro: - obligatorio si se configura Agrupar por y Atributo está establecido en "Valor de etiqueta" |
|
| Límite de hosts | 0 | show_lines | Los valores posibles van de 1 a 9999. Predeterminado: 100. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Referencia | 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.Comportamiento del parámetro: - obligatorio |
|
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget del panel para el widget Navegador de equipos.
Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Navegador de equipos
Configure un widget Navegador de equipos que muestre los equipos agrupados por su grupo de equipos y, luego, por el valor de la etiqueta "city".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mi panel",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "hostnavigator",
"name": "Navegador de equipos",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 2
},
{
"type": 2,
"name": "groupids.1",
"value": 4
},
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 1
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "city"
},
{
"type": 1,
"name": "reference",
"value": "SWKLB"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}