Eurowin 8.

0 SQL Manual de

EW-LOG
Revisin de incidencias

Documento: Edicin: Nombre: Fecha:

me_ewlog 05 Manual de Ewlog 03-02-2011

Manual de Ewlog

Tabla de contenidos
1. Introduccin ........................................................................................................................... 2
1.1. Qu es el Registro de consultas SQL? ............................................................................................ 2 1.2. Qu es la tabla Error_log? ................................................................................................................ 3 1.3. Qu es el Registro de Transacciones? ............................................................................................ 3

2. Funcionamiento ...................................................................................................................... 4
2.1. Conexin con el servidor SQL ........................................................................................................... 4 2.2. Tabla Error_log ................................................................................................................................... 5 2.2.1. Pantalla de revisin de incidencias ................................................................................................ 6 2.3. Registro de consultas SQL ................................................................................................................ 6 2.3.1. Pantalla de registro de consultas .................................................................................................. 7 2.3.2. Opciones de depuracin, slo SQL .............................................................................................. 7 2.4. Registro de Transacciones ................................................................................................................. 8 2.4.1. Pantalla de registro de Transacciones .......................................................................................... 8

Manual de Ewlog

1. Introduccin
Ew_LOG.exe es un programa que permite realizar tres tipos de anlisis de los datos de Eurowin: 1. Del registro de consultas SQL 2. De la tabla Error_log 3. Del registro de transacciones Estos anlisis sirven por un lado para detectar problemas concretos en la instalacin de un cliente y por otro para depurar el programa permitiendo corregir posibles errores y optimizar las consultas que el programa lanza contra el servidor de SQL. El programa Ew_LOG.exe se encuentra en la carpeta Terminal del servidor de Eurowin.

1.1. Qu es el Registro de consultas SQL?

El registro de consultas SQL es una tabla libre llamada Registro, que el programa crea en la carpeta SQL dentro de la carpeta del terminal de Eurowin. Contiene todas las consultas que el programa ejecuta sobre el servidor de datos SQL desde el terminal. En las versiones del ao 2006 hay que marcar la opcin de empresa "Activar registro SQL" la cual afectaba a todos los terminales de Eurowin. Para activar el registro de consultas SQL en las versiones del 2007 y posteriores hay que aadir el siguiente parmetro en el fichero CONFIG.INI del terminal: [SQL_LOG] SI Contenido de las columnas de la tabla "Registro": FSQL: Instrucciones SQL que se han ejecutado desde Eurowin en el formato original tal y como estn escritas en el programa. MSQL: Instrucciones que se envan al servidor SQL despus de ser traducidas por el analizador. Tiempo: Informa del tiempo en segundos que ha necesitado la consulta en el servidor para devolver el resultado. IMPORTANTE: Para evitar que se sature el disco duro del terminal de Eurowin, slo se debe activar el registro de SQL durante la resolucin de incidencias de programa, resultado de funciones Valor en reports, lentitud en ejecucin de consultas, etc. En las versiones del programa Ew_log a partir de agosto de 2007 se puede configurar el tamao mximo de la tabla libre "Registro".

Manual de Ewlog

1.2. Qu es la tabla Error_log?

La tabla Error_log se encuentra en la base de datos Comunes. Contiene todas las instrucciones que por algn motivo han provocado una incidencia en el programa. Las consultas SQL que superan los 25 segundos de tiempo de ejecucin tambin se guardan en la tabla "Error_log" como consulta lenta. En las versiones del programa Ew_log a partir de agosto de 2007 se puede configurar el tiempo mximo para determinar las consultas lentas.

1.3. Qu es el Registro de Transacciones?

La finalidad del registro de Transacciones es determinar el origen de los bloqueos que puedan ocurrir. Est siempre activo y crea una tabla en la carpeta del servidor de Eurowin llamada Ewtransac.dbf. Aqu se registran todas las transacciones que se ejecutan desde Eurowin y cumplen alguna de las siguientes condiciones antes de realizar una instruccin COMMIT o ROLLBACK: Que supere los 30 segundos Que supere las 100 instrucciones enviadas al servidor Tiene vigencia a partir de las versiones de Eurowin compiladas en 2009.

Manual de Ewlog

2. Funcionamiento
El programa Ew_log.exe tiene cuatro apartados: Datos para realizar la conexin con el servidor de SQL o a travs de ODBC. Configurar el conjunto de datos que se van a analizar de la tabla Error_log. A continuacin se pueden configurar los datos a analizar del registro de consultas SQL. Por ltimo, permite visualizar el registro de transacciones.

Ilustracin 1. Pantalla inicial de Ew_log

A partir del mes de Enero de 2009 el programa Ew_log presenta el color de fondo de los campos de la pantalla principal de color verde para indicar que a partir de esta versin se pueden consultar los datos del servidor de datos Microsoft SQL Server 2008. Las versiones anteriores, de color azul, permiten conectar con el servidor de datos Microsoft SQL Server 2005.

2.1. Conexin con el servidor SQL

Opciones para la conexin con el servidor de datos de Eurowin: Tipo: Seleccionar el tipo de conexin segn el servidor de datos de Eurowin: o SQL: Para versiones de Eurowin 8.0 SQL. P.e. SQL Server 2005, SQL Server 2008

Manual de Ewlog

Apartados disponibles: Registro de Consultas, de Incidencias y de Transacciones DBF: Si la tabla Error_log es libre y pertenece a un servidor Eurowin (se aplica a antiguas versiones de Estndar 6.00). Apartados disponibles: Registro Incidencias. ODBC: Para versiones de Eurowin 6.0. Apartados disponibles: Registro de Consultas, de Incidencias. Ruta al terminal: Ruta al terminal de Eurowin de donde Ew_log obtiene la configuracin hacia el servidor. Comunes: Nombre de la base de datos de Comunes de la instalacin que se va a analizar. Botn Conectar: Realiza la conexin al servidor de SQL y abre la base de datos Comunes seleccionada. Botn Desconectar: Cierra la conexin con el servidor de SQL. El botn Salir cierra la aplicacin.

o o

2.2. Tabla Error_log

Configuracin de los datos a analizar de la tabla Error_log. Por defecto mostrara las 500 ltimas incidencias. Se aplica a los tipos de conexin SQL, DBF y ODBC. Botn Crear Ew-LOG: Permite crear la tabla Error_log en la base de datos Comunes del servidor de SQL, si no existe. Botn Vaciar Ew-LOG: Permite vaciar el contenido de la tabla Error_log. Filtros o Tipo: Incidencias de proceso: Muestra las incidencias no incluidas ni en incidencias de consulta, ni en consultas lentas, ni en bloqueos. Incidencias de consulta: Muestra slo las incidencias de las consultas. Consultas lentas: Muestra slo las consultas lentas. Todos: Muestra todos los tipos de incidencias. o Rango de fechas: Intervalo de fechas entre el que se realiza el anlisis. o Terminal: El anlisis se realiza slo del terminal seleccionado. o Usuario: El anlisis se realiza slo del usuario seleccionado. o Nro. de incidencia: Indica un cdigo de incidencia nico. o Buscar texto: Filtro del registro SQL por un texto dentro del campo seleccionado a continuacin. o Limitar Registros a: Nmero de registros a consultar, empezando por los ltimos. o Botn Limpiar Fechas: Borra las fechas introducidas en el filtro del intervalo de fechas. o Botn Limpiar Filtros: Borra los datos introducidos en los filtros. o Compactar: Muestra slo un registro por cada tipo o nmero de incidencia. o Ascendente, descendente, sin orden: Permite ordenar los registros de las incidencias en la pantalla. o Botn Borrar: Borra los registros de la tabla que coinciden con los filtros introducidos.

Manual de Ewlog

Botn Ver: Muestra por la pantalla los registros de la tabla que coinciden con los filtros introducidos. Botn Conf: Permite configurar el tiempo mximo en segundos para determinar las consultas lentas.

2.2.1. Pantalla de revisin de incidencias

En la pantalla de revisin de incidencias de la tabla Error_log hay una cuadrcula con las columnas siguientes: Terminal: Nombre del terminal que ha grabado la incidencia. Fecha/Hora: Fecha y la hora de la incidencia. Mensaje: Texto del mensaje. Nro. Incid.: Nmero o cdigo de la incidencia. Formulario: Formulario u opcin del programa en el que ha producido la incidencia. Tabla/Vista: Tabla o vista activa en ese momento. Proceso: Nombre del proceso que se estaba ejecutando. Lnea: Nmero de lnea en el cdigo del proceso. Usuario: Usuario de Eurowin. Despus hay un recuadro amarillo que contiene un resumen de la incidencia seleccionada en la cuadrcula con el terminal, da y hora, versin del programa, mensaje y nmero. Debajo hay otro recuadro amarillo que contiene la traza de la ejecucin del programa para la incidencia seleccionada. Esta informacin es til en el caso de que se tenga que depurar el programa. Con el botn "Imprimir" podemos imprimir la traza. El botn Ampliar muestra la traza completa en una nueva pantalla. Se pueden guardar los registros de la cuadrcula en una tabla libre cuyo nombre hay que introducirlo en el campo "Guardar resultado" y despus pulsar el botn Guardar. En la parte inferior de la pantalla se informa del tipo de filtro aplicado. Al marcar la opcin "Sealar Incidencias de consulta" stas se muestran de color salmn en la cuadrcula. Con el botn Actualizar se vuelve a realizar la consulta actualizando los datos de la cuadrcula. De esta forma, sin salir de la pantalla podemos analizar las ltimas incidencias ocurridas. Con el botn Salir volvemos a la pantalla inicial de la aplicacin.

2.3. Registro de consultas SQL

Se aplica a los tipos de conexin SQL y ODBC. Configuracin de los datos a analizar del registro de consultas SQL: Botn Conf: Permite configurar el tiempo mximo en segundos para determinar las consultas lentas, slo SQL. Botn Ver Registro SQL: Muestra los datos del registro segn las opciones de configuracin.

Manual de Ewlog

ltimos 500, 1000, 2000, 4000, Todos: Mostrar los ltimos registros segn la seleccin del usuario. El botn "Vaciar" borra el contenido de la tabla libre "Registro". Filtros: o Rango de fechas: Intervalo de fechas entre el que se realiza el anlisis. o Rango de minutos/segundos: Intervalo de tiempo entre el que se realiza el anlisis. Con la opcin Slo EMPTY se muestran las consultas que contienen esta clusula. Cabe recordar que estas instrucciones no se guardan en la cach de consultas.

2.3.1. Pantalla de registro de consultas

En la pantalla de registro de consultas tenemos una cuadrcula con las siguientes columnas: Num. Inst.: Nmero de instruccin por orden de grabacin en la tabla Registro desde la ltima vez que se presion el botn Actualizar. Fecha/Hora: Fecha y hora de la consulta. Consulta: Consulta en el cdigo original del programa antes del analizador. Tiempo: Tiempo en segundos que ha tardado el servidor de datos SQL en devolver el resultado de la consulta. El campo VFP contiene la expresin de la consulta SQL en el cdigo original del programa antes del analizador. El campo Nativo contiene la consulta SQL traducida por el analizador al cdigo del servidor de datos SQL. Ubicacin muestra la traza completa del cdigo interno del programa desde donde se ha ejecutado la consulta SQL. Podemos ordenar el listado por Fecha, Tiempo y Consulta. Con el botn Actualizar se refrescan los datos de la cuadrcula con lo que podemos analizar las ltimas consultas SQL ejecutadas. El botn Salir cierra la pantalla del registro de consultas y volvemos a la pantalla inicial.

2.3.2. Opciones de depuracin, slo SQL

En los campos VFP y Nativo podemos editar cada consulta y comprobar el resultado de la modificacin. De esta forma es posible depurar y optimizar las consultas directamente con los datos del cliente. Podremos saber si una consulta se ejecuta lenta a causa de los datos o de la propia consulta. Las sentencias que producen modificacin de los datos como Delete y Update no se pueden comprobar. En el campo Nativo, al comprobar una consulta con la opcin Explain se muestra un completo anlisis de la misma, informando entre otras cosas de los ndices que puede utilizar y del que utiliza.

Manual de Ewlog

2.4. Registro de Transacciones

Se aplica a los tipos de conexin SQL y se accede mediante el botn Ver Registro Transacciones.

2.4.1. Pantalla de registro de Transacciones

En la pantalla de registro de Transacciones hay una cuadrcula con las siguientes columnas: Terminal: Contiene el nombre del terminal que ha grabado la incidencia. Usuario: Usuario de Eurowin. Numero: Nmero de seguimiento de la transaccin. Tipo: Indica el inicio y final de la transaccin. Fecha/Hora: Fecha y hora del evento. Compilacin: Versin de compilacin de Eurowin. En el recuadro inferior se detalla la traza completa del cdigo interno del programa desde donde se ha ejecutado o finalizado la Transaccin, la cantidad de instrucciones ejecutadas y el tiempo consumido. La numeracin de seguimiento debe visualizarse de dos en dos: uno indica el comienzo y el otro el final. Las irregularidades se muestran en color azul indicando que falta un movimiento; esto es producto de que el usuario ha quitado la aplicacin Eurowin de la memoria, posiblemente por un bloqueo del ordenador (tablas bloqueadas por alguna transaccin). stos son los casos que se deben analizar. El botn Salir cierra la pantalla del registro de transacciones y vuelve a la pantalla inicial.

Ilustracin 2. Mantenimiento de perfiles

Este documento ha sido creado por el Departamento de Documentacin de Sage Eurowin. La informacin que contiene es cierta salvo error u omisin. El funcionamiento del programa puede ser modificado sin previo aviso. De producirse, las modificaciones se comunican a travs de los procedimientos habituales establecidos. Con el fin de mejorar la calidad de este manual, si detecta alguna errata puede comunicrnosla enviando un mensaje a la siguiente direccin de correo electrnico: manuales@eurowin.com

Queda totalmente prohibida la reproduccin parcial o total, as como la venta de este documento, sin el expreso consentimiento de la empresa. Todas las ofertas, promociones, condiciones y/o tarifas reflejadas en l tienen la vigencia concretada en el mismo.