El Application Server registra eventos, errores y otra información útil en varios archivos de registro. Estas herramientas son útiles para encontrar información sobre el uso del Application Server y para solucionar problemas.
Tenga en cuenta que los archivos de registro específicos del Application Server solo registran información sobre el Application Server; no registran información de uso sobre su sitio de intranet en general. En cambio, el registro de su servidor web normalmente sí registra información sobre todo el sitio gestionado por el servidor.
El Application Server también envía alertas por correo electrónico para ciertos errores. Para más detalles sobre las alertas por correo electrónico, consulte Configurar los ajustes de correo electrónico para Application Server.
Esta sección cubre los siguientes temas:
- Archivos de registro disponibles
- Nivel de registro
- Registro de archivos rotativos
- Información registrada en los archivos de registro del Application Server
Archivos de registro disponibles
El Application Server proporciona los siguientes archivos de registro:
- Archivo de registro de InterAction
- Archivos de registro del motor de servlets Java
- Archivo de registro W3C del Application Server
- Visor de eventos de Windows
- Archivo de registro del servidor web
Archivo de registro de InterAction
El archivo de registro de InterAction registra cualquier error que el Application Server encuentre durante el inicio y el procesamiento. También registra mensajes informativos al iniciar el Application Server, cargar archivos de configuración, almacenar datos en caché y responder a solicitudes del navegador.
Este archivo se encuentra en la siguiente ubicación:
[Unidad]:\Program Files\LexisNexis\InterAction\AppServer\logs
El archivo de registro de InterAction admite siete niveles de registro. Consulte Nivel de registro para más detalles.
El archivo de registro de InterAction también admite la función de archivo de registro “rotativo”. Consulte Registro de archivos rotativos.
Archivos de registro del motor de servlets Java
Estos archivos registran los errores, eventos y la salida estándar de texto para el componente del motor de servlets Java del Application Server.
Hay tres archivos de registro del motor de servlets Java:
- InterAction-err.log - registra cualquier error del motor de servlets Java durante el inicio y el procesamiento.
- InterAction-event.log - registra las acciones realizadas por el motor de servlets Java.
- InterAction-out.log - esta es la salida estándar del motor de servlets Java.
Estos archivos se encuentran en la siguiente ubicación:
[Unidad]:\Program Files\LexisNexis\InterAction\AppServer\logs
Archivo de registro W3C del Application Server
Este archivo rastrea estadísticas de solicitudes de métodos utilizando un formato estándar de registro web. Puede usar este archivo de registro con software de seguimiento/análisis web para recopilar información sobre el uso del Application Server.
El nombre y la ubicación de este archivo de registro se establecen en la variable w3cLogFile en el archivo InterAction.cfg. Por defecto, es el siguiente:
w3cLogFile = $(IRIS_LOG_DIR)/w3c.log
En una nueva instalación de Application Server, este archivo de registro está desactivado.
Por defecto, el archivo InterAction.cfg se encuentra aquí:
[Unidad]:\Program Files\LexisNexis\InterAction\AppServer\iahome\
Visor de eventos de Windows
En un entorno de Windows Server, el Application Server también puede registrar eventos en el Visor de eventos de Windows.
Normalmente, no es necesario activar esta opción, ya que los otros archivos proporcionan suficiente registro. Si desea registrar eventos, establezca la siguiente opción en el archivo InterAction.cfg:
enableNTEventLog = true
Esto es útil si desea centralizar el registro para todas las aplicaciones de su sitio o monitorear el Visor de eventos de Windows de forma remota.
Archivo de registro del servidor web
El servidor web normalmente registra archivos de registro. Estos archivos contienen información sobre las solicitudes y respuestas del Application Server, así como del resto del sitio gestionado por el servidor. Utilice el software de su servidor web para configurar este registro.
Nivel de registro
El nivel de registro controla los eventos que se registran en el archivo de registro de InterAction. Para establecer el nivel de registro, configure la variable logLevel en el archivo InterAction.cfg con el valor deseado.
El archivo InterAction.cfg se encuentra aquí: \Program Files\LexisNexis\InterAction\AppServer\iahome\
El nivel de registro se puede establecer con un número entero o con un nombre de nivel. Por ejemplo, puede configurarlo de la siguiente manera:
logLevel = 1
Esta configuración le da los niveles de registro Config, Info, Warning y Severe. Si establece el nivel de la siguiente manera:
logLevel = Info
solo obtendrá los niveles de registro Info, Warning y Severe.
La siguiente tabla resume los niveles de registro disponibles.
Niveles de registro del Application Server
| Nivel de registro | Descripción | |
|---|---|---|
| Número | Nombre | |
| Severe | Errores graves | |
| 0 | Warning | Advertencias |
| Info | Información general | |
| 1 | Config | Información de configuración |
| 2 | Fine | Información más detallada |
| 3 | Finer | Información de depuración de alto nivel |
| 4 | Finest | Información de depuración detallada |
En general, solo use los niveles de registro 2, 3 y 4 cuando el Soporte Técnico de LexisNexis InterAction se lo solicite para solucionar un problema. De lo contrario, los archivos de registro pueden crecer mucho.
Cambiar el nivel de registro en el Web Client
En la página de administración del Web Client, puede cambiar rápidamente el nivel de registro a 1 o 2. Sin embargo, este cambio no actualiza el valor de logLevel en el archivo InterAction.cfg. Es solo una configuración temporal que vuelve al valor de InterAction.cfg una vez que se reinicia el Application Server de InterAction.
Debe ser un usuario administrativo del Application Server para acceder a la página de administración en el Web Client. Consulte Usuarios administrativos del Application Server.
Registro de archivos rotativos
Cada noche a la medianoche, el archivo de registro de InterAction “rota” cerrando el registro actual y abriendo uno nuevo. La fecha actual se incluye en el nombre del archivo, por ejemplo, InterAction-20040811.log.
El parámetro maxLogHistory en el archivo InterAction.cfg controla cuántos días de registros se conservan. Cuando el registro rota, el Application Server elimina cualquier archivo de registro más antiguo que el número de días especificado. El valor predeterminado es 30.
Información registrada en los archivos de registro del Application Server
El archivo de registro de InterAction registra todos los errores y advertencias que ocurren cuando el Application Server se inicia y cuando los usuarios acceden a páginas a través del Web Client.
Tenga en cuenta que el mismo error o advertencia puede aparecer varias veces en el archivo de registro. Esto se debe a que el mismo error puede ocurrir cada vez que se realiza una acción en particular, como cada vez que el Application Server actualiza la caché.
Cada elemento en el registro de errores siempre comienza con la fecha y la hora del error. La hora está en notación de 24 horas:
Thu Dec 28 10:59:23 CST 2000 - WARNING: duplicate client ids for client 1234
Anotar la fecha y la hora puede ayudarle a interpretar el registro, ya que puede identificar mensajes que se registraron aproximadamente al mismo tiempo en respuesta a la misma acción.
Hay tres tipos de errores y advertencias que pueden ocurrir:
- Errores de integridad de datos
- Advertencias
- Errores de excepción Java
Errores de integridad de datos
Los errores de integridad de datos ocurren si hay un problema con los datos en la base de datos de InterAction. Estos siempre comienzan con el texto “Data Integrity Error” en el archivo de registro, por ejemplo:
Data Integrity Error multiple global Business apes of the same type: listing id: 2/43598 ape class: com.interaction.ia.ElectronicAddress
Para encontrar estos errores, use un editor de texto para buscar “Data Integrity” en el archivo de registro.
El Application Server envía un mensaje de correo electrónico sobre errores de integridad de datos al cargar inicialmente los datos de InterAction en la caché. Después de la carga inicial, los errores se registran como advertencias, por lo que no se envían mensajes de correo electrónico adicionales. Todos los errores de integridad de datos se incluyen en un solo mensaje de correo electrónico.
El error registrado en el archivo de registro del Application Server incluye el problema específico, el ID del contacto que causó el problema y un indicador para el tipo de teléfono o dirección. El ID de contacto se da en el siguiente formato:
Contact Source ID/Contact ID
En el ejemplo anterior, el contacto que causa el problema tiene un Contact Source ID de 2 y un Contact ID de 43598. El contacto tiene varias direcciones electrónicas globales de negocios del mismo tipo.
Los problemas de integridad de datos pueden ocurrir en casos raros si hay problemas con su base de datos o si dos usuarios editan la misma información al mismo tiempo. Ejemplos de estos errores incluyen:
- Contactos con varios teléfonos o direcciones de negocios globales. Normalmente esta situación no está permitida, pero puede ocurrir en casos excepcionales.
- Contactos con varias direcciones postales globales. De nuevo, esta situación debería ser rara.
Para solucionar estos problemas, busque los contactos y corrija los datos en InterAction. Puede buscar por ID de contacto. Consulte Buscar un ID de contacto específico en InterAction.
Advertencias
Una advertencia de integridad de datos ocurre si los datos almacenados en InterAction no cumplen con las reglas de negocio del Application Server. Por ejemplo, si dos contactos tienen el mismo ID de cliente, se escribe el siguiente mensaje en el registro:
contact: 2/47 and contact: 2/50 have duplicate client ids: 1234
Para solucionar estos problemas, busque los contactos y corrija los datos en InterAction. Puede usar una búsqueda para encontrar los contactos. Por ejemplo, si dos contactos tienen el mismo número de cliente, busque el campo adicional del número de cliente en InterAction.
Errores de excepción Java
Un error de Java ocurre si el Application Server encuentra un problema que impide el procesamiento. Los usuarios pueden ver problemas en el Web Client si se están produciendo errores de Java. El siguiente es un ejemplo de un error de Java:
Thu Dec 28 10:59:23 CST 2000 - (at java.lang.Exception.<init>(Unknown Source)) CustomDef not found in profile: company-general for CustomDef id: 0/32
Para algunos errores, el archivo de registro incluye información adicional sobre el error. Esta información puede ser útil si necesita trabajar con el Soporte Técnico de LexisNexis InterAction para solucionar un problema.
El Application Server también envía una alerta por correo electrónico con la misma información del archivo de registro. Para más detalles sobre el destinatario de estos mensajes, consulte Configurar los ajustes de correo electrónico para Application Server.
La parte principal del mensaje que necesita es el texto del mensaje de error después del paréntesis. En el ejemplo anterior, este es el texto del mensaje:
CustomDef not found in profile: company-general for CustomDef id: 0/32)
Estos errores normalmente son el resultado de archivos de configuración incorrectos. Por ejemplo, en el ejemplo anterior, la configuración del perfil para el perfil company-general hace referencia a un campo adicional que no se ha definido en su entorno de InterAction. Errores similares incluyen declaraciones de perfil que hacen referencia a carpetas o clasificaciones que no existen en su entorno.
Este tipo de errores de configuración causan problemas a los usuarios. Si un usuario del Web Client intenta acceder a un perfil que tiene uno de estos errores, probablemente encontrará errores o resultados inesperados en las páginas web.
Este tipo de problemas puede ocurrir si configuras el Application Server en un entorno de pruebas y luego cambias a un entorno de producción. Para corregir estos problemas, actualiza los archivos de configuración del Application Server para tu entorno de InterAction.
Si no puedes solucionar un error, contacta al Soporte Técnico de LexisNexis InterAction y proporciona el archivo de registro o la alerta por correo electrónico con el mensaje de error.
Generar archivos de registro para usuarios específicos
El archivo de registro de InterAction guarda todos los errores que el Application Server encuentra durante el inicio y el procesamiento. Puede ser útil crear un archivo de registro separado para un usuario en particular o para un grupo de usuarios. Por ejemplo, un archivo de registro para un solo usuario puede ayudarte a centrarte en la resolución de un problema específico de ese usuario.
Para crear un archivo de registro para usuarios específicos, establece el siguiente parámetro en el archivo InterAction.cfg, usando punto y coma para separar los nombres de las cuentas de usuario:
logusers = userA;userB
Por ejemplo, para los usuarios jtarnoff y eroberts:
logusers = jtarnoff;eroberts
Cuando el archivo de registro de InterAction rota para crear un nuevo archivo de registro para el día, se crea el archivo de registro estándar, así como cualquier archivo de registro adicional de usuario que hayas especificado.
En el ejemplo anterior, se crean los siguientes tres archivos de registro
para el 26/09/2011:
- InterAction-20110926.log
- InterAction-20110926_jtarnoff.log
- InterAction-20110926_eroberts.log
Buscar en InterAction por un ID de contacto específico
- Inicia sesión en Windows Client como administrador del sistema. Esto te da acceso a todos los contactos en la base de datos.
- En InterAction, selecciona Carpeta > Nuevo > Búsqueda.
- En la pestaña Carpetas, selecciona Buscar en TODAS las carpetas a las que el usuario actual tiene acceso de LECTURA.
- Selecciona la pestaña Criterios.
- Haz clic en Agregar. Expande el elemento Condiciones de contacto y luego expande la opción Identificador de objeto.
-
Selecciona ID de contacto y haz clic en OK.
- Ingresa el ID de contacto que deseas buscar en el cuadro de edición Valor y haz clic en OK.
- Repite los pasos 5 y 6, pero selecciona la condición ID de fuente de contacto en su lugar.
- Ingresa el ID de fuente de contacto que deseas buscar en el cuadro de edición Valor y haz clic en OK.
- Asegúrate de que ambas condiciones aparezcan en el cuadro de diálogo con Y entre ellas, y luego haz clic en Buscar ahora para encontrar el contacto.