Acción Registrar en el servidor

La acción Registrar en el servidor introduce de forma nativa la capacidad de registro para Tareas API. Esta acción permite crear registros personalizados y enviarlos junto con los registros de tiempo de ejecución de Tarea API a cualquier servidor de gestión de información y eventos de seguridad (SIEM) configurado en la Control Room.

Resumen

El Registrar en el servidor permite verificar los registros de tiempo de ejecución de Tareas API al reenviar los registros a un servidor SIEM. También puede crear registros personalizados y enviarlos junto con los registros de tiempo de ejecución. Anteriormente, Tareas API no permitía reenviar registros debido a restricciones en la capacidad de manejo de archivos.

El reenvío de los registros a un servidor SIEM proporciona una vía centralizada para verificar los datos de tiempo de ejecución de la automatización y depurar cualquier error que pueda producirse durante la ejecución de la automatización. Puede aprovechar las capacidades de generación de informes y análisis de las herramientas disponibles en el servidor SIEM para analizar y gestionar los registros. Además, puede conservar los registros en el servidor según los requisitos organizacionales para auditorías de cumplimiento y regulación.

Asegúrese de ajustar la configuración de integración para SIEM antes de usar la acción Registrar en el servidor en una automatización. Para obtener más información sobre cómo establecer la configuración de integración de SIEM, consulte Configurar la integración en SIEM.

El registro personalizado reenviado contiene los siguientes parámetros:
Parámetro Descripción
logMessage El mensaje de registro contiene el encabezado para el contenido del registro.
executionId La identificación de ejecución de la automatización. La identificación de ejecución aparece en la URL cuando abre la página Actividad de la automatización.
logLevel El nivel de registro que establece al configurar la acción.
sysLogSource La etiqueta de fuente de datos que estableció al configurar la acción. La etiqueta sirve como identificador para los registros.
botName El nombre que ingresó al crear la automatización.
botId La identificación del bot de la automatización. La identificación del bot aparece en la URL cuando abre el bot en el espacio de trabajo del editor de bots.
logCreatedTime El momento en que creó la automatización. Esta entrada incluye la fecha y la hora.

Configuración

  • Texto para registrar: Ingrese un nombre para el encabezado del registro. El parámetro logMessage muestra el encabezado del registro. La longitud máxima de texto permitida es de 1024 caracteres.
  • Puede exportar la información configurada de las variables de la automatización con la opción Variables para registrar. La acción Registrar en el servidor es compatible con variables de String, Número, Fecha y hora y Booleano. Las variables y sus respectivos valores predeterminados también aparecen en el parámetro logMessage.

    Elija una de las siguientes opciones:

    • Por tipo: Use esta opción para registrar variables según el tipo. Puede registrar las variables individualmente o juntas.
      Nota: Cuando se selecciona la opción Por tipo, también se pueden registrar las variables que se crean posteriormente después de haber añadido la acción Registrar variables en el archivo.
    • Selección personalizada: Use esta opción para seleccionar y registrar las variables individualmente o juntas.
  • Etiqueta de fuente de datos (opcional): Agregue etiquetas para identificar las entradas del registro. Las etiquetas permiten un fácil filtrado de los registros en el servidor SIEM. La etiqueta de origen de datos aparece en el parámetro sysLogSource.
  • Nivel de registro: Seleccione un nivel apropiado para la información del registro según los requisitos. El nivel de registro aparece en el parámetro logLevel. Los siguientes niveles de registro están disponibles:
    • Emergencia
    • Error
    • Advertencia
    • Información
    • Depurar

Resolución de problemas

La acción Registrar en el servidor solo está disponible en Tareas API y no en Bots de tarea.

Para probar su Tarea API que contiene Registrar en el servidor, si usa la opción Depurar disponible en la página del editor de la Tarea API, verá el siguiente error: Error inesperado al implementar el bot. Este error ocurre debido al objetivo de agente incompatible. Durante la depuración, las Tareas API se ejecutan en el bot runner local, que busca un agente de bot de Windows o macOS. Mientras que el objetivo del agente para una acción Registrar en el servidor no tiene supervisión. Esta discrepancia en el objetivo del agente causa la incompatibilidad.

Para probar su automatización, guarde la automatización y ejecútela usando la opción Ejecutar tarea API disponible en el menú de puntos suspensivos en la página del repositorio Privado.