Configuración de Traces

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Interfaz de Bizagi Studio en detalle > Ajustes avanzados >

Configuración de Traces

Introducción

Durante las fases de automatización de los procesos, hay ciertos escenarios en los que desea rastrear o hacer seguimiento a la ejecución de sus procesos.

 

Bizagi ofrece la posibilidad de hacer rastreo de los errores en los flujos de procesos (para su control y diagnóstico), de modo que usted pueda validar si las reglas del negocio, validaciones, invocaciones interfaces, o incluso el proceso necesita ser afinado.

 

Para el control de errores de un proyecto, Bizagi presenta su configuración de Rastreo o Traces.

Esta es una opción poderosa para ayudar a la comprensión y la detección de aquellos comportamientos que requieren un ajuste, o para garantizar que el proceso funcione como se espera.

Tenga en cuenta que los traces no deben dejarse habilitados todo el tiempo, y que por el contrario se recomienda que se habiliten solo temporalmente para obtener detalle adicional cuando se necesite.

 

¿Cómo funcionan los traces?

Los Traces supervisan el proceso en varios niveles, tales como: el proceso y actividades, las reglas de negocio, validaciones y políticas de negocio, invocaciones interfaces y Formas (con sus campos).

En otras palabras, es posible realizar el seguimiento de todo el proceso y sus objetos / componentes que hacen parte del Portal de Trabajo.

 

Para activar y configurar los Traces, puede habilitar cada objeto / componente por separado y establecer un filtro para que los registros generados incluyan ciertos niveles de detalle (por ejemplo, las advertencias y los errores, o errores solamente).

 

Los pasos para esto son:

1. Reconocer cuales son los Traces que se deben activar (de los distintos objetos y componentes).

2. Definir sus detalles del Trace.

 

note_pin

Adicional al detalle del trace, se recomienda revisar los eventos y logs de su servidor, ya sea para WebSphere, Weblogic, JBoss o IIS. Estos logs lo ayudarán a encontrar el detalle del error cuando se encuentre depurando su proceso.

 

1. Reconocer qué Traces activar

Para habilitar los Traces en una fase de automatización, utilice la opción Tracing desde Bizagi Studio:

 

 

tracing00_bas

 

note_pin

Tenga en cuenta que la función de Traces para el uso de troubleshooting (debug) está orientada principalmente al entorno de desarrollo.

Es muy recomendable aprovechar esta característica mientras se realizan las pruebas de los procesos a fin de que en el entorno de producción sólo las utilice si es estrictamente necesario.

Por ejemplo, cuando un servicio Web externo ha cambiado y no hubo consideraciones a este cambio frente a la configuración en Bizagi, puede ser útil habilitar los Traces en el ambiente de producción para ayudar a detectar comportamientos no deseados.

 

Al abrir la ventana de configuración de rastreo (Traces), ya sea desde Bizagi Studio o desde el Management Console, verá los objetos y componentes disponibles:

 

WSTrace_all

 

Es importante reconocer y planificar qué Traces desea habilitar.

La siguiente tabla describe las posibilidades:

 

 

ELEMENTO

DESCRIPCIÓN

Autenticación

Registra cuando un usuario se está autenticando en el Sistema (Petición de Usuario) y cuando el Sistema revisa automáticamente las Solicitudes de Sesión (Validación de Solictud de Sesión). Todos los detalles incluyendo fecha, nivel, nombre de la traza, tipo y sub-tipo de la traza, tipo y sub-tipo de la autenticación y mensaje, son añadidos al archivo de texto.

Connectors / WS Connector

Registra cuando una interfaz externa se invoca. Rastrea las peticiones y respuestas.

Para más información sobre como los Traces para la invocación de servicios web, consulte los Traces para el WS Connector.

Connectors / SAP

Registra cuando una BAPI de SAP se invoca. Rastrea los parámetros de Importación y Exportación.

Para más información sobre como los Traces para la invocación de BAPIs de SAP, consulte los Traces para SAP.

Conectores / Conectores Externos

Registra cuando una Acción de Conector es ejecutada. Esta opción rastrea Inputs, Outputs, transformación de los datos y lógica del Conector.

EntityManager

Registra la ejecución de EntityManager (acceso de base de datos).

LDAP

Registra la ejecución de la sincronización programada de usuarios de LDAP en Bizagi.

Render

Registra la construcción Formas en el Portal de Trabajo (y sus campos).

Reglas y expresiones

Registra la ejecución y la evaluación de las reglas de negocio y políticas.

Los Traces en reglas son personalizados use la función CHelper.trace

Scheduler

Registra la ejecución de los trabajos programados.

Workflow

Registra cuando comienza una transacción, cuando la información se guarda en la base de datos, cuando un caso se crea y la ejecución de cada elemento.

 

Cuando la asignación está seleccionada, registra la ejecución de reglas de asignación.

 

La imagen a continuación presenta la totalidad de traces disponibles de Bizagi:

 

WSTrace_all_a

 

2. Definir el detalle de los Traces

Con el fin de decidir lo se desea rastrear (el nivel de detalle), en la opción seleccionada en el menú de rastreo, haga clic en el tipo de rastreo y defina el nivel de detalle (Error, Advertencia, todo).

 

tracing02_step2

 

Por defecto está seleccionado Apagado (una caja vacía se muestra) para todos los objetos / componentes.

 

Cuando Error es seleccionado, el archivo de rastreo sólo registra los errores.

Cuando Advertencia se selecciona, el archivo de rastreo rastreará advertencias y errores.

Cuando Todo está seleccionado, el archivo de rastreo registrará: advertencias, errores y paso a paso la información sobre los comandos ejecutados.

 

Tenga en cuenta que puede seleccionar cada tipo de rastreo (y sus subtipos) y seleccionar una configuración de detalle de seguimiento para cada uno.

 

Después de guardar los cambios en estos elementos, debe reiniciar el servicio de su servidor Bizagi (p.ej. IISreset en IIS).

 

 

Ubicación de los Traces

Una vez activado, los Traces se guardan como archivos de texto sin formato en el servidor Bizagi.

Ellos estarán ubicados en una ruta diferente, de acuerdo con el servidor web específico y la aplicación utilizada como servidor Bizagi.

 

ELEMENTO

UBICACIÓN

Authentication

C:\Bizagi\Projects\[project_name]\Trace\

EntityManager

LDAP

Render (Control)

Rules

Scheduler

Workflow

Connectors - WS Connector

C:\Bizagi\Projects\[project_name]\Temporary\SOA\

 

For Asynchronous SOA Interfaces configured to retry on fail, the traces of each retry will be located in:

 

C:\Bizagi\Projects\[project_name]\Temporary\Scheduler\SOA\

Connectors - SAP

C:\Bizagi\Projects\[project_name]\Temporary\SAP\

Connectors - External Connectors

C:\Bizagi\Projects\[project_name]\Temporary\Connectors\

 

 

Ejemplos y mayor información

Como se describió anteriormente, hay más de 1 tipo de objeto / componente para rastrear.

Lo siguiente describe los Traces más comúnmente usados.

 

Trace del Portal de Trabajo

El portal de trabajo graba unos logs con el detalle sobre lo que se ejecuta a nivel de aplicación (Web).

Estos logs se encuentran en la carpeta .\Trace como un archivo llamado BATrace_Web_[fecha].log.

 

El siguiente ejemplo ilustra la información que se graba en estos archivos:

 

BATrace_Web

 

Trace del Scheduler (Programador)

El servicio programador graba unos logs con el detalle sobre lo que ejecuta de manera offline.

Estos logs se encuentran en la carpeta .\Trace como un archivo llamado BATrace_Scheduler_[fecha].log.

 

El siguiente ejemplo ilustra la información que se graba en estos archivos:

 

BATrace_Scheduler

 

Traces en Expresiones (reglas de negocio)

Para esta opción, además de activar la opción de rastreo correspondiente y sus niveles, también es necesario incluir una línea de comando de seguimiento en el código de la expresión (reglas de negocio) que se desea rastrear.

Este enfoque generará un registro separado, para cualquier información que el usuario desea rastrear.

Para más información, consulte Validar mi regla de negocio.

 

Traces de autenticación

Cuando se integra un proveedor de identidad compatible con SAML para que Bizagi le delegue la autenticación, el detalle de traces incluye:

USERREQUEST: Provee un mensaje que aplica al momento en que Bizagi envía la información al proveedor de identidad (acerca de la solicitud hecha por el usuario para autenticarse).

VALIDATESESSIONREQUEST: Provee un mensaje que aplica al momento en que Bizagi recibe una respuesta del proveedor de identidad.

 

La siguiente imagen ilustra un ejemplo de traces de autenticación:

 

SAML_authtrace

 

 

Traces en conectores

Para más información sobre como los Traces para la invocación de servicios web, consulte los Traces para el WS Connector.

Para más información sobre como los Traces para la invocación de Conectores, consulte los Traces para conectores.

Para más información sobre como los Traces para la invocación de BAPIs de SAP, consulte los Traces para SAP.