Áú»¢¶Ä²©

Esta es una traducci¨®n de la p¨¢gina de documentaci¨®n original en espa?ol. Ay¨²danos a mejorarla.

15 Historial de ³¾¨¦³Ù°ù¾±³¦²¹

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô

Estos par¨¢metros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹ 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 tablero. 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 Historial de ³¾¨¦³Ù°ù¾±³¦²¹, consulte el comportamiento de los par¨¢metros descrito en las tablas siguientes.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ

Los siguientes par¨¢metros son compatibles con el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Intervalo de actualizaci¨®n 0 rf_rate 0 - Sin actualizaci¨®n;
10 - 10 segundos;
30 - 30 segundos;
60 - (predeterminado) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.
Dise?o 0 layout 0 - (predeterminado) Horizontal;
1 - Vertical.
Columnas (ver abajo)
Mostrar l¨ªneas 0 show_lines Los valores posibles oscilan entre 1 y 100.

Predeterminado: 25.
Reemplazar equipo 1 override_hostid._reference ABCDE._hostid - establece un widget compatible (con su par¨¢metro Reference establecido en "ABCDE") como fuente de datos para los equipos;
DASHBOARD._hostid - establece el tablero selector de equipo como fuente de datos para los equipos.

Este par¨¢metro no se admite si se configura el widget en un tablero de una plantilla.
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada (ver abajo)
Referencia 1 referencia Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser ¨²nico dentro del tablero al que pertenece el widget.

Comportamiento del par¨¢metro:
- requerido

Columnas

Las columnas tienen par¨¢metros comunes y par¨¢metros adicionales seg¨²n la configuraci¨®n del par¨¢metro Item.

Para todos los par¨¢metros relacionados con columnas, el n¨²mero en el nombre de la propiedad (por ejemplo, columns.0.name) hace referencia a una columna para la cual est¨¢ configurado el par¨¢metro.

Los siguientes par¨¢metros son compatibles con todas las columnas.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Nombre 1 columns.0.name Cualquier valor de cadena.

Comportamiento del par¨¢metro:
- obligatorio
²Ñ¨¦³Ù°ù¾±³¦²¹ 4 columns.0.itemid ID de ³¾¨¦³Ù°ù¾±³¦²¹.

Al configurar el widget en una plantilla de tablero, solo se deben configurar las ³¾¨¦³Ù°ù¾±³¦²¹s configuradas en la plantilla.

Comportamiento de par¨¢metros:
- obligatorio
Color base 1 columns.0.base_color C¨®digo de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (±¹²¹³¦¨ª´Ç).

Los siguientes par¨¢metros de columna son compatibles si el Item configurado es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo num¨¦rico.

|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Pantalla|<|0|columns.0.display|1 - (predeterminado) Tal cual;
2 - Barra;
3 - Indicadores.| |Min|<|1|columns.0.min|Cualquier valor num¨¦rico.

Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Barra" o "Indicadores"| |Max|<|1|columns.0.max|Cualquier valor num¨¦rico.

Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Barra" o "Indicadores"| |Umbrales|<|<|<|<| |<|Color|1|columns.0.thresholds.0.color|C¨®digo de color hexadecimal (por ejemplo, FF0000).| |^|Umbral|1|columns.0.thresholds.0.threshold|Cualquier valor num¨¦rico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G").| |Datos del historial|<|0|columns.0.history|0 - (predeterminado) ´¡³Ü³Ù´Ç³¾¨¢³Ù¾±³¦´Ç;
1 - Historial;
2 - Tendencias.|

Los siguientes par¨¢metros de columna son compatibles si la ²Ñ¨¦³Ù°ù¾±³¦²¹ configurada es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo car¨¢cter, texto o registro.

|±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç|<|tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |Destacados|<|<|<|<| |<|Resaltado|1|columns.0.highlights.0.color|C¨®digo de color hexadecimal (por ejemplo, FF0000).| |^|Umbral|1|columns.0.highlights.0.pattern|Cualquier expresi¨®n regular.| |Pantalla|<|0|columns.0.display|1 - (predeterminado) Tal cual;
4 - HTML;
5 - Una sola l¨ªnea.| |<|Una sola l¨ªnea|0|columns.0.max_length|Los valores posibles oscilan entre 1 y 500.

Predeterminado: 100.

Comportamiento del par¨¢metro:
- compatible si Pantalla est¨¢ configurada en "Una sola l¨ªnea"| |Usar fuente monoespaciada|<|0|columns.0.monospace_font|0 - (predeterminado) Usar fuente predeterminada;
1 - Usar fuente monoespaciada.| |Mostrar hora local|<|0|columns.0.local_time|0 - (predeterminado) Mostrar marca de tiempo;
1 - Mostrar hora local.

Comportamiento de par¨¢metros:
- compatible si Item est¨¢ configurado como ³¾¨¦³Ù°ù¾±³¦²¹ de tipo de registro y Mostrar marca de tiempo est¨¢ configurado como "Habilitado"|

Los siguientes par¨¢metros de columna son compatibles si el Item configurado es una ³¾¨¦³Ù°ù¾±³¦²¹ de tipo binario.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Mostrar miniatura 1 columns.0.show_thumbnail 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô avanzada

Los siguientes par¨¢metros de configuraci¨®n avanzada son compatibles con el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç tipo nombre valor
Nuevos valores 0 sortorder 0 - (predeterminado) Arriba;
1 - Abajo.
Mostrar marca de tiempo 0 show_timestamp 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Mostrar encabezado de columna 0 show_column_header 0 - Desactivado;
1 - Horizontal;
2 - (predeterminado) Vertical.
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.
Desde 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
Hasta 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

Ejemplos

Los siguientes ejemplos pretenden describir ¨²nicamente la configuraci¨®n de los objetos de campo del widget del tablero para el widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹. Para obtener m¨¢s informaci¨®n sobre c¨®mo configurar un tablero, consulte dashboard.create.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de un widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹

Configure un widget Historial de ³¾¨¦³Ù°ù¾±³¦²¹ que muestre los datos m¨¢s recientes para dos ³¾¨¦³Ù°ù¾±³¦²¹s num¨¦ricas "42269" y "42270". Adem¨¢s, configure las columnas de las ³¾¨¦³Ù°ù¾±³¦²¹s para que se muestren verticalmente y los nombres de las columnas se muestren horizontalmente; limite la visualizaci¨®n a 15 l¨ªneas de datos e incluya una columna de marca de tiempo separada.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "itemhistory",
                               "name": "Item history",
                               "x": "0",
                               "y": "0",
                               "width": "18",
                               "height": "6",
                               "view_mode": "0",
                               "fields": [
                                   {
                                       "type": "0",
                                       "name": "layout",
                                       "value": "1"
                                   },
                                   {
                                       "type": "1",
                                       "name": "columns.0.name",
                                       "value": "CPU utilization"
                                   },
                                   {
                                       "type": "4",
                                       "name": "columns.0.itemid",
                                       "value": "42269"
                                   },
                                   {
                                       "type": "1",
                                       "name": "columns.1.name",
                                       "value": "Memory utilization"
                                   },
                                   {
                                       "type": "4",
                                       "name": "columns.1.itemid",
                                       "value": "42270"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_lines",
                                       "value": "15"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_timestamp",
                                       "value": "1"
                                   },
                                   {
                                       "type": "0",
                                       "name": "show_column_header",
                                       "value": "1"
                                   },
                                   {
                                       "type": "1",
                                       "name": "reference",
                                       "value": "KIVKD"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver tambi¨¦n