Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de dashboard permiten configurar el widget Top triggers 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 dashboard. Esto permite a los usuarios modificar los 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 Top triggers, consulte el comportamiento de los parámetros que se describe en las tablas a continuación.
Los siguientes parámetros son compatibles con el widget Top triggers.
| Parámetro | type | name | value | |
|---|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - (por defecto) 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 | ID del grupo de hosts. Nota: Para configurar varios grupos de hosts, cree un objeto de campo de widget de 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. |
|
| Hosts | 3 | hostids.0 | ID del host. 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 Grupos de hosts debe no estar configurado en absoluto o configurado con al menos un grupo de hosts al que pertenezcan los hosts configurados. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Problema | 1 | problem | Nombre del evento del problema (no distingue mayúsculas/minúsculas, nombre completo o parte de él). | |
| Severidad | 0 | severities.0 | Severidades de trigger. 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Media; 4 - Alta; 5 - Desastre. Por defecto: vacío (todas habilitadas). Nota: Para configurar varios valores, cree un objeto de campo de widget de dashboard para cada valor con un número incrementado en el nombre de la propiedad. |
|
| Etiquetas de problema | ||||
| Tipo de evaluación | 0 | evaltype | 0 - (por defecto) 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 la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de problema |
|
| Operador | 0 | tags.0.operator | 0 - Contiene; 1 - 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 la etiqueta 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 la etiqueta en la lista de evaluación de etiquetas. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas de problema |
|
| Periodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establecer el selector de periodo de tiempo del dashboard como fuente de datos;ABCDE._timeperiod - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos.Por defecto: DASHBOARD._timeperiodAlternativamente, puede establecer el periodo de tiempo solo en los parámetros Desde y Hasta. |
|
| Desde | 1 | time_period.from | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - soportado si Periodo de tiempo no está configurado - obligatorio si se establece time_period.to |
|
| Hasta | 1 | time_period.to | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - soportado si Periodo de tiempo no está configurado - obligatorio si se establece time_period.from |
|
| Límite de triggers | 0 | show_lines | Los valores posibles van de 1 a 100. Por defecto: 10. |
|
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Principales disparadores. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configure un widget Top triggers que muestre los 5 triggers principales para el grupo de hosts "4" con el recuento de todos los problemas para cada trigger. El widget muestra solo los triggers que tienen las severidades "Warning", "Average", "High" o "Disaster", y los problemas que tienen una etiqueta con el nombre "scope" que contiene los valores "performance" o "availability", o "capacity".
{
"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": "scope"
},
{
"type": 0,
"name": "tags.0.operator",
"value": 0
},
{
"type": 1,
"name": "tags.0.value",
"value": "performance"
},
{
"type": 1,
"name": "tags.1.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.1.operator",
"value": 0
},
{
"type": 1,
"name": "tags.1.value",
"value": "availability"
},
{
"type": 1,
"name": "tags.2.tag",
"value": "scope"
},
{
"type": 0,
"name": "tags.2.operator",
"value": 0
},
{
"type": 1,
"name": "tags.2.value",
"value": "capacity"
},
{
"type": 0,
"name": "show_lines",
"value": 5
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: