Archivos de registro
Pega Platform™ escribe errores, advertencias y otra información en una colección de archivos de registro para ayudarlo a depurar y mantener el estado de la aplicación. Los System Architects revisan los archivos de registro para investigar problemas de la aplicación durante el desarrollo, y esto mejora la calidad de la aplicación. Los administradores de sistemas supervisan los archivos de registro para identificar potenciales problemas de sistemas o de la aplicación en la producción.
Archivos de registro para problemas de la aplicación
Los archivos de registro capturan notificaciones de eventos que van desde información de rutina sobre el estado del sistema hasta errores críticos que pueden generar la interrupción inesperada de la aplicación. Cada registro es gestionado por un appender (adicionador), que determina el tipo de evento escrito en el archivo de registro. Los archivos de registro disponibles varían según los adicionadores de archivo de registro configurados en las opciones del sistema.
Los siguientes archivos de registro son de uso común en los sistemas de Pega Platform:
- El registro de PEGA contiene advertencias, errores y mensajes informativos sobre operaciones internas. Este registro también se denomina “registro de consola” o “registro del sistema” y se utiliza para realizar un debugging de la aplicación.
- El registro ALERT contiene alertas relacionadas con el rendimiento que se disparan cuando una operación supera el umbral de rendimiento especificado.
- El registro ALERTSECURITY contiene alertas (identificadas por el prefijo SECU) que sugieren una configuración inadecuada de instalaciones del estándar Internet Application Composer, o bien intentos evidentes de evadir funciones de seguridad del sistema en el nodo de Pega Platform mediante adulteración de URL.
- El registro BIX contiene entradas generadas por Business Intelligence Exchange (BIX) durante operaciones de extracción. BIX es un producto complementario opcional que extrae datos de transacciones de la base de datos de Pega. Lo hace en formatos adecuados para la exportación en un depósito de datos de reportes, un almacén de datos operativos (ODS) u otros procesos subsiguientes.
- El registro SERVICES-PAL contiene datos de rendimiento guardados de servicios.
- El registro CLUSTER contiene información sobre la configuración y el comportamiento del tiempo de ejecución del clúster.
Nota: Pega Platform gestiona registros según los adicionadores configurados. Por ejemplo, para registrar datos de rendimiento para los servicios, usted agrega SERVICES-PAL en el archivo de configuración prlog4j2.xml para el nodo. Para obtener más información sobre las estadísticas de rendimiento para los servicios, consulte Visualización de estadísticas para servicios en el registro SERVICES-PAL.
Utilidades del registro
Puede acceder a los archivos de registro en la sección Log utilities de la pestaña Logs en Dev Studio (Configure > System > Operations > Logs) (Configurar > Sistema > Operaciones > Registros) para abrir las utilidades del registro. La sección Utilidades del registro incluye una lista de adicionadores de archivos de registro y un visor de registros externo. Al hacer clic en Log files (Archivos de registro), se muestra una lista de los adicionadores de archivos de registro que están activos en el sistema.
En la siguiente imagen, verá un ejemplo de cada adicionador, con un enlace para ver o descargar el archivo de registro como un archivo de texto sin formato o como un archivo comprimido .zip.
Nota: Descargar un archivo de registro requiere credenciales de administrador del servidor de aplicaciones que aloja Pega Platform. También puede ver archivos de registro mediante un visor de registros externo, como Kibana. Para obtener más información sobre la visualización de archivos de registro en un visor externo, consulte Visualización de archivos de registro en un visor de registros externo.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre la visualización del contenido de archivos de registro de .
PegaRULES Log Analyzer
La aplicación PegaRULES Log Analyzer (PLA) es una aplicación web independiente que los desarrolladores y los administradores de sistemas pueden utilizar para ver resúmenes consolidados de datos de registro del sistema.
Utilice la aplicación PLA para probar aplicaciones de Pega Platform nuevas o reconfiguradas durante las pruebas de aceptación de usuario (UAT) y de rendimiento y estrés, e inmediatamente después de la implementación en un entorno de producción. Probar las aplicaciones reconfiguradas durante las UAT y durante las pruebas de rendimiento, e inmediatamente después de la implementación es importante porque es más probable que los problemas de rendimiento, estabilidad y escalamiento se produzcan durante estos momentos.
La PLA consolida y resume los registros ALERT, PEGA y Garbage Collection (GC). Los datos del registro proporcionan información clave sobre el estado operativo y del sistema que los desarrolladores y los administradores de sistemas pueden utilizar para identificar, diagnosticar y abordar rápidamente los problemas de rendimiento.
Tip: La PLA está disponible en Marketplace en Pega Community. Para obtener más información sobre la PLA, consulte la descripción general de Pega Marketplace sobre PegaRULES Log Analyzer.
Anular la configuración del nivel del registro
Un administrador de sistemas puede anular la configuración del nivel del registro en Admin Studio para controlar los eventos de registro que se muestran en el registro de PEGA creando una categoría de registro.
En versiones anteriores de Pega Platform sin categorías de registro, la personalización de los registros se producía al actualizar los archivos prlogging.xml o prlog4j2.xml. Por cada evento del sistema, el archivo de configuración prlog4j2.xml define el umbral para determinar los eventos que se asentarán en los registros. Los eventos se registran únicamente para el nivel de registro seleccionado y niveles superiores. Por ejemplo, si un evento está configurado con el nivel ERROR, solo los eventos con nivel FATAL o ERROR se apuntan en el registro, mientras que los eventos INFO se omiten. En un sistema de Pega de varios nodos, puede crear archivos prlog4j2.xml separados para cada nodo.
Nota: Si actualiza su aplicación a la versión 8.7 de Pega Platform o una versión posterior, se recomienda mover las personalizaciones del nivel de registro a la categoría de registro I. Para obtener más información sobre la estructuración de mensajes de registro en categorías, consulte Creación de categorías de registro. Además, los rulesets y la jerarquía de clase son irrelevantes para el registro. Por ejemplo, si un adicionador incluye eventos de registro para una actividad denominada Data-Party.Research, y el sistema incluye varias actividades con ese nombre, las ejecuciones del nodo actual de cualquiera de estas actividades puede producir eventos de registro.
Tip: Al depurar una actividad, puede utilizar el método Log-Message con el nivel de registro configurado en InfoForced para agregar un evento al registro de PEGA independientemente de la configuración en el archivo prlog4j2.xml o la categoría de registro. Para reducir las entradas del registro y mejorar el rendimiento en los sistemas de producción, quite los pasos InfoForced o conviértalos en comentarios al finalizar el debugging de la actividad.
Compruebe sus conocimientos con la siguiente actividad:
This Topic is available in the following Module:
If you are having problems with your training, please review the Pega Academy Support FAQs.
¿Quiere ayudarnos a mejorar este contenido?