Documentation
Table of Contents
11 Prototipo de gráfico
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 Prototipo de gráfico 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 Prototipo de gráfico, consulte el comportamiento de los parámetros que se describen en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con 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 - (predeterminado) 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - 15 minutos. |
|
| Origen | 0 | source_type | 2 - (predeterminado) 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á configurada en "Prototipo de gráfico" |
|
| Prototipo de métrica | 5 | itemid.0 | ID de prototipo de métrica. Comportamiento del parámetro: - obligatorio si Origen está configurada en "Prototipo de gráfico simple" |
|
| Período de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de período de tiempo como fuente de datos;ABCDE._timeperiod - establece un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos.Valor predeterminado: DASHBOARD._timeperiodAlternativamente, puede configurar el período de tiempo solo en los parámetros From y To. |
|
| 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. |
|
| Reemplazar equipo | 1 | override_hostid._reference | ABCDE._hostid - establece un widget compatible (con su parámetro Reference establezca en "ABCDE") como fuente de datos para los equipos;DASHBOARD._hostid - configure el panel selector de equipos como la fuente de datos para los equipos.Este parámetro no se admite si se configura el widget en una plantilla de tablero. |
|
| Columnas | 0 | columnas | Los valores posibles oscilan entre 1 y 24. Valor predeterminado: 2. |
|
| Filas | 0 | filas | Los valores posibles oscilan entre 1 y 16. Valor predeterminado: 1. |
|
| 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 Prototipo de gráfico. Para obtener más información sobre cómo configurar un tablero, 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 un prototipo de métrica (ID: "42316") mediante descubrimiento de bajo nivel.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "graphprototype",
"name": "Graph prototype",
"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:
Ver también
-Campo de widget de dashboard -dashboard.create -dashboard.update