16 Historial de métricas
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de dashboard permiten configurar el widget Histórico de item 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 Histórico de item, 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 Historial de item.
| Parámetro | 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 (consulte abajo) | |||
| Mostrar líneas | 0 | show_lines | El rango de valores posibles es de 1 a 100. Predeterminado: 25. |
| Anular host | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (con su parámetro Referencia establecido en "ABCDE") como fuente de datos para los hosts;DASHBOARD._hostid - establece el selector de Host del dashboard como fuente de datos para los hosts.Este parámetro no es compatible al configurar el widget en un dashboard de template. |
| Configuración avanzada (consulte abajo) | |||
| Referencia | 1 | reference | Cualquier valor de cadena compuesto por 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del dashboard al que pertenece el widget.Comportamiento del parámetro: - obligatorio |
Columnas
Las columnas tienen parámetros comunes y parámetros adicionales dependiendo de la configuración del parámetro Métrica.
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 se configura el parámetro.
Los siguientes parámetros son compatibles con todas las columnas.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Nombre | 1 | columns.0.name | Cualquier valor de cadena. Comportamiento del parámetro: - obligatorio |
| Métrica | 4 | columns.0.itemid | ID de la métrica. Al configurar el widget en un panel de plantilla, solo deben establecerse las métricas configuradas en la plantilla. Comportamiento del parámetro: - obligatorio |
| Color base | 1 | columns.0.base_color | Código de color hexadecimal (por ejemplo, FF0000).Por defecto: "" (vacío). |
Se admiten los siguientes parámetros de columna si la Métrica configurada es una métrica de tipo numérico.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Mostrar | 0 | columns.0.display | 1 - (por defecto) Como está; 2 - Barra; 3 - Indicadores. |
|
| Mín | 1 | columns.0.min | Cualquier valor numérico. Comportamiento del parámetro: - admitido si Mostrar está configurado como "Barra" o "Indicadores" |
|
| Máx | 1 | columns.0.max | Cualquier valor numérico. Comportamiento del parámetro: - admitido si Mostrar está configurado como "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 históricos | 0 | columns.0.history | 0 - (por defecto) Automático; 1 - Historial; 2 - Tendencias. |
|
Los siguientes parámetros de columna son compatibles si el Item configurado es un item de tipo carácter, texto o registro.
| Parámetro | type | name | value | |
|---|---|---|---|---|
| Resaltados | ||||
| 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. | |
| Visualización | 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 van de 1 a 500. Predeterminado: 100. Comportamiento del parámetro: - compatible si Visualización está establecido en "Una sola línea" |
|
| Usar fuente monoespaciada | 0 | columns.0.monospace_font | 0 - (predeterminado) Usar la fuente predeterminada; 1 - Usar fuente monoespaciada. |
|
| Mostrar hora local | 0 | columns.0.local_time | 0 - (predeterminado) Mostrar la marca de tiempo; 1 - Mostrar la hora local. Comportamiento del parámetro: - compatible si Item está establecido en un item de tipo registro y Mostrar marca de tiempo está establecido en "Habilitado" |
|
Se admiten los siguientes parámetros de columna si la Métrica configurada es de tipo binario.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Mostrar miniatura | 1 | columns.0.show_thumbnail | 0 - (por defecto) Deshabilitado; 1 - Habilitado. |
Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles con el widget Item history.
| Parameter | type | name | value | |
|---|---|---|---|---|
| New values | 0 | sortorder | 0 - (predeterminado) Arriba; 1 - Abajo. |
|
| Show timestamp | 0 | show_timestamp | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Show column header | 0 | show_column_header | 0 - Desactivado; 1 - Horizontal; 2 - (predeterminado) Vertical. |
|
| 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 relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - compatible si no se establece Time period - obligatorio si se establece time_period.to |
|
| To | 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: - compatible si no se establece Time period - obligatorio si se establece time_period.from |
|
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Histórico de métricas.
Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Historial de métricas
Configure un widget Historial de métricas que muestre los últimos datos de dos métricas numéricas "42269" y "42270". Además, configure las columnas de métricas para que se muestren verticalmente, con los nombres de las columnas mostrados horizontalmente; limite la visualización a 15 líneas de datos e incluya una columna de marca de tiempo por separado.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mi panel",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemhistory",
"name": "Historial de métricas",
"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": "Utilización de CPU"
},
{
"type": "4",
"name": "columns.0.itemid",
"value": "42269"
},
{
"type": "1",
"name": "columns.1.name",
"value": "Utilización de memoria"
},
{
"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
}