10 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 ._timeperiod

Alternativamente, 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".

Solicitud:

{
           "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:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también