1 Creando una métrica

Descripción general

Siga los siguientes pasos para crear una métrica en la interfaz de usuario de Zabbix:

• Vaya a: Recopilación de datos → Equipos
• Haga click en Métricas en la fila del equipo
• Haga click en Crear métrica en la esquina superior derecha de la pantalla.
• Agregue los parámetros de la métrica en el formulario

También es posible crear una nueva métrica si abrimos alguna existente, presionamos el botón Clonar y después la guardamos utilizando un nombre diferente.

Configuración

La pestaña Métrica contiene atributos generales de la métrica.

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

Parámetro	Descripción
Nombre	Nombre del elemento.
Tipo	Tipo de métrica. Consulte las secciones individuales de tipo de métrica.
Clave	Clave de elemento (hasta 2048 caracteres). Las claves de elemento admitidas se pueden encontrar en secciones de tipos de elementos individuales. La clave debe ser única dentro de un solo equipo. Si el tipo de clave es 'agente Zabbix', 'agente Zabbix (activo)' o 'comprobación simple', el valor de la clave debe ser compatible con el agente Zabbix o el servidor Zabbix. Ver también: [formato de clave] correcto (/manual/config/items/item/key).
Tipo de información	Tipo de datos almacenados en la base de datos después de realizar las conversiones, si corresponde. Numérico (sin signo) - entero de 64 bits sin signo Numérico (flotante) - Número de punto flotante de 64 bits Este tipo permitirá una precisión de aproximadamente 15 dígitos y un rango de aproximadamente -1,79E+308 a 1,79E+308 (con excepción de PostgreSQL 11 y versiones anteriores). También se admite la recepción de valores en notación científica. Por ejemplo, 1.23E+7, 1e308, 1.1E-4. Carácter: datos de texto breve Registro: datos de texto largo con propiedades opcionales relacionadas con el registro (marca de tiempo, origen, gravedad, logeventid) Text - datos de texto largos. Consulte también límites de datos de texto. Para claves de elementos que devuelven datos solo en un formato específico, el tipo de información coincidente se selecciona automáticamente.
Interfaz de equipo	Seleccione la interfaz del equipo. Este campo está disponible al editar un elemento en el nivel de equipo.
Unidades	Si se establece un símbolo de unidad, Zabbix agregará posprocesamiento al valor recibido y lo mostrará con el sufijo de unidad establecido. De forma predeterminada, si el valor bruto excede 1000, se divide por 1000 y se muestra en consecuencia . Por ejemplo, si configura bps y recibe un valor de 881764, se mostrará como 881,76 Kbps. Se utiliza el estándar de memoria JEDEC para procesar unidades B (byte), Bps (bytes por segundo), que se dividen por 1024. Por lo tanto, si las unidades se configuran en B o Bps, Zabbix mostrará : 1 como 1B/1Bps 1024 como 1KB/1KBps 1536 como 1,5KB/1,5KBps Se utiliza procesamiento especial si se utilizan las siguientes unidades relacionadas con el tiempo: unixtime - traducido como "aaaa.mm.dd hh:mm:ss". Para traducir correctamente, el valor recibido debe ser un tipo de información Numérica (sin firmar). uptime - traducido a "hh:mm:ss" o "N días, hh:mm:ss"< br>Por ejemplo, si recibe el valor 881764 (segundos), se mostrará como "10 días, 04:56:04" s - traducido a "yyy mmm ddd hhh mmm sss ms "; El parámetro se trata como un número de segundos. Por ejemplo, si recibe el valor como 881764 (segundos), se mostrará como "10d 4h 56m" Solo se muestran 3 unidades principales superiores, como "1m 15d 5h" o "2h 4m 46s". Si no hay días para mostrar, solo se muestran dos niveles: "1m 5h" (no se muestran minutos, segundos ni milisegundos). Se traducirá a "< 1 ms" si el valor es inferior a 0,001. Tenga en cuenta que si una unidad tiene el prefijo !, no se aplica ningún prefijo/procesamiento de unidad a los valores de los elementos. Consulte conversión de unidades.
Intervalo de actualización	Recupera un nuevo valor para este elemento cada N segundos. El intervalo de actualización máximo permitido es 86400 segundos (1 día). Se admiten sufijos de tiempo, por ejemplo, 30s, 1m, 2h, 1d. Macros de usuario son compatibles. Una sola macro debe llenar todo el campo. No se admiten varias macros en un campo ni macros mezcladas con texto. Nota: El intervalo de actualización solo se puede establecer en '0' si existen intervalos personalizados con un valor distinto de cero. Si se establece en '0' y existe un intervalo personalizado (flexible o programado) con un valor distinto de cero, la métrica será sondeada durante la duración del intervalo personalizado. Tenga en cuenta que la primera encuesta de la métrica después de que la métrica se convirtió activa o después del cambio del intervalo de actualización puede ocurrir antes del valor configurado. Las nuevas métricas se verificarán dentro de los 60 segundos de su creación, a menos que tengan un intervalo de actualización programado o flexible y el intervalo de actualización esté establecido en 0. Se puede sondear un elemento pasivo existente para determinar su valor inmediatamente presionando el botón Ejecutar ahora botón.
Intervalos personalizados	Puedes crear reglas personalizadas para verificar el elemento: Flexible: crea una excepción al Intervalo de actualización (intervalo con diferente frecuencia) Programación: crea un cronograma de sondeo personalizado. Para obtener información detallada, consulte Intervalos personalizados. Los sufijos de tiempo se admiten en el Intervalo campo, por ejemplo, 30s, 1m, 2h, 1d. Se admiten macros de usuario. Una sola macro debe llenar todo el campo. No se admiten varias macros en un campo ni macros mezcladas con texto. La programación se admite desde Zabbix 3.0.0. Nota: los intervalos personalizados para comprobaciones activas solo son compatibles con el agente 2 de Zabbix.
Período de almacenamiento del historial	Seleccione: No conservar el historial: el historial del elemento no se almacena. Útil para métricas principales si solo las métricas dependientes necesitan mantener el historial. Esta configuración no puede ser anulada por la configuración de la limpieza global (/manual/web_interface/frontend_sections/administration/housekeeping). Período de almacenamiento - especifique la duración del mantenimiento del historial detallado en la base de datos (de 1 hora a 25 años). El ama de llaves eliminará los datos más antiguos. Almacenado en segundos. Se admiten sufijos de tiempo, por ejemplo, 2h, 1d. Se admiten macros de usuario. El valor del Período de almacenamiento se puede anular globalmente en Administración → Limpieza . Si existe una configuración de anulación global, se muestra un icono de información verde . Si coloca el mouse sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global del ama de llaves (1d). Se recomienda conservar los valores registrados durante el menor tiempo posible para reducir el tamaño del historial de valores. en la base de datos. En lugar de mantener un largo historial de valores, puede conservar datos de tendencias más extensos. Consulte también Historial y tendencias.
Período de almacenamiento de tendencias	Seleccione: No conservar tendencias: las tendencias no se almacenan. Esta configuración no puede ser anulada por la configuración del administrador global (/manual/web_interface/frontend_sections/administration /housekeeping). Período de almacenamiento: especifique la duración de mantenimiento del historial agregado (mínimo, máximo, promedio, recuento por hora) en la base de datos (de 1 día a 25 años). El ama de llaves eliminará los datos más antiguos. Almacenado en segundos. Se admiten sufijos de tiempo, por ejemplo, 24 h, 1 d. Se admiten macros de usuario. El valor del Período de almacenamiento se puede anular globalmente en Administración → Limpieza . Si existe una configuración de anulación global, se muestra un icono de información verde . Si coloca el mouse sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global del limpiador interno (7d). Nota: Mantener tendencias no está disponible para datos no numéricos: caracteres, registros y texto. . Ver también Historial y tendencias.
Asignación de valores	Aplicar asignación de valores a esta métrica. Asignación de valores no cambia los valores recibidos, es solo para mostrar datos. Funciona con Numeric(unsigned), Numeric(float) y Character elementos. Por ejemplo, "Estados del servicio de Windows".
Formato de hora de registro	Disponible solo para elementos de tipo Registro. Marcadores de posición admitidos: * y: Año (1970-2038) * M: Mes (01-12) * **d* : Día (01-31) * h: Hora (00-23) * m: Minuto (00-59)<br >* s: Segundo (00-59)* Si se deja en blanco, la marca de tiempo no se analizará. Por ejemplo, considere la siguiente línea del archivo de registro del agente Zabbix:<br >" 23480:20100328:154718.045 Se inició el agente Zabbix. Zabbix 1.8.2 (revisión 11211)." Comienza con seis posiciones de caracteres para PID, seguidas de la fecha, la hora y el resto de la línea. Registro El formato de hora para esta línea sería "pppppp:yyyyMMdd:hhmmss". Tenga en cuenta que los caracteres "p" y ":" son solo marcadores de posición y pueden ser cualquier cosa menos "yMdhms".
Completa el campo de inventario de equipo	Puede seleccionar un campo de inventario de equipo que se completará con el valor de la métrica. Esto funcionará si el llenado automático del inventario está habilitado para el equipo. Este campo no está disponible si Tipo de información está configurado en 'Registro'.
Descripción	Ingrese una descripción de la métrica. Se admiten macros de usuario.
Habilitado	Marque la casilla de verificación para habilitar la métrica para que sea procesada.
Últimos datos	Haga clic en el enlace para ver los datos más recientes de la métrica. Este enlace solo está disponible cuando se edita una métrica ya existente.

La pestaña Etiquetas permite definir las etiquetas a nivel de métricas.

Preprocesamiento de los valores de la métrica

La pestaña Preprocesamiento permite definir las reglas de transformación para los valores recibidos.

Pruebas

Es posible probar una métrica y, si se configura correctamente, obtener como resultado un valor real. Las pruebas pueden realizarse incluso antes de guardar una métrica.

Las pruebas están disponibles para métricas de equipos y de plantillas, prototipos de métricas y reglas de descubrimiento de bajo nivel. Las pruebas no están disponibles para métricas activas.

La prueba de métricas está disponible para los siguientes tipos de métricas pasivas:

• Agente Zabbix
• Agente SNMP (v1, v2, v3)
• Agente IPMI
• Comprobaciones SSH
• Comprobaciones Telnet
• Agente JMX
• Comprobaciones simples (excepto métricas icmpping*, vmware.*)
• Zabbix interno
• Métricas calculadas
• Comprobaciones externas
• Monitor de base de datos
• Agente HTTP
• Script

Para probar una métrica, haga clic en el botón Probar en la parte inferior del formulario de configuración de la métrica. Tenga en cuenta que el botón Probar estará desactivado para métricas que no se pueden probar (como controles activos, comprobaciones simples excluidas).

El formulario de prueba de la métrica tiene campos para los parámetros de equipo requeridos (dirección del equipo, puerto, nombre de proxy/sin proxy) y detalles específicos de la métrica (como comunidad SNMPv2 o credenciales de seguridad SNMPv3). Estos campos son dependientes del contexto:

• Los valores se completan previamente cuando es posible, es decir, para métricas que requieren un agente, tomando la información de la interfaz del agente del equipo seleccionado
• Los valores deben completarse manualmente para las plantillas de métricas.
• Se resuelven los valores de macro de texto sin formato.
• Campos donde el valor (o parte del valor) es un secreto o Vault La macro está vacía y debe ingresarse manualmente. Si algún parámetro de métrica contiene un valor de macro secreto, se muestra el siguiente mensaje de advertencia: "La métrica contiene macros definidas por el usuario con valores secretos. Los valores de estas macros deben ingresarse manualmente."
• Los campos están deshabilitados cuando no son necesarios en el contexto del tipo de métrica (por ejemplo, el campo de dirección de equipo y el campo de proxy están deshabilitados para métricas calculadas)

Para probar la métrica, haga clic en Obtener valor. Si se recupera el valor exitosamente, llenará el campo Valor, moviendo el valor actual (si corresponde) al campo Valor anterior mientras también se calcula el campo Hora del valor anterior, es decir, la diferencia horaria entre los dos valores (clics) e intentar detectar una secuencia EOL y cambiar a CRLF si detecta "\n\r" en el valor recuperado.

Si la configuración es incorrecta, se muestra un mensaje de error describiendo la posible causa.

Un valor recuperado exitosamente del equipo también se puede usar para probar pasos de preprocesamiento.

Botones de formulario

Los botones en la parte inferior del formulario permiten realizar varias operaciones.

	Agregar un item. Éste botón solo está disponible para nuevas métricas.
	Actualizar las propiedades de una métrica.
	Crear otra métrica basándonos en las propiedades de la métrica actual.
	Ejecuta la comprobación del valor de una nueva métrica de manera inmediata. Soportado sólo en comprobaciones pasivas (vea más detalles). Note que cuando comprobamos un valor de manera inmediata, la configuración del caché no se actualiza, por lo que el valor no reflejará los cambios recientes a la configración de la métrica.
	Prueba si la configuración de la métrica es correcta al obtener un valor.
	Borra el historial y las tendenias de la métrica.
	Borra la métrica.
	Cancela la edición de las propiedades de la métrica.

Límites de datos de texto

Los límites de datos de texto dependen de la base de datos utilizada. Antes de almacenar los valores de texto en la base de datos éstos son truncados para hacerlo coincidir con el límite del tipo de valor de la base de datos:

Conversión de unidades

Por defecto, especificar una unidad para un item resulta en un prefijo multiplicador que será agregado - por ejemplo, si obtenemos un valor '2048' con unidad 'B', éste se mostrará como '2KB'.

Para prevenir que una unidad sea convertida, utilice el prefijo !, por ejemplo, !B. Para comprender de una mejor manera cómo funciona la conversión con o sin el signo de exclamación, vea los siguientes ejemplos de valores y unidades:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Límite de script personalizado

La longitud de los scripts personalizados disponibles depende de la base de datos utilizada:

Items no soportados

Un item se puede convertirse en no soportado si su valor no puede ser obtenido por alguna razón. Éste item volverá a ser verificado según la configuración de su Intervalo de verificación.

Los items no soportados se reportan teniendo un estado NOT SUPPORTED.