Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del tablero permiten configurar el widget Gráfico (clásico) 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 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 Graph (clásico), consulte el comportamiento de los parámetros descrito en las tablas siguientes.
Los siguientes parámetros son compatibles con el widget Graph (clásico).
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. |
|
Fuente | 0 | source_type | 0 - (predeterminado) Gráfico; 1 - Gráfico simple. |
|
Gráfico | 6 | graphid.0 | ID del gráfico. Comportamiento del parámetro: - obligatorio si Fuente está configurada en "Gráfico" |
|
Métrica | 4 | itemid.0 | ID de métrica. Comportamiento del parámetro: - obligatorio si Fuente está configurada en "Gráfico simple" |
|
Periodo de tiempo | ||||
Período de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de período de tiempo como fuente de datos.ABCDE._timeperiod - establecer un widget compatible (Gráfico, Gráfico (clásico) o Prototipo de gráfico con su parámetro Referencia establecido en "ABCDE ") como fuente de datos.Predeterminado: DASHBOARD ._timeperiod Alternativamente, puede establecer el período de tiempo solo en los parámetros Desde y Hasta. |
|
From | 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 |
|
To | 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 |
|
Mostrar leyenda | 0 | show_legend | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
|
Remplazar equipo | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (Host navigator con su parámetro Reference establecido en "ABCDE ") como fuente de datos que contiene el equipo .DASHBOARD._hostid : configura el Selector de equipo del tablero como la fuente de datos que contiene el equipo.Esto El parámetro no se admite si se configura el widget en un panel de plantilla. |
|
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 |
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Graph (clásico). Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create
.
Configure un widget Gráfico (clásico) que muestre un gráfico simple para la métrica "42269".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "graph",
"name": "Graph (classic)",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "source_type",
"value": 1
},
{
"type": 4,
"name": "itemid.0",
"value": 42269
},
{
"type": 1,
"name": "reference",
"value": "RSTUV"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
Respuesta: