Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de panel permiten configurar el widget Gráfico (clásico) 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 panel. 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 Gráfico (clásico), consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Los siguientes parámetros son compatibles con el widget Gráfico (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 - (por defecto) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
Fuente | 0 | source_type | 0 - (por defecto) Gráfico; 1 - Gráfico simple. |
|
Gráfico | 6 | graphid.0 | ID de Gráfico. Comportamiento del parámetro: - obligatorio si Fuente está configurada como "Gráfico" |
|
Gráfico (Widget) | 1 | graphid._reference | En lugar del ID de Gráfico:ABCDE._graphid - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE ") como fuente de datos para gráficos.Comportamiento del parámetro: - obligatorio si Fuente está configurada como "Gráfico simple" y Gráfico no está configurado |
|
Métrica | 4 | itemid.0 | ID de Métrica. Comportamiento del parámetro: - obligatorio si Fuente está configurada como "Gráfico simple" y Métrica (Widget) no está configurada |
|
Métrica (Widget) | 1 | itemid._reference | En lugar del ID de Métrica:ABCDE._itemid - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE ") como fuente de datos para métricas.Comportamiento del parámetro: - obligatorio si Fuente está configurada como "Gráfico simple" y Métrica no está configurada |
|
Periodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establecer el selector de Periodo de tiempo como fuente de datos;ABCDE._timeperiod - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE ") como fuente de datos.Por defecto: DASHBOARD._timeperiod Alternativamente, puede establecer el periodo de tiempo solo en los parámetros Desde y Hasta. |
|
Desde | 1 | time_period.from | Cadena de tiempo válida en formato absoluto (YYYY-MM-DD hh:mm:ss ) o en sintaxis de tiempo relativo (now , now/d , now/w-1w , etc.).Comportamiento del parámetro: - compatible si Periodo de tiempo no está configurado |
|
Hasta | 1 | time_period.to | Cadena de tiempo válida en formato absoluto (YYYY-MM-DD hh:mm:ss ) o en sintaxis de tiempo relativo (now , now/d , now/w-1w , etc.).Comportamiento del parámetro: - compatible si Periodo de tiempo no está configurado |
|
Mostrar leyenda | 0 | show_legend | 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
|
Sobrescribir equipo | 1 | override_hostid._reference | ABCDE._hostid - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE ") como fuente de datos para equipos;DASHBOARD._hostid - establecer el selector de Equipo del dashboard como fuente de datos para equipos.Este parámetro no es compatible si se configura el widget en un dashboard de plantilla. |
|
Referencia | 1 | reference | Cualquier valor de cadena que consista en 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 |
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Gráfico (clásico). Para obtener más información sobre la configuración de un panel, 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: