Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

15 Tarjeta de métrica

Descripción

Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de panel permiten configurar el widget Tarjeta de métrica 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 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 Tarjeta de métrica, 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 Tarjeta de métrica.

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.
Métrica 4 itemid.0 ID de la Métrica.

Comportamiento del parámetro:
- obligatorio si Métrica (Widget) no está establecido
Métrica (Widget) 1 itemid._reference En lugar del ID de la Métrica:
ABCDE._itemid - establecer un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para la métrica.

Comportamiento del parámetro:
- obligatorio si Métrica no está establecido
Mostrar 0 sections.0 0 - Descripción;
1 - Texto de error;
2 - Métricas;
3 - Últimos datos;
4 - Tipo de información;
5 - Disparadores;
6 - Interfaz del equipo;
7 - Tipo;
8 - Inventario del equipo;
9 - Etiquetas.

Nota: El número en el nombre de la propiedad hace referencia al orden de la sección en la lista de secciones. Para configurar varias secciones, cree un objeto de campo de widget de panel para cada sección con un número incrementado en el nombre de la propiedad.
Sobrescribir equipo 1 override_hostid._reference ABCDE._hostid - establecer un widget compatible (con su parámetro Referencia configurado en "ABCDE") como fuente de datos para los equipos;
DASHBOARD._hostid - establecer el selector de Equipo del panel como fuente de datos para los equipos.

Por defecto: "" (vacío)

Este parámetro no es compatible si se configura el widget en un panel de plantilla.

Sparkline

Se admiten los siguientes parámetros si Mostrar está configurado en "Últimos datos".

Parámetro tipo nombre valor
Ancho 0 sparkline.width Los valores posibles van de 0 a 10.

Por defecto: 1.
Relleno 0 sparkline.fill Los valores posibles van de 0 a 10.

Por defecto: 3.
Color 1 sparkline.color Código de color hexadecimal (por ejemplo, FF0000).

Por defecto: 42A5F5.
Periodo de tiempo 1 sparkline.time_period._reference DASHBOARD._timeperiod - establece el selector de Periodo de tiempo como fuente de datos;
ABCDE._timeperiod - establece un widget compatible (con su parámetro reference igual a ABCDE) como fuente de datos.

Por defecto: "" (vacío)

Alternativamente, puede establecer el periodo de tiempo solo en los parámetros Desde y Hasta.
Desde 1 sparkline.time_period.from Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o de tiempo relativo (now, now/d, now/w-1w, etc.).

Por defecto: now-1h.

Comportamiento del parámetro:
- admitido si Periodo de tiempo no está establecido
Hasta 1 sparkline.time_period.to Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o de tiempo relativo (now, now/d, now/w-1w, etc.).

Por defecto: now.

Comportamiento del parámetro:
- admitido si Periodo de tiempo no está establecido
Datos históricos 0 sparkline.history 0 - (por defecto) Automático;
1 - Historial;
2 - Tendencias.

Ejemplos

Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Tarjeta de métrica. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.

Configuración de un widget Tarjeta de métrica

Configure un widget Tarjeta de métrica que muestre estas secciones: "Descripción", "Últimos datos", "Disparadores" y "Etiquetas".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "Mi panel",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "itemcard",
                               "name": "Tarjeta de métrica",
                               "x": 0,
                               "y": 0,
                               "width": 14,
                               "height": 7,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 4,
                                       "name": "itemid.0",
                                       "value": 42257
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.0",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.2",
                                       "value": 5
                                   },
                                   {
                                       "type": 0,
                                       "name": "sections.3",
                                       "value": 9
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "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