Documentation
Table of Contents
11 Prototipo de gráfico
Descripción
Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo de widget de dashboard 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 dashboard. 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 describe en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Gráfico prototipo.
| 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) Gráfico prototipo; 3 - Gráfico simple prototipo. |
|
| Gráfico prototipo | 7 | graphid.0 | ID de Gráfico prototipo. Comportamiento del parámetro: - requerido si Origen está configurado como "Gráfico prototipo" |
|
| Item prototipo | 5 | itemid.0 | ID de Item prototipo. Comportamiento del parámetro: - requerido si Origen está configurado como "Gráfico simple prototipo" |
|
| Período de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establecer el selector de Período 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._timeperiodAlternativamente, puede establecer el período de tiempo solo en los parámetros Desde y Hasta. |
|
| Desde | 1 | time_period.from | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - soportado si Período de tiempo no está configurado - requerido si time_period.to está configurado |
|
| Hasta | 1 | time_period.to | Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).Comportamiento del parámetro: - soportado si Período de tiempo no está configurado - requerido si time_period.from está configurado |
|
| Mostrar leyenda | 0 | show_legend | 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
|
| Sobrescribir host | 1 | override_hostid._reference | ABCDE._hostid - establecer un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos para hosts;DASHBOARD._hostid - establecer el selector de Host del dashboard como fuente de datos para hosts.Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| 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 dashboard 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