1 Creando una métrica

Descripción general

Siga los siguientes pasos para crear un item en el Zabbix frontend:

• Vaya a: Configuration → Hosts
• De Click en Items en la fila del host
• Click en Create item en la esquina superior derecha de la pantalla.
• Agregue los parámetros del item en el formulario

También es posible crear un nuevo item si abrimos alguno existente, presionamos el botón Clone y después guardando utilizando 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.
Tipo	Tipo de métrica. Vea las secciones individuales de tipos de métrica.
Clave	La clave de la métrica (hasta 2048 caractéres). Los tipos de métrica soportados pueden ser encontrados en las secciones individuales de tipos de datos. La clave debe ser única dentro de un equipo. Si el tipo de clave es 'Zabbix agent', 'Zabbix agent (active)' o 'Simple check', el valor de la clave debe ser soportado por el agente Zabbix o el servidor Zabbix. Vea también: Los formatos de clave correctos.
Tipo de información	Tipo de información como será guardada en una base de datos después de procesar las conversiones, en caso de haberlas. Numeric (unsigned) - Entero sin signo de 64bit Numeric (float) - Número de punto flotante de 64bit. Este tipo permitirá una presición de 15 dígitos y un rango aproximado de -1.79E+308 a 1.79E+308 (con excepción de PostgreSQL 11 y versiones anteriores). También está soportado recibir los valores en notación científica. Por ejemplo. 1.23E+7, 1e308, 1.1E-4. Character - Datos de texto corto Log - Datos de texto largo con propiedades de log opcionales (timestamp, fuente, severidad, logeventid) Text - Datos de texto largo. Vea también Límites de datos de texto. Para keys de item que regresen datos solo en un formato específico, matching type of information (coincidir tipo de información) está seleccionada de manera automática.
Interface del equipo	Seleccione la interface del equipo. Este campo esta disponible cuando editamos una métrica a nivel de equipo.
Unidades	Si un símbolo de unidad se encuentra definido, Zabbix realizará un post procesamiento del valor recibido y lo mostrará con el prefijo de unidad. Por defecto, si el valor bruto excede 1000, este será dividido entre 1000 será mostrado respectivamente. Por ejemplo, si definimos bps y recibimos un valor de 881764, este serpa mostrado como 881.76 Kbps. El estándar de memoria JEDEC es utilizado para el procesamiento de unidades B (byte), Bps (bytes por segundo), las cuales son divididas por 1024. Así, si las unidades son configuradas a B o Bps Zabbix mostrará: 1 como 1B/1Bps 1024 como 1KB/1KBps 1536 como 1.5KB/1.5KBps Un procesamiento especial sera utilizado si usamos las siguientes unidades relacionadas con tiempo: unixtime - traducido a "yyyy.mm.dd hh:mm:ss". Para traducirlo correctamente, el valor recibido debe ser un dato de tipo Numeric (unsigned). uptime - traducido a "hh:mm:ss" o "N días, hh:mm:ss" Por ejemplo, si se recibe un valor como 881764 (segundos), éste será mostrado como "10 días, 04:56:04" s - traducido a "yyy mmm ddd hhh mmm sss ms"; el parámetro será tratado como número de segundos. Por ejemplo, si se recibe un valor como 881764 (segundos), serpa mostrado como "10d 4h 56m" Sólo las tres unidades mayores serán mostradas, como "1m 15d 5h" o "2h 4m 46s". Si no hay días para mostrar, sólo dos niveles serán mostrados - "1m 5h" (no se mostrarán minutos, segundos o milisegundos). Serán traducidos a "< 1 ms" si el valor es menor a 0.001. Note que si una unidad lleva como prefijo !, entonces no se aplicará procesamiento/prefijo a los valores del ítem. Vea Conversión de unidades.
Update interval	Obtiene un nuevo valor para este item cada N segundos. El máximo permitido para el intervalo de actualización es de 86400 segundos (1 día). Sufijos de tiempo son soportados, por ejemplo. 30s, 1m, 2h, 1d. Macros de usuario están soportados. Un solo macro tiene que completar todo el campo. Macros múltiples en un campo, o macros combinados con texto no están soportados. Note: El intervalo de actualización puede ser configurado a '0' solo si los intervalos personalizados existen con un valor diferente a cero. Si se configura a '0', y existe un intervalo personalizado (flexible o programado) con un valor diferente a cero, el item será obtenido durante el intervalo personalizado de duración. Note que el primer item obtenido tras activar el item o después de cambiar el intervalo de actualización puede ocurrir antes que el valor configurado. Un item pasivo puede obtener un valor de manera inmediata si presionamos el botón Ejecutar ahora.
Intervalos personalizados	Puede crear reglas personalizadas para comprobar la métrica: Flexible - crea una excepción al Update interval (intervalo con una frecuencia diferente) Programado - crea un programa de obtención del item personalizado. Para más detalles vea Custom intervals. Sufijos de tiempo están soportados en el campo Interval , ejemplo. 30s, 1m, 2h, 1d. Macros de usuario están soportados. Un solo macro tiene que completar todo el campo. Macros múltiples en un campo, o macros combinados con texto no están soportados. La programación de intervalos esta soportada desde Zabbix 3.0.0. Nota: No está disponible para items activos del Zabbix agent.
History storage period	Seleccione: Do not keep history - El historial del item no será almacenado. Útil para items maestro si solo los items dependientes necesitan retener el historial. Este valor no puede ser anulado por la configuración del housekeeper global. Storage period - especifica la duración del detallado histórico en la base de datos (de 1 hora a 25 años). La información más antigua será borrada por el housekeeper. Guardado en segundos. Sufijos de tiempo están soportados, por ejemplo. 2h, 1d. Los Macros de usuario están permitidos. El valor Storage period puede ser reemplazado a nivel global en Administration → General → Housekeeper. Si existe una configuración de reemplazo global, se mostrará un ícono de información verde . Si posiciona su ratón sobre el, se mostrará un mensaje de advertencia, por ejemplo, Overridden by global housekeeper settings (1d). Se recomienda mantener los valores almacenados por el periodo de tiempo más bajo permitido para así reducir el tamaño del valor histórico en la base de datos. En lugar de mantener un histórico largo para estos datos, puede mantener un historial de tendencia de datos mas largo. Vea también History and trends (historial y tendencias).
Trend storage period	Seleccione: Do not keep trends - las tendencias no serán almacenadas. Este valor no puede ser reemplazado por la configuración global del housekeeper. Storage period - especifica la duración del historial de los agregados (por hora mínimo, máximo, promedio, conteo, de 1 día a 25 años). La información más antigua será borrada por el housekeeper. Almacenado en segundos. Sufijos de tiempo están soportados, por ejemplo. 24h, 1d. Macros de usuario están permitidos. El valor Storage period puede ser reemplazado a nivel global en Administration → General → Housekeeper. Si existe una configuración de reemplazo global, se mostrará un ícono de información verde . Si posiciona su ratón sobre el, se mostrará un mensaje de advertencia, por ejemplo, Overridden by global housekeeper settings (7d). Nota: Conservar los trends no está disponible para datos no-numéricos - caracteres, log y texto. Vea también History y trends.
Value mapping	Aplica un mapeo de valores a este item. Value mapping no cambia los valores recibidos, sólo afecta la manera en que mostramos la información. Funciona con items tipo Numeric(unsigned), Numeric(float) y Character. Por ejemplo, "Estado de servicios Windows".
Log time format	Disponible sólo para items tipo Log. Marcadores permitidos: * 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 vacío, el timestamp no será procesado. Por ejemplo, considere la siguiente línea del archivo log de Zabbix agent: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." Ésta comienza con seis posiciones de caracteres para el PID (identificador del proceso), seguido de la fecha, tiempo, y el resto de la línea. El Log time format para esta línea puede ser "pppppp:yyyyMMdd:hhmmss". Note que los caracteres "p" y ":" sólo son marcadores de posición (placeholders) y puede ser cualquier cosa menos "yMdhms".
Populates host inventory field	Puede seleccionar un campo de inventario del host que el valor del item va a obtener. Esto va a funcionar si la obtención automática del inventario está habilitada en el host. Este campo no está disponible si Type of information esta configurado como 'Log'.
Description	Definir una descripción de la métrica.
Enabled	Marque esta casilla de selección para habilitar la métrica para que este pueda ser procesada.
Latest data	Presione el enlace para ver el último valor para la métrica. Éste enlace solo está disponible cuando editamos una métrica previamente existente.

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

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 un resultado real. Las pruebas pueden realizarse incluso antes de guardar una métrica.

Las pruebas están disponibles para equipos y plantillas de métricas, 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 pasivos:

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

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 durante 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 (equipo dirección, 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 consciente del contexto:

• Los valores se completan previamente cuando es posible, es decir, para elementos que requieren una agente, tomando la información de la interfaz del agente seleccionado del anfitrión
• Los valores deben completarse manualmente para los elementos de la plantilla.
• Se resuelven los valores de macro de texto sin formato.
• Campos donde el valor (o parte del valor) es un secreto o Bóveda La macro está vacía y debe ingresarse manualmente. Si algún artículo El parámetro contiene un valor de macro secreto, la siguiente advertencia Se muestra el mensaje: "El elemento contiene macros definidas por el usuario con secreto valores. Los valores de estas macros deben ingresarse manualmente."
• Los campos están deshabilitados cuando no son necesarios en el contexto del elemento. tipo (por ejemplo, el campo de dirección de host y el campo de proxy están deshabilitados para artículos calculados)

Para probar el artículo, 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 Valor anterior. campo time, 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 host 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 una métrica. É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 nueva valor de una métrica de manera inmediata. Soportado sólo en verificaciones pasivas (vea más detalles). Note que cuando verificamos 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 configuració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 tendencias 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 hacerlos 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 depende de la base de datos utilizada:

Métricas no soportadas

Una métrica se puede convertir en no soportada si su valor no puede ser obtenido por alguna razón. Ésta métrica volverá a ser comprobada según la configuración de su Intervalo de verificación.

Las métricas no soportadas se reportan teniendo un estado como NOT SUPPORTED.