29 Principales triggers
Descripción
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.
Parámetros
Los siguientes parámetros son compatibles con el widget Top triggers.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Host groups | 2 | groupids.0 | ID del Host group. Nota: Para configurar varios host groups, cree un objeto de campo de widget del dashboard para cada host group con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Hosts | 3 | hostids.0 | ID del Host. Nota: Para configurar varios hosts, cree un objeto de campo de widget del dashboard para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro Host groups debe no configurarse en absoluto o configurarse con al menos un host group al que pertenezcan los hosts configurados. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Problem | 1 | problem | Nombre del evento de problema (sin distinción entre mayúsculas y minúsculas, nombre completo o parte de él). | |
| Severity | 0 | severities.0 | Severidades de trigger. 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 de widget del dashboard para cada valor con un número incrementado en el nombre de la propiedad. |
|
| Problem tags | ||||
| Evaluation type | 0 | evaltype | 0 - (predeterminado) And/Or; 2 - Or. |
|
| Tag name | 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. Parameter behavior: - required si se configuran Problem tags |
|
| Operator | 0 | tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No es igual a; 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. Parameter behavior: - required si se configuran Problem tags |
|
| Tag value | 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. Parameter behavior: - required si se configuran Problem tags |
|
| Time period | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector Time period como fuente de datos;ABCDE._timeperiod - establece un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos.Predeterminado: DASHBOARD._timeperiodComo alternativa, puede establecer el período de tiempo solo en los parámetros From y To. |
|
| From | 1 | time_period.from | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o de tiempo relativa (now, now/d, now/w-1w, etc.).Parameter behavior: - supported si Time period no está configurado - required si time_period.to está configurado |
|
| To | 1 | time_period.to | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o de tiempo relativa (now, now/d, now/w-1w, etc.).Parameter behavior: - supported si Time period no está configurado - required si time_period.from está configurado |
|
| Trigger limit | 0 | show_lines | Los valores posibles van de 1 a 100. Predeterminado: 10. |
|
Ejemplos
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.
Configuración de un widget Top triggers
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:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}