Documentation
Table of Contents
9 Gráfico (clásico)
Descripción
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.
Parámetros
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 de gráfico. Comportamiento del parámetro: - obligatorio si Fuente está configurada en "Gráfico" |
|
| Graph (Widget) | 1 | graphid._reference | En lugar del ID de gráfico:ABCDE._graphid - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para gráficos.Comportamiento del parámetro: - obligatorio si Fuente está configurado en "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 en "Gráfico simple" |
|
| Métrica (Widget) | 1 | itemid._reference | En lugar del ID de métrica:ABCDE._itemid - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para las métricas.Comportamiento del parámetro: - obligatorio si Fuente está configurado en "Gráfico simple" y Métrica no está configurado |
|
| 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 ._timeperiodAlternativamente, 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 |
|
Ejemplos
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.
Configurar de un widget Gráfico (clásico)
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: