Registro

El objetivo del registro de diagnóstico es que haya más información disponible a medida que se ejecuta la aplicación. Los errores y las advertencias registrados pueden ayudar a detectar errores dentro del sistema que podrían no ser inmediatamente obvios para un usuario final. Se puede habilitar temporalmente un registro más detallado para proporcionar una ilustración útil de cómo se está comportando una aplicación al resolver un problema.

Blue Prism utiliza una biblioteca probada y confiable llamada NLog para generar y registrar información de registro. Un administrador puede ajustar la cantidad de información registrada, ya sea de forma global o en áreas específicas de la aplicación.

Niveles de registro

Las entradas del registro se categorizan por nivel. Las entradas con un nivel de Información o superior suelen registrarse como estándar. Los niveles más bajos y detallados, como Depuración y Seguimiento, proporcionan información más detallada, pero deben habilitarse.

NLog define los siguientes niveles:

  • Seguimiento: registros muy detallados, que pueden incluir información de alto volumen, como cargas útiles de protocolos. Este nivel de registro suele habilitarse solo durante el desarrollo.
  • Depuración: información de depuración, menos detallada que Trace, generalmente no habilitada en entornos de producción debido a un posible impacto en el rendimiento.
  • Información: mensajes de información que normalmente se habilitan en entornos de producción.
  • Advertencia: mensajes de advertencia, generalmente para problemas no críticos, que pueden recuperarse o que son fallas temporales.
  • Error: mensajes de error; la mayoría de las veces son excepciones.
  • Fatal: errores muy graves.

Configuración de registro estándar

Los niveles de registro se definen dentro del archivo appsettings.json en la carpeta de instalación para cada sitio web y servicio. Para las instalaciones predeterminadas, estas carpetas se encuentran en C:\\Archivos de programa (x86)\\Blue Prism\\.

No es necesario que modifique usted mismo la configuración de registro en el archivo appsettings.json durante el uso normal. El soporte técnico al cliente de Blue Prism proporcionará una configuración de registro alternativa al investigar un problema con el producto. Si la configuración de registro se cambia en el archivo appsettings.json, el sitio deberá reiniciarse dentro de IIS.

Modificar la configuración de registro puede afectar el desempeño de la aplicación, y se debe tener especial cuidado si se modifica en un entorno de producción.

La configuración predeterminada escribe las entradas de registro a nivel de Información y superior (incluidas advertencias, errores y errores fatales) en el archivo de registro. Los archivos de registro se escriben en el directorio especificado en la configuración de LogsFolder en el archivo appsettings.json; por lo general, se establece en ./Logs_{Application}, por ejemplo: ./Logs_Hub o ./Logs_Interact.

De manera predeterminada, la configuración de registro del archivo appsettings.json es la siguiente:

Copiar 
"Logging": {
      "LogsFolder": "./Logs_{Application}",
      "LogLevel": {
        "Default": "Information",
        "System": "Warning",
        "Microsoft": "Warning"
      }
    },

Se generan archivos de registro independientes en función del nivel de registro y la fecha, y estos se reflejan en el nombre del archivo de registro, como warns.2021-05-07 o infos.2021-05-07.

A continuación, se muestra un ejemplo de una línea de un archivo de registro de información:

[08:58:11.4549] Connect.Core.Actions.UpdateCacheActione - Se actualizó la cache de widgets

El formato de este texto contiene los siguientes elementos:

  • Hora (usando la zona horaria establecida en el servidor): la fecha se refleja en el nombre del archivo.
  • Nombre del registrador: por lo general, identifica la clase y el espacio de nombre desde el cual se origina la entrada del registro.
  • El mensaje de registro.
  • Información de error: solo está disponible si se registra información de excepción. Los detalles completos se registran en una línea separada debajo del mensaje de registro.

Configuración de registro adicional

Blue Prism ha desarrollado ajustes de configuración de registro adicionales que se pueden agregar al archivo appsettings.json adecuado con el fin de capturar la actividad de ciertos componentes.

Depuración de LDAP

Puede configurar el registro para depurar los problemas que puedan surgir durante la sincronización de Hub con LDAP. Necesitará configurar el inicio de sesión en el archivo appsettings.json de Authentication Server antes de sincronizar los usuarios en la interfaz de usuario de Hub.

  1. En el servidor, navegue hasta la carpeta Authentication Server. De manera predeterminada, se encuentra en C:\Program Files (x86)\Blue Prism\.
  2. Abra el archivo appsettings.json en un editor de texto.

  3. Ubique la sección Registro y agregue \"ImsServer.IntegrationServices.Services.LdapConnectionService\": \"Debug\" en la sección LogLevel e inserte una coma al final de la línea anterior, por ejemplo:

    Copiar 
    "Logging": {
          "LogsFolder": "./Logs_AuthenticationServer",
          "LogLevel": {
            "Default": "Information",
            "System": "Warning",
            "Microsoft": "Warning",
            "ImsServer.IntegrationServices.Services.LdapConnectionService": "Debug"
          }
        },
  4. Guarde el archivo.

  5. Recicle el grupo de Authentication Server en los grupos de aplicaciones de IIS.

    Si actualizó desde una versión anterior a 4.3, deberá reciclar el grupo de IMS.

  6. Reinicie el sitio de Authentication Server en los sitios de IIS.

Esto crea un archivo con el prefijo “debug” y la fecha adecuada en el directorio Logs_AuthenticationServer.

Después de resolver correctamente cualquier problema utilizando la información de depuración, debe eliminar esta línea y la coma, guardar el archivo y repetir los pasos 5 y 6. De lo contrario, el archivo de registro aumentará mucho en tamaño y podría llenar la memoria.

Servicio de recolector de registros

Este servicio de Windows elimina los registros de productos antiguos de cada componente del servidor web (Hub, Interact, Authentication Server , Audit Service, Oyente del servicio de auditoría, Email Service, Servicio de recolector de registros, IADA, Remote API de Interact, SignalR, Submit Form Manager). Este servicio está programado para hacerlo el 7 de cada mes y los registros se mueven a C:\Archivos de programa (x86)\Blue Prism\ArchivedLogs.

Puede cambiar la ruta de la carpeta de registro archivada y la fecha del programador dentro de apppsettings.json. “ArchivedFolder” en C:\Program Files (x86)\Blue Prism\Log Service (valor predeterminado) le permitirá cambiar la ruta de archivo y “DayOfMonth” le permitirá cambiar la fecha del programador.

Más información

Los siguientes enlaces pueden proporcionar información adicional útil: