1 Creando una métrica

Descripción general

Para crear una métrica en el frontend de Zabbix, haga lo siguiente:

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

También puede crear una métrica abriendo una existente, presionando el botón Clonar y luego guardándola con un nombre diferente.

Configuración

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

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

Parámetro	Descripción
Nombre	Nombre de la métrica. Se admiten macros de usuario.
Tipo	Tipo de métrica. Consulte las secciones individuales de tipo de métrica.
Clave	Clave de la métrica (hasta 2048 caracteres). Las claves de métrica admitidas se pueden encontrar en las secciones individuales de tipo de métrica. 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. Consulte también: el formato de clave correcto.
Tipo de información	Tipo de dato tal como se almacena en la base de datos después de realizar conversiones, si las hubiera. Numérico (sin signo) - Entero sin signo de 64 bits. Tenga en cuenta que un valor de punto flotante, si se recibe para una métrica entera, se truncará a partir de su parte decimal. 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 cortos. Log - datos de texto largos con propiedades opcionales relacionadas con logs (timestamp, source, severity, logeventid). Texto - datos de texto largos. Consulte también límites de datos de texto. Binario - número binario (admitido solo para métricas dependientes). Un número binario se resolverá en una cadena estática "valor binario" en Últimos datos; {ITEM.VALUE}, {ITEM.LASTVALUE} y las macros de expresión se resolverán como UNKNOWN. Para claves de métrica que devuelven datos solo en un formato específico, el tipo de información correspondiente se selecciona automáticamente.
Interfaz del equipo	Seleccione la interfaz del equipo. Este campo está disponible al editar una métrica a nivel de equipo.
Unidades	Si se establece un símbolo de unidad, Zabbix aplica un postprocesamiento al valor recibido de la métrica y lo muestra con el sufijo de unidad especificado. Símbolos de unidad admitidos con formato especial (y ejemplos de valor recibido → valor mostrado): B - bytes (1024 → 1 KB) Bps - bytes por segundo (1024 → 1 KBps) s - segundos, mostrados usando hasta tres unidades de tiempo no nulas más grandes (881764 → 10d 4h 56m) uptime - tiempo transcurrido en hh:mm:ss o N días, hh:mm:ss (881764 → 10 días, 04:56:04) unixtime - marca de tiempo Unix, formateada como aaaa.mm.dd hh:mm:ss (881764 → 1970-01-11 04:56:04 AM); para un formato correcto, el valor recibido debe ser Numérico (sin signo). Para otras unidades (como Hz, W, etc.), si el valor recibido supera 1000, se divide por 1000 y se muestra con un prefijo correspondiente (5000 → 5 KHz, 881764 → 881.76 KW). Si el símbolo de unidad está precedido por !, la conversión y el prefijo de unidad se desactivan (1024 !B → 1024 B, 61 !s → 61 s). Para más ejemplos y detalles sobre símbolos y conversión de unidades, consulte Sufijos de valores de métrica.
Intervalo de actualización	Recupera un nuevo valor para esta métrica cada N segundos. El intervalo máximo permitido es de 86400 segundos (1 día). Se admiten sufijos de tiempo, 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. 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 se consultará durante la duración del intervalo personalizado. Nota que la primera consulta de la métrica después de que se active o después de cambiar el intervalo de actualización puede ocurrir antes del valor configurado. Las nuevas métricas se comprobará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. Una métrica pasiva existente puede ser consultada inmediatamente pulsando el botón Ejecutar ahora.
Intervalos personalizados	Puede crear reglas personalizadas para comprobar la métrica: Flexible - crear una excepción al Intervalo de actualización (intervalo con diferente frecuencia). Programado - crear una programación de consulta personalizada. Para información detallada consulte Intervalos personalizados. Se admiten sufijos de tiempo en el campo Intervalo, 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.
Timeout	Establece el tiempo de espera de la comprobación de la métrica (disponible para los tipos de métrica admitidos). Seleccione la opción de tiempo de espera: Global - se utiliza el tiempo de espera proxy/global (mostrado en el campo Timeout atenuado). Anular - se utiliza un tiempo de espera personalizado (establecido en el campo Timeout; rango permitido: 1 - 600s). Se admiten sufijos de tiempo, por ejemplo, 30s, 1m, y macros de usuario. Al hacer clic en el enlace Timeouts puede configurar los tiempos de espera del proxy o los tiempos de espera globales (si no se utiliza un proxy). Tenga en cuenta que el enlace Timeouts solo es visible para usuarios de tipo Super admin con permisos para las secciones de la interfaz Administración → General o Administración → Proxies.
Histórico	Seleccione una de las siguientes opciones: No almacenar - no se almacena el histórico de la métrica. Útil para métricas maestras si solo las métricas dependientes necesitan mantener histórico. Esta configuración no puede ser anulada por la configuración global del housekeeper. Almacenar hasta - especifique la duración de conservación del histórico detallado en la base de datos (de 1 hora a 25 años). Los datos más antiguos serán eliminados por el housekeeper. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 2h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede ser anulado globalmente en Administración → Housekeeping. Si existe una configuración global que anula, se muestra un icono de información naranja . Si posiciona el ratón sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global de housekeeper (1d). Se recomienda mantener los valores registrados durante el menor tiempo posible para reducir el tamaño del histórico de valores en la base de datos. En lugar de almacenar un histórico largo de valores, puede almacenar datos de tendencias durante más tiempo. Consulte también Histórico y tendencias.
Tendencias	Seleccione una de las siguientes opciones: No almacenar - no se almacenan tendencias. Esta configuración no puede ser anulada por la configuración global del housekeeper. Almacenar hasta - especifique la duración de conservación del histórico agregado (mínimo, máximo, promedio, recuento por hora) en la base de datos (de 1 día a 25 años). Los datos más antiguos serán eliminados por el housekeeper. Se almacena en segundos. Se admiten sufijos de tiempo, por ejemplo, 24h, 1d. Se admiten macros de usuario. El valor de Almacenar hasta puede ser anulado globalmente en Administración → Housekeeping. Si existe una configuración global que anula, se muestra un icono de información naranja . Si posiciona el ratón sobre él, se muestra un mensaje de advertencia, por ejemplo, Anulado por la configuración global de housekeeper (7d). Nota: Mantener tendencias no está disponible para datos no numéricos - carácter, log y texto. Consulte también Histórico y tendencias.
Mapeo de valores	Aplicar mapeo de valores a esta métrica. El mapeo de valores no cambia los valores recibidos, solo es para mostrar los datos. Funciona con métricas Numérico(sin signo), Numérico(flotante) y Carácter. Por ejemplo, "Estados de servicios de Windows".
Formato de hora de log	Disponible solo para métricas de tipo Log. 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). s: Segundo (00-59). Si se deja en blanco, la marca de tiempo se establecerá en 0 en tiempo Unix, representando el 1 de enero de 1970. Por ejemplo, considere la siguiente línea del archivo de log del agente Zabbix: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Comienza con seis posiciones de caracteres para el PID, seguidas de la fecha, la hora y el resto del mensaje. El formato de hora de log para esta línea sería "pppppp:yyyyMMdd:hhmmss". Tenga en cuenta que los caracteres "p" y ":" son marcadores de posición y pueden ser cualquier carácter excepto "yMdhms".
Rellena el campo de inventario del equipo	Puede seleccionar un campo de inventario del equipo que el valor de la métrica rellenará. Esto funcionará si la población automática de inventario está habilitada para el equipo. Este campo no está disponible si el Tipo de información está establecido en 'Log'.
Descripción	Introduzca una descripción de la métrica. Se admiten macros de usuario.
Habilitado	Marque la casilla para habilitar la métrica y que sea procesada. Cuando deshabilite la métrica, se elimina inmediatamente de la caché de histórico (excepto su último valor, que se mantiene para logs).
Últimos datos	Haga clic en el enlace para ver los últimos datos de la métrica. Este enlace solo está disponible al editar una métrica ya existente.

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

Preprocesamiento de valores de la métrica

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

Pruebas

Es posible probar una métrica y, si está configurada correctamente, obtener un valor real como resultado. La prueba puede realizarse incluso antes de guardar la métrica.

La prueba está disponible para métricas de equipos y plantillas, prototipos de métricas y reglas de bajo nivel de descubrimiento. La prueba no está disponible 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.*)
• Interno de Zabbix
• Métricas calculadas
• Comprobaciones externas
• Monitor de base de datos
• Agente HTTP
• Script
• Navegador

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á deshabilitado para las métricas que no se pueden probar (como comprobaciones activas, comprobaciones simples excluidas).

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

• Los valores se rellenan automáticamente cuando es posible, es decir, para métricas que requieren un agente, tomando la información de la interfaz de agente seleccionada del equipo
• Los valores deben rellenarse manualmente para métricas de plantillas
• Los valores de macros en texto plano se resuelven
• Los campos donde el valor (o parte del valor) es una macro secreta o de Vault están vacíos y deben introducirse manualmente. Si algún parámetro de la métrica contiene un valor de macro secreta, 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 introducirse manualmente."
• Los campos están deshabilitados cuando no se necesitan en el contexto del tipo de métrica (por ejemplo, el campo de dirección del equipo y el campo de proxy están deshabilitados para métricas calculadas)

Para probar la métrica, haga clic en Obtener valor. Si el valor se recupera correctamente, llenará el campo Valor, moviendo el valor actual (si lo hay) al campo Valor anterior y calculando también el campo Hora ant., es decir, la diferencia de tiempo entre los dos valores (clics) e intentando detectar una secuencia EOL y cambiar a CRLF si se detecta "\n\r" en el valor recuperado.

Los valores recuperados de un equipo y los resultados de las pruebas se truncan a un tamaño máximo de 512KB cuando se envían al frontend. Si un resultado es truncado, se muestra un icono de advertencia. La descripción de la advertencia se muestra al pasar el ratón por encima. Tenga en cuenta que los datos mayores de 512KB aún se procesan completamente por el servidor Zabbix.

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

Un valor recuperado correctamente de un equipo también puede utilizarse para probar los pasos de preprocesamiento.

Botones del formulario

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

	Agregar una métrica. Este botón solo está disponible para nuevas métricas.
	Actualizar las propiedades de una métrica.
	Crear otra métrica basada en las propiedades de la métrica actual.
	Ejecutar una comprobación para obtener un nuevo valor de la métrica inmediatamente. Solo es compatible con comprobaciones pasivas (ver más detalles). Nota que al comprobar un valor inmediatamente, la caché de configuración no se actualiza, por lo que el valor no reflejará los cambios más recientes en la configuración de la métrica.
	Probar si la configuración de la métrica es correcta obteniendo un valor.
	Eliminar el historial y las tendencias de la métrica.
	Eliminar la métrica.
	Cancelar la edición de las propiedades de la métrica.

Límites de datos de texto

Los límites de datos de texto dependen del motor de base de datos. Antes de almacenar los valores de texto en la base de datos, se truncan para que coincidan con el límite del tipo de valor de la base de datos:

Límite de script personalizado

La longitud disponible para scripts personalizados depende de la base de datos utilizada:

Métricas no soportadas

Las métricas no soportadas se informan con el estado No soportado y aún se vuelven a comprobar en su Intervalo de actualización estándar.

Una métrica se vuelve no soportada si su valor no puede recuperarse por alguna razón (por ejemplo, error de conexión, no hay recolectores configurados para procesar la métrica). Además, las métricas que no reciben datos históricos permanecen en el estado No soportado. Este es el comportamiento esperado: una métrica pasa al estado Normal solo cuando recibe nuevos datos históricos válidos.

Al igual que los problemas, las métricas no soportadas solo se reevalúan cuando se reciben nuevos datos, incluso si ya no hay datos históricos disponibles para esa métrica. En otras palabras, las métricas y disparadores cambian su estado únicamente al recibir nuevos datos. Sin embargo, si una expresión de disparador incluye una función de fecha y hora y/o nodata(), el disparador se recalculará cada 30 segundos (consulte tiempo de cálculo de disparadores para más detalles).