Extensión de VSCode para el análisis visual de ISCLOGs

Los ISCLOGs son una herramienta útil de depuración proporcionada con IRIS que os puede ayudar a solucionar muchos tipos de problemas. Para obtener más información sobre cómo generar estos registros, consultad la siguiente documentación de IRIS: "Logging".

Este registro se escribe en el global ^ISCLOG almacenado en el espacio de nombres %SYS. Cada nodo de esta global representa un evento independiente, y en algunos casos, se registra información adicional en los subnodos.

Cada entrada consiste en una lista con los siguientes campos: ID, Categoría, Nivel de Registro (LogLevel), Mensaje, Espacio de Nombres, ID de Proceso, Rutina, ID de Sesión, Etiqueta y Hora de Adición. Para más detalles sobre los distintos campos, consultad la sección "Fields in the Log" en la documentación de IRIS.

Aunque esta herramienta proporciona información valiosa, también genera muchas entradas, lo que puede dificultar su interpretación. Para facilitar su lectura, he creado una extensión para VSCode que mejora la visualización de dos maneras:

1) Al exportar un ISCLOG a VSCode, podéis utilizar funciones integradas como la comparación de archivos.  

2) La utilidad incluye resaltado sintáctico para facilitar la identificación de los diferentes campos.

Instalación:

1. En VSCode, buscad la extensión "Pretty ISCLOGs" o utilizad el siguiente enlace: Pretty ISCLOGs en Visual Studio Marketplace
2. Seleccionad el botón de instalar para cargar la extensión.
3. Seguid los pasos a continuación para exportar y visualizar un ISCLOG:

Uso:

1. En el ObjectScript Shell, navegad al espacio de nombres "%SYS".
2. Ejecutad el siguiente comando para especificar un nombre de archivo (podéis usar cualquier nombre, siempre que tenga la extensión ".isclog"):

set file = <filepath>/filename.isclog

ie: set file="C:/ISCLOGs/myISCLOG.isclog"

3. Ejecutad el siguiente comando para exportar el global ^ISCLOG al archivo:

Open file: "wns" use file zw ^ISCLOG close file

4. Abrid el archivo en VSCode para visualizar el registro.

Aquí tenéis un ejemplo de captura de pantalla utilizando el tema de color InterSystems Default Dark Modern:

Limitaciones:

Debido a cambios en el almacenamiento de los ISCLOGs, esta utilidad solo funcionará con versiones más recientes (generalmente, versiones de IRIS desde 2018 en adelante).

He probado esto utilizando los estilos visuales proporcionados en la extensión InterSystems ObjectScript. La utilidad usa los colores de los tokens de VSCode. Los colores exactos dependerán del tema visual que tengáis aplicado, por lo que la legibilidad puede variar según el tema elegido.