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 Principales triggers.

Parámetro type name value
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 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 al configurar el widget en un dashboard de template.
Hosts 3 hostids.0 ID del host.

Nota: Para configurar varios hosts, cree un objeto de campo del widget del 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 o estar configurado con al menos un grupo de hosts al que pertenezcan los hosts configurados.

Este parámetro no es compatible al configurar el widget en un dashboard de template.
Problema 1 problem Nombre del evento del problema (no distingue entre mayúsculas y minúsculas, nombre completo o parte del nombre).
Gravedad 0 severities.0 Gravedades de los triggers.

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.
Etiquetas del problema
Tipo de evaluación 0 evaltype 0 - (predeterminado) Y/O;
2 - O.
Nombre de la etiqueta 1 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 al configurar Etiquetas del problema
Operador 0 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 al configurar Etiquetas del problema
Valor de la etiqueta 1 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 al configurar Etiquetas del 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 Referencia establecido en "ABCDE") como fuente de datos.

Predeterminado: DASHBOARD._timeperiod

Como alternativa, puede establecer el período de tiempo únicamente en los parámetros Desde y Hasta.
Desde 1 time_period.from Cadena de tiempo válida en sintaxis de tiempo absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento del parámetro:
- compatible si no se establece Período de tiempo
- obligatorio si se establece time_period.to
Hasta 1 time_period.to Cadena de tiempo válida en sintaxis de tiempo absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento del parámetro:
- compatible si no se establece Período de tiempo
- obligatorio si se establece time_period.from
Límite de triggers 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".

Solicitud:

{
    "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
}

Véase también