29 Principales items

Descripción

Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo de widget de dashboard permiten configurar el widget Top items 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 items, consulte el comportamiento de los parámetros que se describe en las tablas a continuación.

Parámetros

Se admiten los siguientes parámetros para el widget Elementos principales.

Parámetro tipo nombre valor
Intervalo de actualización 0 rf_rate 0 - Sin actualización;
10 - 10 segundos;
30 - 30 segundos;
60 - (por defecto) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.
Grupos de equipos 2 groupids.0 ID de Grupo de equipos.

Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de panel para cada grupo de equipos con un número incrementado en el nombre de la propiedad.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Grupos de equipos (Widget) 1 groupids._reference En lugar del ID de Grupo de equipos:
ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los grupos de equipos.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Equipos 3 hostids.0 ID de Equipo.

Nota: Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo con un número incrementado en el nombre de la propiedad. Para varios equipos, el parámetro Grupos de equipos debe no estar configurado en absoluto o configurado con al menos un grupo de equipos al que pertenezcan los equipos configurados.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Equipos (Widget/Panel) 1 hostids._reference En lugar del ID de Equipo:
DASHBOARD.hostids - establezca el selector de equipos del panel como fuente de datos para los equipos;
ABCDE._hostids - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los equipos.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Etiquetas de equipos
Tipo de evaluación 0 host_tags_evaltype 0 - (por defecto) Y/O;
2 - O.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Nombre de etiqueta 1 host_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 equipos

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Operador 0 host_tags.0.operator 0 - Contiene;
1 - Igual a;
2 - No contiene;
3 - No 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.

Comportamiento del parámetro:
- obligatorio si se configuran Etiquetas de equipos

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Valor de etiqueta 1 host_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 equipos

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Disposición 0 layout 0 - (por defecto) Horizontal;
1 - Vertical.
Mostrar problemas 0 show_problems 0 - Todos;
1 - (por defecto) No suprimidos;
2 - Ninguno.
Elementos (ver abajo)

Configuración avanzada

Los siguientes parámetros de configuración avanzada son compatibles con el widget Top items.

Parameter type name value
Orden de los host
Ordenar por 0 host_ordering_order_by 0 - (predeterminado) Nombre del host;
3 - Valor del item.
Patrones de item 1 host_ordering_item.0 Nombre o patrón del item (por ejemplo, "*: Number of processed *values per second").

Nota: Para configurar varios patrones de item, cree un objeto de campo del widget del dashboard para cada patrón de item, con un número incrementado en el nombre de la propiedad.

Al configurar el widget en un dashboard de template, solo deben establecerse los patrones de los items configurados en el template.

Comportamiento del parámetro:
- obligatorio si Ordenar por está establecido en "Valor del item"
Orden 0 host_ordering_order 2 - (predeterminado) Primeros N;
3 - Últimos N.
Límite 0 host_ordering_limit Los valores posibles van de 1 a 100.

Predeterminado: 10.
Orden de los items
Ordenar por 0 item_ordering_order_by 1 - Host;
2 - Nombre del item;
3 - (predeterminado) Valor del item.
Patrones de host 1 item_ordering_host.0 Nombre o patrón del host.

Nota: Para configurar varios patrones de host, 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.

Comportamiento del parámetro:
- obligatorio si Ordenar por está establecido en "Host"
Orden 0 item_ordering_order 2 - (predeterminado) Primeros N;
3 - Últimos N.
Límite 0 item_ordering_limit Los valores posibles van de 1 a 100.

Predeterminado: 10.

Columnas

El primer número del nombre de la propiedad (por ejemplo, columns.0.items.0, columns.0.item_tags_evaltype) representa la columna correspondiente, mientras que el segundo número, si está presente, representa la entidad configurada (por ejemplo, el patrón de item o la etiqueta).

Parámetro type name value
Patrones de item 1 columns.0.items.0 Nombre o patrón de item (por ejemplo, "*: Número de valores * procesados por segundo").

Nota: Para configurar varios patrones de item, cree un objeto de campo de widget de dashboard para cada patrón de item, incrementando el segundo número del nombre de la propiedad.

Al configurar el widget en un dashboard de template, solo deben establecerse los patrones de los item configurados en el template.

Comportamiento del parámetro:
- obligatorio
Etiquetas de item
Tipo de evaluación 0 columns.0.item_tags_evaltype 0 - (predeterminado) Y/O;
2 - O.
Nombre de la etiqueta 1 columns.0.item_tags.0.tag Cualquier valor de cadena.

Nota: El segundo 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 configuran Etiquetas de item
Operador 0 columns.0.item_tags.0.operator 0 - Contiene;
1 - Es igual a;
2 - No contiene;
3 - No es igual a;
4 - Existe;
5 - No existe.

Nota: El segundo 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 configuran Etiquetas de item
Valor de la etiqueta 1 columns.0.item_tags.0.value Cualquier valor de cadena.

Nota: El segundo 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 configuran Etiquetas de item
Color base 1 columns.0.base_color Código de color hexadecimal (por ejemplo, FF0000).
Mostrar valor como 0 columns.0.display_value_as 1 - (predeterminado) Numérico;
2 - Texto.
Mostrar 0 columns.0.display 1 - (predeterminado) Tal cual;
2 - Barra;
3 - Indicadores;
6 - Minigráfico.
Mín. 1 columns.0.min Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G").

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico" y Mostrar está establecido en "Barra" o "Indicadores"
Máx. 1 columns.0.max Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G").

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico" y Mostrar está establecido en "Barra" o "Indicadores"
Minigráfico
Ancho 0 columns.0.sparkline.width Los valores posibles van de 0 a 10.

Predeterminado: 1.

Comportamiento del parámetro:
- compatible si Mostrar está establecido en "Minigráfico"
Relleno 0 columns.0.sparkline.fill Los valores posibles van de 0 a 10.

Predeterminado: 3.

Comportamiento del parámetro:
- compatible si Mostrar está establecido en "Minigráfico"
Color 1 columns.0.sparkline.color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: 42A5F5.

Comportamiento del parámetro:
- compatible si Mostrar está establecido en "Minigráfico"
Período de tiempo 1 columns.0.sparkline.time_period._reference DASHBOARD._timeperiod - establece el selector de período de tiempo del dashboard como fuente de datos;
ABCDE._timeperiod - establece un widget compatible (con su parámetro reference igual a 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.

Comportamiento del parámetro:
- compatible si Mostrar está establecido en "Minigráfico"
Desde 1 columns.0.sparkline.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:
- compatible si Mostrar está establecido en "Minigráfico"
- obligatorio si columns.0.sparkline.time_period.to está establecido
Hasta 1 columns.0.sparkline.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:
- compatible si Mostrar está establecido en "Minigráfico"
- obligatorio si columns.0.sparkline.time_period.from está establecido
Datos históricos 0 columns.0.sparkline.history 0 - (predeterminado) Automático;
1 - Historial;
2 - Tendencias.

Comportamiento del parámetro:
- compatible si Mostrar está establecido en "Minigráfico"
Umbrales
Color 1 columns.0.thresholds.0.color Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico"
Umbral 1 columns.0.thresholds.0.threshold Cualquier valor numérico. Se admiten sufijos (por ejemplo, "1d", "2w", "4K", "8G").

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico"
Resaltados
Resaltado 1 columns.0.highlights.0.color Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Texto"
Umbral 1 columns.0.highlights.0.pattern Cualquier expresión regular.

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Texto"
Posiciones decimales 0 columns.0.decimal_places Los valores posibles van de 0 a 10.

Predeterminado: 2.
Configuración avanzada
Función de agregación 0 columns.0.aggregate_function Si Mostrar valor como está establecido en "Numérico":
0 - (predeterminado) no se utiliza;
1 - mín.;
2 - máx.;
3 - promedio;
4 - recuento;
5 - suma;
6 - primero;
7 - último.

Si Mostrar valor como está establecido en "Texto":
0 - (predeterminado) no se utiliza;
4 - recuento;
6 - primero;
7 - último.
Período de tiempo 1 columns.0.time_period._reference DASHBOARD._timeperiod - establece el selector de período de tiempo del dashboard como fuente de datos;
ABCDE._timeperiod - establece un widget compatible (con su parámetro reference igual a 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.

Comportamiento del parámetro:
- compatible si Función de agregación está establecida en "mín.", "máx.", "promedio", "recuento", "suma", "primero" o "último"
Desde 1 columns.0.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:
- compatible si Período de tiempo no está establecido y Función de agregación está establecida en "mín.", "máx.", "promedio", "recuento", "suma", "primero" o "último"
- obligatorio si columns.0.time_period.to está establecido
Hasta 1 columns.0.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:
- compatible si Período de tiempo no está establecido y Función de agregación está establecida en "mín.", "máx.", "promedio", "recuento", "suma", "primero" o "último"
- obligatorio si columns.0.time_period.from está establecido
Datos históricos 0 columns.0.history 0 - (predeterminado) Automático;
1 - Historial;
2 - Tendencias.

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico"
Agregado 0 columns.0.aggregate_columns 0 - (predeterminado) Cada item
1 - Combinado.

Comportamiento del parámetro:
- compatible si Mostrar valor como está establecido en "Numérico" y Mostrar está establecido en "Tal cual", "Barra" o "Indicadores".
Función de agregación combinada 0 columns.0.column_aggregate_function 1 - mín.;
2 - máx.;
3 - promedio;
4 - recuento;
5 - suma (predeterminado).

Comportamiento del parámetro:
- obligatorio si se configura Agregado.
Nombre de columna combinada 1 columns.0.combined_column_name Cualquier valor de cadena.

Comportamiento del parámetro:
- obligatorio si se configura Agregado.

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 métricas. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.

Configuración de un widget Principales métricas

Configure un widget Principales métricas que muestre datos para el equipo "10084" y solo para las métricas para las cuales la etiqueta con el nombre "component" contiene el valor "cpu". Además, muestre los datos con los equipos ubicados en la parte superior y utilice una barra de indicador de color para la representación de la celda.

Petición:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "topitems",
                        "name": "Top items",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "columns.0.items.0",
                                "value": "*"
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.tag",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.item_tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.value",
                                "value": "cpu"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.display",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "layout",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "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