Documentation
Table of Contents
21 Mejores anfitriones
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
Estos par¨¢metros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget Top hosts 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 actualizando widgets incorrectamente. Para garantizar la creaci¨®n o actualizaci¨®n exitosa del widget Hosts principales, consulte los requisitos de par¨¢metros descritos en las tablas a continuaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
Los siguientes par¨¢metros son compatibles con el widget Equipos principales.
´¥±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç´¥&±ô³Ù;´¥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.| |Grupos de equipos|<|2|groupids|ID de grupo de equipos.
Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de tablero para cada grupo de equipos.| |Equipos|<|3|hostids|ID de equipo .
Nota: Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo . Para varios equipos, el par¨¢metro Grupos de equipos no debe estar configurado en absoluto o configurarse con al menos un grupo de equipos al que pertenecen los equipos configurados.| |Etiquetas de equipos (el n¨²mero en el nombre de la propiedad (por ejemplo, tags.tag.0) hace referencia al orden de las etiquetas en la lista de evaluaci¨®n de etiquetas)|<|<|<|<| |<|Tipo de evaluaci¨®n|0|evaltype|0 - (predeterminado) Y/O;
2 - O.| |^|Nombre de etiqueta|1|tags.tag.0|Cualquier valor de cadena.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Nombre de etiqueta requerido si se configuran Etiquetas.| |^|Operador|0|tags.operator.0|0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Operador requerido si se configuran Etiquetas.| |^|Valor de etiqueta|1|tags.value.0|Cualquier valor de cadena.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Valor de etiqueta requerido si se configuran Etiquetas.| |Columnas (ver m¨¢s abajo)|<|<|<|<| |Orden|<|0|order|2 - (predeterminado) N superior;
3 - N inferior.| |Ordenar columna|<|0|column|Valor num¨¦rico de la columna de las columnas configuradas.| |Recuento de hosts|<|0|count|Los valores v¨¢lidos oscilan entre 1 y 100.
Predeterminado: 10.|
Columnas
Las columnas tienen par¨¢metros comunes y par¨¢metros adicionales dependiendo de la configuraci¨®n del par¨¢metro Data.
Para todos los par¨¢metros relacionados con columnas, el n¨²mero en el nombre de la propiedad (por ejemplo, columnas.nombre.0) 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|columnas.nombre.0|Cualquier valor de cadena.| |Datos< br>(obligatorio)|0|columns.data.0|1 - Valor del elemento;
2 - Nombre del host;
3 - Texto.| |Color base
(obligatorio) |1|columns.base_color.0|C¨®digo de color hexadecimal (por ejemplo, FF0000).|
Valor de la m¨¦trica
Los siguientes par¨¢metros son compatibles si Data se establece en "Valor de la m¨¦trica".
El primer n¨²mero en el nombre de la propiedad Thresholds (por ejemplo, columnsthresholds.color.0.0) hace referencia a la columna para la cual se configuran los umbrales, mientras que el segundo n¨²mero hace referencia al lugar del umbral en una lista, ordenada en orden ascendente. Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenar¨¢n en orden ascendente despu¨¦s de actualizar la configuraci¨®n del widget en la interfaz de Áú»¢¶Ä²©. (por ejemplo, "umbral.umbral.0":"5" ¡ú "umbral.umbral.0":"1"; "umbral.umbral.1":"1" ¡ú "umbral.umbral. 1": "5").
´¥±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç´¥&±ô³Ù;´¥tipo|nombre|valor| |-|--------|--|--------|-------------------------- -----| |M?etrica|<|1 |columns.item.0|Nombre v¨¢lido de m¨¦trica .| |Timeshift
(obligatorio)|<|1|columns.timeshift.0|Valor num¨¦rico o de cadena de tiempo v¨¢lido (por ejemplo, 3600 o 1h).
Puedes usar sufijos de tiempo. Se permiten valores negativos.| |Funci¨®n de agregaci¨®n|<|0|columns.aggregate_function.0|0 - (predeterminado) ninguno;
1 - min;
2 - max;
3 - promedio;
4 - contar;
5 - suma;
6 - primero;
7 - ¨²ltimo.| |Intervalo de agregaci¨®n|<|1|columns.aggregate_interval.0|Cadena de tiempo v¨¢lida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Intervalo de agregaci¨®n no disponible si Funci¨®n de agregaci¨®n est¨¢ configurada en ninguna.
Predeterminado: 1h.| |Pantalla|<|0|columns.display.0|1 - (predeterminado) Tal cual;
2 - Barra;
3 - Indicadores.| |Min|<|1|columns.min.0|Cualquier valor num¨¦rico.
El par¨¢metro Min no est¨¢ disponible si Display est¨¢ configurado en "Tal cual".| |Max|<|1|columns.max.0|Cualquier valor num¨¦rico.
El par¨¢metro Max no est¨¢ disponible si Display est¨¢ configurado en "Tal cual".| |Datos del historial|<|0|columns.history.0|1 - (predeterminado) ´¡³Ü³Ù´Ç³¾¨¢³Ù¾±³¦´Ç;
2 - Historial;
3 - Tendencias.| |Umbrales|<|<|<|<| |<|Color|1|columnsthresholds.color.0.0|C¨®digo de color hexadecimal (por ejemplo, FF0000).
Predeterminado: "" (vac¨ªo).| |^|Umbral|1|columnasumbrales.threshold.0.0|Cualquier valor de cadena.|
Texto
Los siguientes par¨¢metros son compatibles si Data est¨¢ configurado en "Text".
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | tipo | nombre | valor |
|---|---|---|---|
| Text | 1 | columns.text.0 | Cualquier valor de cadena, incluidas las macros. Macros admitidas: {HOST.*}, {INVENTORY.*}. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç Text requerido si Data est¨¢ configurado en "Text". |
Ejemplos
Los siguientes ejemplos pretenden describir ¨²nicamente la configuraci¨®n de los objetos de campo del widget del tablero para el widget Equipos principales. Para obtener m¨¢s informaci¨®n sobre c¨®mo configurar un tablero, consulte dashboard.create.
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô de un widget Host principales
Configure un widget Hosts principales que muestre los equipos principales por utilizaci¨®n de CPU en el grupo de equipos "4". Adem¨¢s, configure las siguientes columnas personalizadas: "Nombre de equipo", "Utilizaci¨®n", "Promedio de 1 m", "Promedio de 5 m", "Promedio de 15 m", "Procesos".
Solicitud:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 12,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids",
"value": 4
},
{
"type": 1,
"name": "columns.name.0",
"value": ""
},
{
"type": 0,
"name": "columns.data.0",
"value": 2
},
{
"type": 1,
"name": "columns.base_color.0",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.timeshift.0",
"value": ""
},
{
"type": 1,
"name": "columns.name.1",
"value": "Utilization"
},
{
"type": 0,
"name": "columns.data.1",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.1",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.timeshift.1",
"value": ""
},
{
"type": 1,
"name": "columns.item.1",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.display.1",
"value": 3
},
{
"type": 1,
"name": "columns.min.1",
"value": "0"
},
{
"type": 1,
"name": "columns.max.1",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.color.1.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.color.1.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.color.1.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.threshold.1.2",
"value": "90"
},
{
"type": 1,
"name": "columns.name.2",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.data.2",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.2",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.timeshift.2",
"value": ""
},
{
"type": 1,
"name": "columns.item.2",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.name.3",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.data.3",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.3",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.timeshift.3",
"value": ""
},
{
"type": 1,
"name": "columns.item.3",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.name.4",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.data.4",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.4",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.timeshift.4",
"value": ""
},
{
"type": 1,
"name": "columns.item.4",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.name.5",
"value": "Processes"
},
{
"type": 0,
"name": "columns.data.5",
"value": 1
},
{
"type": 1,
"name": "columns.base_color.5",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.timeshift.5",
"value": ""
},
{
"type": 1,
"name": "columns.item.5",
"value": "Number of processes"
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta: