Introducción

La Management Console (MC) cuenta con un sistema de trazado para capturar errores e interacciones que ocurren durante la ejecución de apps. Este sistema mejora la visibilidad de errores y permite una supervisión eficiente de las respuestas del servicio OData a través del MC.

Escenarios de Uso

•Registro en tiempo real de advertencias y errores: Permite a los desarrolladores y administradores monitorear el estado de las aplicaciones.

•Registro centralizado: Las trazas se agrupan bajo la categoría Apps en MC, permitiendo un fácil filtrado.

Configuración

Para habilitar el trazado, siga estos pasos en el MC:

1.Navegue a: Seguimiento > Configuración.

AppTracing_00

2.Seleccione el nivel de registro:

•Error: Solo registra errores del sistema.

•Warning (Advertencia): Registra errores generados en el editor.

•Information (Información): Captura errores y advertencias.

AppTracing_01

Detalles Específicos sobre Configuración

•Si solo está habilitado Error, solo se registrarán los errores.

•Warning también incluye los errores generados por el editor.

•Para publicación, si está habilitada Information, también se registran las respuestas del endpoint OData.

•Si está configurado solo como Error, no se guardan las respuestas OData.

Esta configuración permite ajustar el nivel de detalle en el trazado según las necesidades del proyecto.

Nota: actualmente, solo se almacenan registros Error e Information; los registros Warning no se almacenan por ahora.

Tipos de Registros

Hay cuatro tipos diferentes de registros:

1.BATrace_Editor_AppsEditorError_[Fecha]

2.BATrace_Editor_[NombreAplicación]_[Fecha]

3.BATrace_Publication_[NombreAplicación]_[Fecha]

4.BATrace_Publication_Odata_[NombreAplicación]_[Fecha]

Los campos [NombreAplicación] y [Fecha] son generados automáticamente por Bizagi según las especificaciones aplicativas.

Tenga en cuenta que las trazas BATrace_Publication_Odata_[NombreAplicación]_[Fecha] aparecen solo para registros Information.

Errores comunes y posibles solución

Mensaje	Causa	Solución
An item with the same key has already been added	•Problema de items duplicados	1.Envíe un ticket.
String was not recognized as a valid DateTime	•Formato de fechas erróneos en las peticiones a OData	1.Envíe un ticket.
Object reference not set to an instance of an object	•Error al intentar acceder a una colleccion sin permisos.	1.Valide los permisos del usuario. 2.Envíe un ticket.
An error has occurred in the OAuth service	•Error en llaves de OAuth.	1.Valide los permisos de usuario. 2.Verifique las claves OAuth.
Error getting image from catalog	•La imagen solicitada no existe en el catálogo. •Problemas de conexión al servicio que administra el catálogo. •Permisos insuficientes para acceder al recurso solicitado.	1.Verifique que la imagen exista en el catálogo. 2.Revise los permisos y la conexión al servicio. 3.Valide la URL utilizada.
Error adding trace in Azure	•Error al configurar los índices para el almacenamiento de trazas. •La clave de autenticación para el servicio Azure no es válida. •Problemas de conectividad con Azure.	1.Valide la configuración del índice y la estructura de trazas. 2.Confirme las credenciales de acceso a Azure. 3.Verifique la conectividad con el servicio de Azure.
Error executing OptimizeSite	•Variables no inicializadas antes de la optimización del sitio. •Configuraciones faltantes en los parámetros de entrada. •Operaciones concurrentes en conflicto durante la optimización.	1.Asegúrese de que todos los parámetros requeridos estén inicializados. 2.Revise el proceso de optimización para manejar la concurrencia. 3.Verifique la configuración del sitio.
Error executing controls link resources	•Recursos necesarios no encontrados o no enlazados correctamente. •Problemas de permisos para acceder a los recursos externos. •Error en la configuración de los controles.	1.Asegúrese de que los recursos estén disponibles y correctamente referenciados. 2.Valide los permisos de acceso. 3.Revise las configuraciones de control y la lógica de enlace.
PagesManager.CreateMatrixPages: Cannot perform runtime binding on a null reference	•Variables o configuraciones nulas utilizadas en el proceso de creación. •Falta de inicialización de los objetos requeridos.	1.Asegúrese de que las variables estén inicializadas antes de su uso. 2.Valide los datos y objetos requeridos antes de continuar.
SitesManager.CreateAppExperienceMatrix: Cannot perform runtime binding on a null reference The matrix-related object was not initialized.	•El objeto relacionado con la matriz no fue inicializado. •Parámetros de entrada incompletos o incorrectos.	1.Verifique que todos los objetos estén inicializados. 2.Valide los parámetros de entrada antes de la ejecución.
Bizagi.Cloud.Sites.Services.Exceptions.SitesBizagiInternalErrorException Internal failure in Bizagi service logic.	•Fallo interno en la lógica de los servicios de Bizagi. •Configuraciones incorrectas en los servicios de nube.	1.Revise los registros de logs para identificar la causa específica. 2.Verifique las configuraciones de los servicios en la nube.
Bizagi.Cloud.Sites.Services.Exceptions.SitesInvalidTokenException	•Token de autenticación inválido o expirado. •Error en la generación o envío del token.	1.Valide la generación y expiración del token. 2.Asegúrese de que el cliente esté utilizando el token correcto.
System.ArgumentNullException	•Se pasó un argumento nulo a un método que no lo permite. •Variables no inicializadas.	1.Valide los argumentos antes de llamar métodos críticos. 2.Implemente controles para manejar valores nulos.
System.FormatException	•Entrada en un formato inesperado o incorrecto. •Intento de conversión de datos incompatible.	1.Asegúrese de que las entradas sigan el formato esperado. 2.Implemente manejo de excepciones para datos incompatibles.
System.InvalidCastException	•Conversión no válida entre tipos de datos. •Uso de un tipo inadecuado en una operación.	1.Revise las conversiones de tipo explícitas en el código. 2.Implemente validaciones para garantizar la compatibilidad de tipos.
System.InvalidOperationException	•Operación no válida en el estado actual del objeto. •Acceso concurrente no controlado.	1.Revise los estados de los objetos antes de realizar operaciones. 2.Sincronice adecuadamente las operaciones concurrentes.
System.NullReferenceException	•Se intentó acceder a un objeto que no fue inicializado.	1.Valide que los objetos estén inicializados antes de acceder a ellos. 2.Implemente verificaciones para evitar referencias nulas.
Microsoft.AspNetCore.Server.Kestrel.Core.BadHttpRequestException	•Solicitudes HTTP mal formadas o incompletas.	1.Valide las solicitudes antes de enviarlas al servidor. 2.Revise el manejo de errores en las solicitudes.
Newtonsoft.Json.JsonReaderException	•JSON con errores de sintaxis. •Campos inesperados en el JSON de entrada.	1.Valide el JSON con herramientas específicas antes de procesarlo. 2.Implemente manejo de excepciones para JSON mal formado.

Mensaje

Causa

Solución

An item with the same key has already been added

•Problema de items duplicados

1.Envíe un ticket.

String was not recognized as a valid DateTime

•Formato de fechas erróneos en las peticiones a OData

1.Envíe un ticket.

Object reference not set to an instance of an object

•Error al intentar acceder a una colleccion sin permisos.

1.Valide los permisos del usuario.

2.Envíe un ticket.

An error has occurred in the OAuth service

•Error en llaves de OAuth.

1.Valide los permisos de usuario.

2.Verifique las claves OAuth.

Error getting image from catalog

•La imagen solicitada no existe en el catálogo.

•Problemas de conexión al servicio que administra el catálogo.

•Permisos insuficientes para acceder al recurso solicitado.

1.Verifique que la imagen exista en el catálogo.

2.Revise los permisos y la conexión al servicio.

3.Valide la URL utilizada.

Error adding trace in Azure

•Error al configurar los índices para el almacenamiento de trazas.

•La clave de autenticación para el servicio Azure no es válida.

•Problemas de conectividad con Azure.

1.Valide la configuración del índice y la estructura de trazas.

2.Confirme las credenciales de acceso a Azure.

3.Verifique la conectividad con el servicio de Azure.

Error executing OptimizeSite

•Variables no inicializadas antes de la optimización del sitio.

•Configuraciones faltantes en los parámetros de entrada.

•Operaciones concurrentes en conflicto durante la optimización.

1.Asegúrese de que todos los parámetros requeridos estén inicializados.

2.Revise el proceso de optimización para manejar la concurrencia.

3.Verifique la configuración del sitio.

Error executing controls link resources

•Recursos necesarios no encontrados o no enlazados correctamente.

•Problemas de permisos para acceder a los recursos externos.

•Error en la configuración de los controles.

1.Asegúrese de que los recursos estén disponibles y correctamente referenciados.

2.Valide los permisos de acceso.

3.Revise las configuraciones de control y la lógica de enlace.

PagesManager.CreateMatrixPages: Cannot perform runtime binding on a null reference

•Variables o configuraciones nulas utilizadas en el proceso de creación.

•Falta de inicialización de los objetos requeridos.

1.Asegúrese de que las variables estén inicializadas antes de su uso.

2.Valide los datos y objetos requeridos antes de continuar.

SitesManager.CreateAppExperienceMatrix: Cannot perform runtime binding on a null reference

The matrix-related object was not initialized.

•El objeto relacionado con la matriz no fue inicializado.

•Parámetros de entrada incompletos o incorrectos.

1.Verifique que todos los objetos estén inicializados.

2.Valide los parámetros de entrada antes de la ejecución.

Bizagi.Cloud.Sites.Services.Exceptions.SitesBizagiInternalErrorException

Internal failure in Bizagi service logic.

•Fallo interno en la lógica de los servicios de Bizagi.

•Configuraciones incorrectas en los servicios de nube.

1.Revise los registros de logs para identificar la causa específica.

2.Verifique las configuraciones de los servicios en la nube.

Bizagi.Cloud.Sites.Services.Exceptions.SitesInvalidTokenException

•Token de autenticación inválido o expirado.

•Error en la generación o envío del token.

1.Valide la generación y expiración del token.

2.Asegúrese de que el cliente esté utilizando el token correcto.

System.ArgumentNullException

•Se pasó un argumento nulo a un método que no lo permite.

•Variables no inicializadas.

1.Valide los argumentos antes de llamar métodos críticos.

2.Implemente controles para manejar valores nulos.

System.FormatException

•Entrada en un formato inesperado o incorrecto.

•Intento de conversión de datos incompatible.

1.Asegúrese de que las entradas sigan el formato esperado.

2.Implemente manejo de excepciones para datos incompatibles.

System.InvalidCastException

•Conversión no válida entre tipos de datos.

•Uso de un tipo inadecuado en una operación.

1.Revise las conversiones de tipo explícitas en el código.

2.Implemente validaciones para garantizar la compatibilidad de tipos.

System.InvalidOperationException

•Operación no válida en el estado actual del objeto.

•Acceso concurrente no controlado.

1.Revise los estados de los objetos antes de realizar operaciones.

2.Sincronice adecuadamente las operaciones concurrentes.

System.NullReferenceException

•Se intentó acceder a un objeto que no fue inicializado.

1.Valide que los objetos estén inicializados antes de acceder a ellos.

2.Implemente verificaciones para evitar referencias nulas.

Microsoft.AspNetCore.Server.Kestrel.Core.BadHttpRequestException

•Solicitudes HTTP mal formadas o incompletas.

1.Valide las solicitudes antes de enviarlas al servidor.

2.Revise el manejo de errores en las solicitudes.

Newtonsoft.Json.JsonReaderException

•JSON con errores de sintaxis.

•Campos inesperados en el JSON de entrada.

1.Valide el JSON con herramientas específicas antes de procesarlo.

2.Implemente manejo de excepciones para JSON mal formado.

Otros errores

Cuando vemos valores como User: Anonymous o Route: Unknown, no significa que el sistema no los haya podido capturar. En cambio, el error ocurrió en un punto donde estos detalles aún no estaban disponibles. Esto puede deberse a procesos internos del servidor, interrupciones externas o tareas que no tienen un contexto HTTP asociado. Estos escenarios son normales y esperados dentro del diseño del sistema. Las posibles razones incluyen:

•Errores tempranos: La solicitud no alcanzó el punto en el que el sistema identifica los detalles.

•Procesos en segundo plano: No hay un usuario o una solicitud HTTP asociada.

•Fallas técnicas: Problemas de red o configuraciones incorrectas interrumpen el flujo normal.

Nombre	Causa	Consecuencia	Ejemplo
Errors in Early Stages of the Process	El sistema aún no ha identificado quién hizo la solicitud o qué recurso estaba siendo solicitado.	Campos como "Controller" o "Action" no pueden determinarse porque la solicitud nunca llegó a esa parte del sistema.	Ocurre un error de configuración antes de que la solicitud alcance el módulo responsable de asignar controladores y acciones.
Errors in Background Services	Algunos procesos se ejecutan en segundo plano y no están directamente vinculados a una solicitud de navegador.	No hay un usuario o solicitud HTTP asociada para registrar, por lo que los valores aparecen como "Desconocido".	Una tarea automatizada intenta procesar datos sin intervención del usuario.
Connection Interruptions	La comunicación entre el cliente (por ejemplo, navegador) y el servidor se interrumpe antes de completar la solicitud.	Los detalles sobre el controlador, acción o ruta no se completan en el sistema.	La red del cliente falla mientras intenta cargar una página.
Background Threads (Deep Threads)	En ciertos casos, el sistema mueve la ejecución a un hilo independiente (un proceso separado) para manejar la carga de trabajo o realizar tareas más rápido.	El contexto HTTP, que contiene información como usuario, ruta y método, no se transfiere a los hilos en segundo plano.	El servidor delega la carga de datos a otro proceso para evitar bloquear la solicitud principal.
Issues in Middleware or Configuration	Un middleware, responsable de procesar solicitudes en varias etapas, está mal configurado o lanza una excepción.	Un middleware diseñado para registrar usuarios no se activa, por lo que el sistema no reconoce al usuario.	El sistema no puede capturar detalles críticos como la identidad del usuario o la dirección IP.
Critical System Exceptions	Ocurre una falla grave en el servidor, como agotamiento de memoria o un error en la base de datos.	El sistema no puede registrar detalles adicionales porque está ocupado manejando la falla.	El servidor no puede responder porque se ha quedado sin recursos disponibles.

Ejemplo de Log de uno de este tipo de errores.

AppTracing_02

Tenga en cuenta que, para solucionar otros errores, es necesario enviar un ticket.

Last Updated 5/16/2025 10:24:28 AM

Trazas para Apps