Table of Contents
10 Prototipo de gráfico
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo de widget de panel permiten configurar el widget Prototipo de gráfico 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 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 Prototipo de gráfico, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Se admiten los siguientes parámetros para el widget Prototipo de gráfico.
| 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. |
|
| Origen | 0 | source_type | 2 - (por defecto) Prototipo de gráfico; 3 - Prototipo de gráfico simple. |
|
| Prototipo de gráfico | 7 | graphid.0 | ID de Prototipo de gráfico. Comportamiento del parámetro: - obligatorio si Origen está configurado en "Prototipo de gráfico" |
|
| Prototipo de elemento | 5 | itemid.0 | ID de Prototipo de elemento. Comportamiento del parámetro: - obligatorio si Origen está configurado en "Prototipo de gráfico simple" |
|
| Periodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de periodo de tiempo del panel como fuente de datos;ABCDE._timeperiod - establece un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos.Por defecto: DASHBOARD._timeperiodAlternativamente, 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 sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - admitido si Periodo de tiempo no está establecido |
|
| Hasta | 1 | time_period.to | Cadena de tiempo válida en formato absoluto (YYYY-MM-DD hh:mm:ss) o sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - admitido si Periodo de tiempo no está establecido |
|
| Mostrar leyenda | 0 | show_legend | 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
|
| Sobrescribir equipo | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los equipos;DASHBOARD._hostid - establece el selector de equipo del panel como fuente de datos para los equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Columnas | 0 | columns | Los valores posibles van de 1 a 24. Por defecto: 2. |
|
| Filas | 0 | rows | Los valores posibles van de 1 a 16. Por defecto: 1. |
|
| Referencia | 1 | reference | Cualquier valor de cadena que consista en 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del panel al que pertenece el widget.Comportamiento del parámetro: - obligatorio |
|
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Prototipo de gráfico. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
Configuración de un widget Prototipo de gráfico
Configure un widget Prototipo de gráfico que muestre una cuadrícula de 3 gráficos (3 columnas, 1 fila) creados a partir de una métrica prototipo (ID: "42316") mediante descubrimiento de bajo nivel.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mi panel",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "graphprototype",
"name": "Prototipo de gráfico",
"x": 0,
"y": 0,
"width": 48,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "source_type",
"value": 3
},
{
"type": 5,
"name": "itemid.0",
"value": 42316
},
{
"type": 0,
"name": "columns",
"value": 3
},
{
"type": 1,
"name": "reference",
"value": "OPQWX"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: