Utiliza campos calculados para transformar y enriquecer tus datos de log en el momento de la consulta. Define fórmulas para:
Una vez definido, un campo calculado puede utilizarse como cualquier atributo de log para la búsqueda, agregación, visualización e incluso para definir otros campos calculados.
Notas:
- Puedes definir hasta cinco campos calculados a la vez.
- Los campos calculados son temporales y no persisten más allá de una sesión determinada del Log Explorer. Si un campo calculado puede ser útil repetidamente, actualiza tus pipelines de log para codificar la información en tus logs cuando sean ingeridos y procesados.
Crear un campo calculado
Hay dos puntos de entrada para crear un campo calculado en el Log Explorer: desde el menú *Add (Añadir) o desde dentro de un evento de log o atributo específico.
Elegir un punto de partida para tu campo calculado
En el menú Add (Añadir)
- Navega hasta el Log Explorer.
- Haz clic en el botón Add (Añadir) situado junto a la barra de búsqueda.
- Selecciona Calculated field (Campo calculado).
Esta es una forma rápida de crear un campo calculado cuando ya estás familiarizado con la estructura y el contenido de los logs que te interesan.
Desde un evento de log o atributo específico
- Navega hasta el Log Explorer.
- Haz clic en un evento de log de interés para abrir el panel lateral.
- Haz clic en un atributo JSON específico para abrir el menú contextual.
- Selecciona Create calculated from… (Crear calculado desde…).
Este enfoque te permite adaptarte rápidamente durante una investigación o explorar logs desconocidos. Por ejemplo, puede que desees multiplicar o concatenar dos valores y almacenar el resultado en un único campo para simplificar un gráfico o responder a una pregunta concreta.
Definir un campo calculado
Nombre
Establece un nombre descriptivo que indique claramente la finalidad del campo calculado. Por ejemplo, si el objetivo es combinar los nombres y apellidos de los usuarios en un solo campo, puedes llamar al campo calculado fullName
.
Para filtrar los logs desde un usuario llamado Pinkie Smith
, incluye el nombre del campo calculado en tu consulta: #fullName:"Pinkie Smith"
. Nota: Debes utilizar el prefijo #
para referirse a campos calculados en búsquedas, agregaciones u otras definiciones de campos calculados.
Fórmula
La fórmula (o expresión) determina el resultado que debe calcularse y almacenarse como valor del campo calculado para cada evento de log. Los constructos válidos incluyen atributos de log, otros campos calculados y un conjunto de funciones y operadores admitidos. Los campos, funciones y operadores relevantes se sugieren automáticamente al escribir o editar la fórmula.
Consulta Lenguaje de expresión de campos calculados para conocer los operadores y funciones disponibles.
Utilizar un campo calculado
Una vez creado correctamente un campo calculado, el Log Explorer se actualiza para:
- Mostrar los campos calculados activos en una nueva fila directamente debajo de la barra de búsqueda.
- Pasar el ratón por encima de un campo para ver su definición y utilizar acciones rápidas para editar, filtrar o agrupar por el campo.
- Incluir una columna para el campo calculado en la visualización Lista. El título incluye el prefijo #.
- Mostrar los campos calculados en una sección separada dentro del panel lateral del log.
Los campos calculados función como atributos de log y pueden utilizarse para la búsqueda, agregación, visualización y definición de otros campos calculados. Recuerda utilizar el prefijo #
cuando hagas referencia a nombres de campos calculados.
Casos de uso
Los campos calculados no sustituyen a los pipelines y procesadores de logs para el parseo a la hora de la ingesta, la normalización y el enriquecimiento de logs. Utiliza campos calculados en los siguientes casos:
- Si necesitas realizar una investigación puntual o un análisis ad hoc que requiere un campo que no necesitas reutilizar a largo plazo.
- Si necesitas actualizar retroactivamente logs indexados para responder a una determinada pregunta (los cambios en los pipelines sólo se aplican a logs ingeridos después de una actualización de pipeline).
- Si careces de los permisos (o conocimientos) necesarios para modificar oportunamente los pipelines de log.
- Los campos calculados que creas sólo son visibles para ti, lo que los hace ideales para una exploración rápida y una experimentación sin preocupaciones.
Si te das cuenta de que un campo calculado puede ser valioso a largo plazo, actualiza tus pipelines de log para que tu y el resto del equipo puedan beneficiarse del proceso automatizado.
Referencias adicionales
Más enlaces, artículos y documentación útiles: