Usar los Mensajes de Log para Controlar Servidores WebLogic
Introducción al Subsistema de Logging
Los mensajes de Log son útiles herramientas para controlar sistemas. Estos nos permiten detectar problemas, descubrir la fuente de un fallo y seguir el rendimiento del sistema. Los mensajes de Log gerenados por el software WebLogic Server se almacenan en dos localizaciones:
- Los componentes subsistemas de un Servidor WebLogic generan mensajes que se guardan en un fichero local, es decir, un fichero que reside donde se está ejecutando el servidor. Si hay varios servidores en una máquina, cada servidor tiene su propio fichero log. Las aplicaciones desplegadas en nuestros servidores WebLogic también podrían generar mensajes de log al fichero de log local.
- Además, un subconjunto de los mensaje se guardan localmente en un fichero log de todo dominio mantenido por el Servidor de Administración.
Se utilizan las facilidades de Java Management Extension (JMX), embebidas en el Servidor WebLogic, para transmitir los mensajes de log desde los Servidores WebLogic hacia el Servidor de Administración. Un mensaje re-enviado a otras entidades en la iniciativa de un Servidor WebLogic se llama una notificación en terminología JMX.
Cuando arranca un Servidor WebLogic, el controlador de mensajes del Servidor de Administración registra al servidor para recibir mensajes de Log. En el momento del registro, se proporciona un filtro modificable-por-el-usuario que usa el servidor local para seleccionar los mensajes reenviados al Servidor de Administración. Estos mensajes son recolectados en el log de dominio.
Por defecto, sólo los mensajes de log más importantes (según lo determina la Severidad del Mensaje) son reenviados desde los servidores locales al log de dominio. El log de dominio nos da una visión general de todo el dominio ya que sólo se enfoca en los mensajes más críticos. Si queremos modificar el filtro, para recibir un subconjunto diferente de mensajes de log desde el servidor local, podemos hacerlo dinámicamente, usando la Consola de Administración. No necesitamos re-arrancar el servidor local para que los cambios tengan efecto. (Puedes ver Crear Filtros de Logs de Dominio.)
Los desarrolladores también pueden construir controladores de mensajes personalizados que pueden registrar con un Servidor WebLogic para recibir los mensajes log mediante notificaciones JMX.
Ficheros Log Locales del Servidor
En versiones anteriores del Servidor WebLogic, se creaba un nuevo fichero de log cuando éste alcanzaba el tamaño máximo. Este tipo de creación de ficheros de log automáticos se llama rotación larga. En la versión actual, (6.0) tenemos la opción de basar la rotación larga en el tamaño o en el tiempo. Para configurar la rotación, abrimos la Consola de Administración y hacemos lo siguiente:
- En el panel izquierdo, seleccionamos un servidor.
- En el panel derecho, seleccionamos Configuration --> Logging.
- En el campo Rotation Type, seleccionamos time o size.
Si el valor de este campo es none, no ocurrirá rotación larga. Si basamos la rotación en el tiempo, se creará un fichero log cada intervalo de tiempo especificado en (File Time Span).
Por defecto, el fichero de log local del servidor se llama servername.log (donde servername es el nombre del servidor) y se crea en el directorio desde donde hayamos arrancado el Servidor WebLogic. También podemos seleccionar el nombre del fichero en la página Configuration --> Logging del servidor.
Podemos especificar el número máximo de ficheros de rotación que podemos acumular configurando apropiadamente el valor del campo File Count. Una vez que se ha alcanzado este número, se borra el fichero más viejo cada vez que ocurre una rotación de fichero. Los ficheros rotados se numeran en orden de creación filenamennnnn, donde filename es el nombre de fichero configurado. Por ejemplo weblogic.log00007.
Los logs locales del servidor tienen todos los mensajes que han ocurrido. La configuración de logging también nos permite especificar qué mensajes se sacan por stdout. Podemos excluir los mensajes de menor severidad especificando que sean grabados. También podemos activar o desactivar los mensajes de depuración hacia stdout.
Log StartUp
Cuando está arrancando un Servidor WebLogic, si ocurre un error antes de que se haya completado la inicialización, estos errores se muestran por stdout y se graban en un fichero de log de arrancada llamado weblogic-startup.log. Si la arrancada tiene éxito, el último mensaje de este log apunta a la localización del fichero log local del servidor, donde ocurren los log normales.
Logs de Cliente
Los clientes Java que usan las facilidades de logging de WebLogic también podrían generar mensajes de log. Sin embargo, los mensajes enviados por clientes no son reenviados al log de dominio. Configuramos la propiedades de logging de un cliente introduciendo el argumento apropiado en la línea de comandos:
-Dweblogic.log.attribute=value
donde attribute es cualqueir atributo LogMBean. Por defecto, el logging está desactivado para los clientes y los mensajes se sacan por stdout. Podemos activar el logging a un fichero y seleccionar el nombre del fichero usando el siguiente argumento de la línea de comandos:
-Dweblogic.log.FileName=logfilename
donde logfilename es el nombre del fichero log. También se pueden usar los siguientes argumentos de la línea de comandos para logging de clientes:
-Dweblogic.StdoutEnabled=boolean
-Dweblogic.StdoutDebugEnabled=boolean
-Dweblogic.StdoutSeverityLevel = [64 | 32 | 16 | 8 | 4 | 2 | 1 ]
donde boolean es true o false.
Formato de Fichero Log
La primera línea de cada mensaje en un fichero log empieza con #### seguido por la cabecera del mensaje. La cabecera de mensaje proporciona el contexto en tiempo de ejecución del mensaje. Cada atributo del mensaje está contenido entre ángulos.
Las líneas que siguen al cuerpo del mensaje están sólo presentes para mensajes de excepciones y muestran el seguimiento de la pila de la excepción. Si un mensaje no se graba dentro del contexto de una transación, los ángulos (separadores) para el Transaction ID están presentes aunque no haya ninguna transación.
Aquí tenemos un mensaje de log de ejemplo:
####<Jun 2, 2000 10:23:02 AM PDT> <Info> <SSL> <bigbox> <myServer>
<SSLListenThread> <harry> <> <004500> <Using exportable strength SSL>
En este ejemplo, los atributos de mensajes son: Timestamp, Severity, Subsystem, Machine Name, Server Name, Thread ID, User ID, Transaction ID, Message ID, y Message Text.
Nota:
Los mensajes de los clientes no tienen los atributos Server Name o Thread ID.
|
Nota:
La codificación de caracteres usada en la escritura de ficheros log es la codificación de caracteres por defecto del sistema local.
|
Atributos de Mensajes
En cada mensaje log grabado en un fichero log de servidor podrían estar definidos los atributos listados en la siguiente tabla. El Message Id también podría asociar el mensaje con un atributos adicionales (como Probable Cause y Recommended Action) contenido en el Message Catalog.
| Atributo |
Descripción |
| Timestamp |
La hora y la fecha en que se originó el mensaje, en un formato especificado para la localidad. |
| Severity |
Indica el grado de impacto o seriedad del evento reportado por el mensaje. Ver Severidad del Mensaje. |
| Subsystem |
Este atributo denota el subsistema particular del Servidor WebLogic que fue la fuente del mensaje. Por ejemplo, EJB, RMI, JMS. |
Server Name
Machine Name
Thread ID
Transaction ID
|
Estos cuatro atributos identifican los origenes del mensaje.
Transaction ID sólo está presente para mensajes dentro del contexto de una transación.
Nota:
Server Name y Thread ID no están presentes en mensajes log generados por un cliente Java y grabados en un log de cliente.
|
|
| User ID |
El usuario desde el contexto de seguridad cuando se generó el mensaje |
| Message ID |
Un identificador único de seís-digitos. Los mensajes superiores a 499999 están reservados para mensajes del sistema WebLogic Server. |
| Message Text |
Para mensajes de Servidor WebLogic, esto contiene una corta descripción como se define en el catálogo de mensajes del sistema. (ver Catálogo de Mensajes). Para otros mensajes, este es el texto definido por el desarrollador del programa. |
Catálogo de Mensajes
Además de la información contenida en un mensaje de log, los mensajes genrados por los componentes de sistema WebLogic Server (o posiblemente por código de usuario) incluyen información adicional predefinda o que se almacena en un catálogo de mensajes. Los atributos adicionales almacenados en el catálogo de mensajes son los siguientes:
| Atributo |
Descripción |
| Message Body |
Esta es una breve descripción textual de la condición que está siendo reportada. Es lo mismo que Message Text en el mensaje. |
| Message Detail |
Una descripción más detallada del mensaje que se está reportando. |
| Probable Cause |
Una explicación de la causa problable de la condición del mensaje que se está reportando. |
Recommended
Action |
Una acción recomendada por el administrador para resolver o evitar la condición del mensaje que se está reportando. |
Podemos acceder a los atributos adicionales del mensaje desde la vista log de la Consola de Administración.
Severidad del Mensaje
Los mensajes de log de WebLogic Server tienen un atributo llamado severity que refleja la importancia o impacto potencial sobre los usuarios del evento o condición reportada en el mensaje.
En la siguiente tabla podemos ver las severidades definidas, en orden ascendente, siendo Emergency la severidad más alta:
| Atributo |
¿Reenviado al de dominio por defecto? |
Descripción |
| Informational |
NO |
Usado para reportar operaciones normales |
| Warning |
NO |
Ha ocurrido una operación o configuración sospechosa pero podría no tener impacto sobre la operación normal. |
| Error |
SI |
Ha ocurrido un error de usuario. El sistema o la aplicación pueden manejar el error sin interrupción, ni degradación limitada del servicio. |
| Notice |
SI |
Un mensaje de aviso: Ha ocurrido una operación o configuración sospechosa pero podría no tener impacto sobre la operación normal. |
| Critical |
SI |
Ha ocurrido un error de sistema o de servicio. El sistema puede recuperarse pero podría haber una pérdida momentánea, o una degradación permanente del servicio. |
| Alert |
SI |
Un servicio particular está en un estado inutilizable mientras que otras partes del sistema continúan su función. No es posible una recuperación automática; es necesaria la atención inmediata del administrador para resolver el problema. |
| Emergency |
SI |
El servidor está inutilizado. Esta severidad indica un fallo severo del sistema. |
Mensajes de Depuración
Los mensajes con una severidad debug son un caso especial. Estos mensajes no son reenviados al log de dominio. Los mensajes de debug podrían contener información detallada sobre una aplicación o un servidor. Estos mensajes sólo deberían ocurrir cuando la aplicación se está ejecutando en modo depuración.
Navegar por los Fichero de Log
Las capacidades de navegación por los ficheros log de la Consola de Administración nos permiten:
- Ver el fichero de log local de cualquier servidor
- Ver el fichero log de todo el dominio.
Cuando estamos viendo cualquiera de los ficheros de log, podemos:
- Seleccionar los mensajes de log a ver basándonos en el tiempo, la user ID, el subsistema, la severidad del mensaje, o la descripción breve del mensaje.
- Ver los mensajes según fueron cargados o buscar mensajes de log antiguos.
- Seleccionar los atributos del mensaje de log a mostrar en la Consola de Administración y el orden en que queremos verlos.
Crear Filtros de Log de Dominio
Los mensajes reenviados por los servidores WebLogic al log de dominio, son por defecto, un subconjunto de los mensajes generados localmente. Podemos configurar un filtro que selecciona los mensajes de log a reenviar basándonos en la severidad, en el subsistema o la user ID. (Los mensajes de depuración son un caso especial que no son reenviados al log de dominio). Podemos crear o modificar los filtros de logs de dominio desde la tabla Domain Log Filters. Esta tabla es accesible desde la página con pestañas de monitorización del dominio.
Tutoriales