Pruebas de preprocesamiento

Pruebas

Probar los pasos de preprocesamiento es útil para asegurarse de que las canalizaciones de preprocesamiento complejas produzcan los resultados esperados, sin esperar a que se reciba y se procese el valor del item.

Es posible probar:

  • con un valor hipotético
  • con un valor real de un host

Cada paso de preprocesamiento puede probarse de forma individual, así como todos los pasos pueden probarse juntos. Cuando hace clic en el botón Test o Test all steps, respectivamente, en el bloque Actions, se abre una ventana de prueba.

Prueba de valor hipotético

Parameter Description
Get value from host Si desea probar un valor hipotético, deje esta casilla sin marcar.
Véase también: Prueba de valor real.
Value Introduzca el valor de entrada que desea probar.
Al hacer clic en el campo del parámetro o en el botón de vista/edición se abrirá una ventana de área de texto para introducir el valor o un bloque de código.
Not supported Marque esta casilla para probar un valor no compatible.
Esta opción es útil para probar el paso de preprocesamiento Check for not supported value.
Error Introduzca el texto del error.
Este campo se habilita cuando Get value from host está desmarcado, pero Not supported está marcado.
Si Get value from host está marcado, este campo se rellena con el mensaje de error real (solo lectura) procedente del host.
Time Se muestra la hora del valor de entrada: now (solo lectura).
Previous value Introduzca un valor de entrada anterior para comparar.
Solo para los pasos de preprocesamiento Change y Throttling.
Previous time Introduzca la hora del valor de entrada anterior para comparar.
Solo para los pasos de preprocesamiento Change y Throttling.
El valor predeterminado se basa en el valor del campo 'Update interval' del item (si es '1m', entonces este campo se rellena con now-1m). Si no se especifica nada o el usuario no tiene acceso al host, el valor predeterminado es now-30s.
Macros Si se utilizan macros, se enumeran junto con sus valores. Los valores son editables con fines de prueba, pero los cambios solo se guardarán dentro del contexto de prueba.
End of line sequence Seleccione la secuencia de fin de línea para valores de entrada multilínea:
LF - secuencia LF (line feed)
CRLF - secuencia CRLF (carriage-return line-feed).
Preprocessing steps Se enumeran los pasos de preprocesamiento; el resultado de la prueba se muestra para cada paso después de hacer clic en el botón Test.
Los resultados de la prueba se truncan a un tamaño máximo de 512 KB cuando se envían al frontend. Los resultados de la prueba se pueden copiar (no más de los 512 KB truncados). Si un resultado se trunca, 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 de más de 512 KB siguen siendo procesados completamente por Zabbix server.
Si el paso falló durante la prueba, se muestra un icono de error. La descripción del error se muestra al pasar el ratón por encima.
En caso de que se especifique "Custom on fail" para el paso y se ejecute esa acción, aparece una nueva línea justo después de la fila del paso de prueba de preprocesamiento, mostrando qué acción se realizó y qué resultado produjo (error o valor).
Result El resultado final de la prueba de los pasos de preprocesamiento se muestra en todos los casos cuando todos los pasos se prueban juntos (al hacer clic en el botón Test all steps).
También se muestra el tipo de conversión al tipo de valor del item, por ejemplo Result converted to Numeric (unsigned).
Los resultados de la prueba se truncan a un tamaño máximo de 512 KB cuando se envían al frontend. El resultado final se puede copiar (no más de los 512 KB truncados). Si un resultado se trunca, 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 de más de 512 KB siguen siendo procesados completamente por Zabbix server.

Haga clic en Test para ver el resultado después de cada paso de preprocesamiento.

Los valores de prueba se almacenan entre sesiones de prueba, ya sea para pasos individuales o para todos los pasos, lo que permite al usuario cambiar los pasos de preprocesamiento o la configuración del item y luego volver a la ventana de prueba sin tener que volver a introducir la información. Sin embargo, los valores se pierden al actualizar la página.

La prueba la realiza Zabbix server. El frontend envía una solicitud correspondiente al server y espera el resultado. La solicitud contiene el valor de entrada y los pasos de preprocesamiento (con las macros de usuario expandidas). Para los pasos Change y Throttling, se puede especificar opcionalmente un valor y una hora anteriores. El server responde con los resultados de cada paso de preprocesamiento.

Todos los errores técnicos o de validación de entrada se muestran en el cuadro de error situado en la parte superior de la ventana de prueba.

Probar un valor real

Para probar el preprocesamiento con un valor real:

  • Marque la casilla Obtener valor del host
  • Introduzca o verifique los parámetros del host (dirección del host, puerto, nombre del proxy o ausencia de proxy) y los detalles específicos del item (como la comunidad SNMPv2 o las credenciales de seguridad SNMPv3). Estos campos tienen en cuenta el contexto:
    • Los valores se rellenan previamente cuando es posible; por ejemplo, para los items que requieren un agent, se toma la información de la interfaz de agent seleccionada del host
    • Los valores deben rellenarse manualmente para los items de template
    • Los valores de las macros de texto sin formato se resuelven
    • Cuando el valor del campo (o parte de este) es un secreto o una macro de Vault, el campo estará vacío y deberá rellenarse manualmente. Si algún parámetro del item contiene un valor de macro secreta, se muestra el siguiente mensaje de advertencia: "El item contiene macros definidas por el usuario con valores secretos. Los valores de estas macros deben introducirse manualmente."
    • Los campos se deshabilitan cuando no son necesarios en el contexto del tipo de item (por ejemplo, los campos de dirección del host y proxy se deshabilitan para los items calculados)
  • Haga clic en Obtener valor y probar para probar el preprocesamiento

Si ha especificado una asignación de valores en el formulario de configuración del item (el campo Mostrar valor), el cuadro de diálogo de prueba del item mostrará otra línea después del resultado final, denominada Resultado con la asignación de valores aplicada.

Parámetros específicos para obtener un valor real de un host:

Parámetro Descripción
Obtener valor del host Marque esta casilla para obtener un valor real del host.
Dirección del host Introduzca la dirección del host.
Este campo se rellena automáticamente con la dirección de la interfaz del host del item.
Puerto Introduzca el puerto del host.
Este campo se rellena automáticamente con el puerto de la interfaz del host del item.
Campos adicionales para interfaces SNMP
(versión SNMP, comunidad SNMP, nombre de contexto, etc.)		 Consulte Configuración de la monitorización SNMP para obtener más información sobre la configuración de una interfaz SNMP (v1, v2 y v3).
Estos campos se rellenan automáticamente a partir de la interfaz del host del item.
Proxy Especifique el proxy si el host está monitorizado por un proxy.
Este campo se rellena automáticamente con el proxy del host (si existe).
Valor Valor recuperado del host.
Al hacer clic en el campo del parámetro o en el botón de visualización/edición , se abrirá una ventana de área de texto con el valor o el bloque de código.
Los valores se truncan a un tamaño máximo de 512 KB únicamente en el frontend. Si un resultado se trunca, 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 de más de 512 KB siguen siendo procesados completamente por Zabbix server.

Para el resto de los parámetros, consulte Probar un valor hipotético más arriba.