Diagnóstico y control de errores

<< Click to Display Table of Contents >>

Navigation:  Bizagi Engine > Administración del Sistema Bizagi > Mantenimiento y administración > Administración del entorno >

Diagnóstico y control de errores

Introducción

Durante las fases de desarrollo de un proyecto (al automatizar los procesos), o en el ambiente de producción, hay ciertos escenarios en los que puede desear para rastrear, o hacer seguimiento a la ejecución de sus procesos (también para depurar).

 

Bizagi ofrece la posibilidad de hacer rastreo de los errores en los flujos de procesos (para su control y diagnóstico), de modo que los administradores puedan 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.

 

MC_Configuration

 

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 (durante las pruebas).

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 detecta que los procesos no se comportan como se espera.

 

 

note_pin

Además de la posibilidad de consultar Bizagi traces, también se puede revisar el log del Servidor para Bizagi Engine.

 

En sistemas operativos Windows, Bizagi registrará logs de eventos en el Servidor (los cuales pueden revisarse en el visor de eventos).

 

 

¿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

La habilitación de Traces se realiza desde el Management Console (para un ambiente de pruebas o producción).

 

tracing01_mc

 

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

Conectores / 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 interfaces, consulte Diagnóstico y control de errores para servicios Web. Diagnóstico y control de errores para servicios Web.

Conectores / 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 interfaces, consulte Diagnóstico y control de errores para BAPIs de SAP. Diagnóstico y control de errores 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 Portal de trabajo (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 de Bizagi.

Ellos estarán ubicados en una ruta diferente, de acuerdo con la plataforma y el componente de Bizagi.

 

ELEMENTO

 

EntityManager

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

LDAP

Render (Control)

Rules (Reglas)

Scheduler (Programador)

Workflow (Flujo de proceso)

Connectors / WS Connector

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

 

Para Interfaces asíncronas de SOA configuradas para reintentos en fallos, las trazas de cada reintento quedarán en:

 

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

Connectors / SAP

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

 

La siguiente tabla ilustra dónde se encuentran los logs de acuerdo con el servidor.

 

SERVIDOR

LOG

RUTA

WebSphere

SystemErr.log, SystemOut.log, StartServer.log, y StopServer.log

<WEBSPHERE_HOME>\profiles\[NodeName]\logs\server1

Weblogic

AdminServer.log, [su_domino_Weblogic].log

<WEBLOGIC_HOME>\user_projects\domains\[USER_DOMAIN]\servers\log

JBoss

Server.log

<JBOSS_HOME>\standalone\log

IIS

Logs registrados por el visor de eventos

C:\inetpub\logs

 

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 en interfaces

Para más información sobre como los Traces para la invocación de interfaces, consulte Diagnóstico y control de errores para servicios Web. Diagnóstico y control de errores para servicios Web.

Para más información sobre como los Traces para la invocación de interfaces, consulte Diagnóstico y control de errores para BAPIs de SAP. Diagnóstico y control de errores para SAP.