Documentation
Table of Contents
27 Iniciadores principales
Descripción
Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Iniciadores principales en los métodos dashboard.create y dashboard.update.
Las propiedades de los "campos" 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 Iniciadores principales, consulte el comportamiento de los parámetros descrito en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con el widget Activadores principales.
|Parámetro|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Intervalo de actualización|<|0|rf_rate|0 - (predeterminado) Sin actualización;
10 - 10 segundos;
30 - 30 segundos;
60 - 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.| |Grupos de hosts|<|2|groupids.0|Grupo de hosts ID.
Nota: Para configurar varios grupos de hosts, cree un widget de panel objeto de campo para cada grupo de hosts con un número incrementado en el nombre de la propiedad.
Este parámetro no se admite si se configura el widget en un panel de plantilla.| |Hosts|<|3|hostids.0|Host ID.
Nota: Para configurar varios hosts, cree un objeto de campo de widget de panel para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro Grupos de hosts no debe estar configurado en absoluto o configurarse con al menos un grupo de hosts al que pertenecen los hosts configurados.
Este parámetro no se admite si se configura el widget en un panel de plantilla.| |Problema|<|1|problema|Problema nombre del evento (no distingue entre mayúsculas y minúsculas, nombre completo o parte del mismo).| |Severidad|<|0|severidades.0|Severidades de activación.
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;<br >4 - Alto;
5 - Desastre.
Valor predeterminado: vacío (todo habilitado).
Nota: Para configurar varios valores, cree un objeto de campo de widget de panel para cada valor con un número incrementado en el nombre de la propiedad.| |Etiquetas problemáticas|<|<|<|<| |<|Tipo de evaluación|0|evaltype|0 - (predeterminado) Y/O;
2 - O.| |^|Nombre de etiqueta|1|tags.0.tag|Cualquier valor de cadena.
Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.
Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de problema| |^|Operador|0|tags.0.operator|0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.
Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.
Comportamiento del parámetro:
- obligatorio si se configuran Etiquetas de problema| |^|Valor de etiqueta|1|tags.0.value|Cualquier valor de cadena.
Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.
Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de problema| |Período de tiempo|<|1|time_period._reference|DASHBOARD._timeperiod - establece el selector de período de tiempo como fuente de datos;ABCDE._timeperiod - establece un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos.
Valor predeterminado: DASHBOARD._timeperiod
Alternativamente, puede establecer el período de tiempo solo en los parámetros Desde y Hasta.| |<|From|1|time_period.from|Cadena de tiempo válida en sintaxis de tiempo absoluta (AAAA-MM-DD hh:mm:ss) o relativa (now , now/d, now/w-1w, etc.).
Comportamiento de parámetros:
- compatible si Período de tiempo no está establecido| |^|To|1|time_period.to|Cadena de tiempo válida en sintaxis de tiempo absoluta (AAAA-MM-DD hh:mm:ss) o relativa (now , now/d, now/w-1w, etc.).
Comportamiento de parámetros:
- compatible si Período de tiempo no está establecido| |Límite de activación|<|0|show_lines|Los valores posibles oscilan entre 1 y 100.
Predeterminado: 10.|
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Iniciadores principales. Para obtener más información sobre cómo configurar un panel, consulte dashboard.create.
Configuración de un widget Iniciadores principales
Configure un widget Iniciadores principales que muestre los 5 iniciadores principales para el grupo de equipos "4" con el recuento de todos los problemas. para cada desencadenante. El widget muestra sólo iniciadores que tienen gravedades "Advertencia", "Promedio", "Alta" o "Desastre". y problemas que tienen una etiqueta con el nombre "alcance" que contiene valores "rendimiento" o "disponibilidad" o "capacidad".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "toptriggers",
"name": "Top triggers",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 0,
"name": "severities.0",
"value": 2
},
{
"type": 0,
"name": "severities.1",
"value": 3
},
{
"type": 0,
"name": "severities.2",
"value": 4
},
{
"type": 0,
"name": "severities.3",
"value": 5
},
{
"type": 1,
"name": "tags.0.tag",
"value": "alcance"
},
{
"type": 0,
"name": "tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "tags.0.value",
"value": "rendimiento"
},
{
"type": 1,
"name": "tags.1.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.1.operator",
"value": 0
},
{
"type": 1,
"name": "tags.1.value",
"value": "disponibilidad"
},
{
"type": 1,
"name": "tags.2.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.2.operator",
"value": 0
},
{
"type": 1,
"name": "tags.2.value",
"value": "capacidad"
},
{
"type": 0,
"name": "show_lines",
"value": 5
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: