10 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 descrito 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:
- obligatorio si Origen está configurado como "Gráfico prototipo"
Item prototipo 5 itemid.0 ID de Item prototipo.

Comportamiento del parámetro:
- obligatorio si Origen está configurado como "Gráfico simple prototipo"
Periodo de tiempo 1 time_period._reference DASHBOARD._timeperiod - establece el selector de periodo de tiempo del dashboard como fuente de datos;
ABCDE._timeperiod - establece un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos.

Por defecto: DASHBOARD._timeperiod

Alternativamente, 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 sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento del parámetro:
- compatible si Periodo de tiempo no está configurado
- obligatorio si se establece time_period.to
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:
- compatible si Periodo de tiempo no está configurado
- obligatorio si se establece time_period.from
Mostrar leyenda 0 show_legend 0 - Deshabilitado;
1 - (por defecto) Habilitado.
Sobrescribir host 1 override_hostid._reference ABCDE._hostid - establece un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos para hosts;
DASHBOARD._hostid - establece 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-24.

Por defecto: 2.
Filas 0 rows Los valores posibles van de 1-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:
- 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.

Solicitud:

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

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

Véase también