Apache Log4j 2 Apache Log4j 2 es una actualización a Log4j que proporciona mejoras significativas sobre su predecesor, Log4j 1.x, y proporciona muchas de las mejoras disponibles en Logback, mientras que la fijación de algunos problemas inherentes en la arquitectura de Logbacks. Algunas de las características y mejoras de Log4j 2 son: Separación de API La API para Log4j es independiente de la implementación, dejando claro para los desarrolladores de aplicaciones qué clases y métodos pueden utilizar mientras se garantiza la compatibilidad hacia adelante. Esto permite al equipo de Log4j mejorar la implementación de forma segura y de forma compatible. Rendimiento mejorado Log4j 2 contiene los registradores asincrónicos de próxima generación basados en la biblioteca Disruptor LMAX. En escenarios de múltiples hilos, los registradores asíncronos tienen 18 veces más rendimiento y órdenes de magnitud de latencia menor que Log4j 1.x y Logback. Consulte Asynchronous Logging Performance para obtener más información. De lo contrario, Log4j 2 supera significativamente a Log4j 1.x, Logback y java. util. logging, especialmente en aplicaciones multihilo. Consulte Rendimiento para obtener más información. Soporte para múltiples APIs Mientras que la API de Log4j 2 proporcionará el mejor rendimiento, Log4j 2 proporciona soporte para las API de Log4j 1.2, SLF4J, Commons Logging y java. util. logging (JUL). Evitar bloqueo Las aplicaciones codificadas en la API Log4j 2 siempre tienen la opción de utilizar cualquier biblioteca compatible con SLF4J como su implementación de registrador con el adaptador log4j-to-slf4j. Recarga automática de configuraciones como Logback, Log4j 2 puede recargar automáticamente su configuración tras la modificación. A diferencia de Logback, lo hará sin perder eventos de registro mientras se está realizando la reconfiguración. Filtrado avanzado Al igual que Logback, Log4j 2 admite el filtrado basado en datos de contexto, marcadores, expresiones regulares y otros componentes en el evento de registro. El filtrado puede especificarse para aplicarse a todos los eventos antes de pasarlos a Loggers oa medida que pasan por Appenders. Además, los filtros también pueden asociarse con Loggers. A diferencia de Logback, puede utilizar una clase de filtro común en cualquiera de estas circunstancias. Arquitectura de complementos Log4j utiliza el patrón de complemento para configurar los componentes. Como tal, no necesita escribir código para crear y configurar un Appender, Layout, Pattern Converter, etc. Log4j reconoce automáticamente los complementos y los utiliza cuando una configuración hace referencia a ellos. Soporte de propiedades Puede referenciar propiedades en una configuración, Log4j las reemplazará directamente o Log4j las pasará a un componente subyacente que las resuelve dinámicamente. Las propiedades vienen de los valores definidos en el archivo de configuración, las propiedades del sistema, las variables de entorno, el mapa de ThreadContext y los datos presentes en el evento. Los usuarios pueden personalizar los proveedores de propiedades agregando su propio complemento de búsqueda. Soporte Lambda de Java 8 Anteriormente, si un mensaje de registro era costoso de construir, a menudo comprobaría explícitamente si el nivel de registro solicitado estaba habilitado antes de construir el mensaje. El código de cliente que se ejecuta en Java 8 puede beneficiarse del soporte de lambda de Log4js. Puesto que Log4j no evaluará una expresión lambda si el nivel de registro solicitado no está habilitado, se puede lograr el mismo efecto con menos código. Niveles de registro personalizados En Log4j 2, los niveles de registro personalizados se pueden definir fácilmente en código o en configuración. No se requiere ninguna subclasificación. Sin basura Durante el registro en estado estacionario, Log4j 2 está libre de basura en aplicaciones independientes y poca basura en aplicaciones web. Esto reduce la presión sobre el colector de basura y puede dar un mejor rendimiento de tiempo de respuesta. Documentación La Guía del usuario de Log4j 2 está disponible en este sitio o como un PDF descargable. Requisitos Log4j 2.4 y superior requiere Java 7, versiones 2.0-alpha1 a 2.3 requerido Java 6. Algunas características requieren dependencias opcionales la documentación de estas características especifica las dependencias. Noticias Log4j 2.7 ya está disponible para la producción. La API para Log4j 2 no es compatible con Log4j 1.x, sin embargo, un adaptador está disponible para permitir que las aplicaciones sigan utilizando la API Log4j 1.x. Los adaptadores también están disponibles para Apache Commons Logging y SLF4J. Log4j 2.7 es la última versión de Log4j y contiene varias correcciones de errores que se encontraron después del lanzamiento de Log4j 2.6. La lista de correcciones se puede encontrar en el último informe de cambios. Tenga en cuenta que después de la liberación de Log4j 2.6 se encontró una incompatibilidad de fuente menor con liberación previa debido a la adición de nuevos métodos a la interfaz de Logger. Si tiene código que hace: o similar con cualquier nivel de registro obtendrá un error del compilador diciendo que la referencia es ambigua. Para corregir esto, haga lo siguiente: Prácticas de registro Ser una biblioteca HttpClient no es para dictar qué marco de registro el usuario tiene que usar. Por lo tanto, HttpClient utiliza la interfaz de registro proporcionada por el paquete Commons Logging. Commons Logging proporciona una interfaz de registro simple y generalizada a varios paquetes de registro. Mediante el uso de Commons Logging. HttpClient se puede configurar para una variedad de diferentes comportamientos de registro. Eso significa que el usuario tendrá que hacer una elección que el marco de registro para su uso. Por defecto, Commons Logging admite los siguientes marcos de registro: Log4J java. util. logging SimpleLog (interno al registro de Commons) Al implementar algunas interfaces simples, Commons Logging puede ampliarse para soportar básicamente cualquier otro marco de registro personalizado. Commons Logging intenta descubrir automáticamente el marco de registro para usar. Si falla al seleccionar el esperado, debe configurar Commons Logging manualmente. Consulte la documentación de Commons Logging para obtener más información. HttpClient realiza dos tipos diferentes de registro: el registro de contexto estándar utilizado dentro de cada clase y el registro de cableado. Registro de contexto El registro de contexto contiene información sobre el funcionamiento interno de HttpClient a medida que realiza peticiones HTTP. Cada clase tiene su propio registro denominado de acuerdo con el nombre completo de las clases. Por ejemplo, la clase HttpClient tiene un registro denominado org. apachemons. httpclient. HttpClient. Dado que todas las clases siguen esta convención, es posible configurar el registro de contexto para todas las clases utilizando el único registro denominado org. apachemons. httpclient. Registro de cableado El registro de cableado se utiliza para registrar todos los datos transmitidos ay desde servidores al ejecutar peticiones HTTP. Este registro sólo debe habilitarse para depurar problemas, ya que producirá una cantidad extremadamente grande de datos de registro, algunos de ellos en formato binario. Dado que el contenido de las solicitudes HTTP suele ser menos importante para depurar que los encabezados HTTP, estos dos tipos de datos se han separado en diferentes registros de cable. El registro de contenido es httpclient. wire. content y el registro del encabezado es httpclient. wire. header. Ejemplos de configuración Commons Logging puede delegar en una variedad de registradores para procesar la salida real. A continuación se muestran ejemplos de configuración de Commons Logging. Log4j y java. util. logging. Commons Logging Ejemplos Commons Logging viene con un registrador básico llamado SimpleLog. Este registrador escribe todos los mensajes registrados en System. err. Los siguientes ejemplos muestran cómo configurar Commons Logging a través de las propiedades del sistema para usar SimpleLog. Nota: Las propiedades del sistema deben configurarse antes de realizar una referencia a cualquier clase de Common Logging. Habilitar el registro de contexto de hilo de encabezado - Lo mejor para depurar System. setProperty (org. apachemons. logging. Log, org. apachemons. logging. impl. SimpleLog) System. setProperty (org. apachemons. logging. simplelog. showdatetime, true) System. setProperty (Org. apachemons. logging. simplelog. log. httpclient. wire. header, depuración) System. setProperty (org. apachemons. logging. simplelog. log. org. apachemons. httpclient, debug) Habilitar el contexto de cable completo (encabezado y contenido) Registro System. setProperty (org. apachemons. logging. Log, org. apachemons. logging. impl. SimpleLog) System. setProperty (org. apachemons. logging. simplelog. showdatetime, true) System. setProperty (org. apachemons. logging. simplelog. log. httpclient. wire, depuración) System. setProperty (org. apachemons. logging. simplelog. log. org. apachemons. httpclient, debug) Habilitar sólo el registro de contexto System. setProperty (org. apachemons. logging. Log, org. apachemons. logging. impl. SimpleLog) System. setProperty (org. apachemons. logging. simplelog. showdatetime, true) System. setProperty (org. apachemons. logging. simplelog. log. org. apachemons. httpclient, debug) Ejemplos de Log4j La forma más simple Para configurar Log4j es a través de un archivo log4j. properties. Log4j se leerá y se configurará automáticamente usando un archivo llamado log4j. properties cuando esté presente en la raíz del classpath de la aplicación. A continuación se muestran algunos ejemplos de configuración de Log4j. Nota: Log4j no está incluido en la distribución HttpClient. Habilitar el registro de contexto de hilo de encabezado - Lo mejor para depurar log4j. rootLoggerINFO, stdout log4j. appender. stdoutorg. apache. log4j. ConsoleAppender log4j. appender. stdout. layoutorg. apache. log4j. PatternLayout log4j. appender. stdout. layout. ConversionPattern5p c mn log4j. logger. httpclient. wire. headerDEBUG log4j. logger. org. apachemons. httpclientDEBUG Habilitar el registro de contexto de cableado completo (encabezado y contenido) log4j. rootLoggerINFO, stdout log4j. appender. stdoutorg. apache. log4j. ConsoleAppender log4j. appender. stdout. layoutorg. apache. log4j. PatternLayout log4j. appender. stdout. layout. ConversionPattern5p c mn log4j. logger. httpclient. wireDEBUG log4j. logger. org. apachemons. httpclientDEBUG Registro de cableado al registro de contexto de archivo log4j. rootLoggerINFO log4j. appender. stdoutorg. apache. Log4j. ConsoleAppender log4j. appender. stdout. layoutorg. apache. log4j. PatternLayout log4j. appender. stdout. layout. ConversionPattern5p c mn log4j. appender. Forg. apache. log4j. FileAppender log4j. appender. F.Filewire. log log4j. appender. F.layoutorg. apache. log4j. PatternLayout log4j. appender. F.layout. ConversionPattern 5p c mn log4j. logger. httpclient. wireDEBUG, F log4j. logger. org. apachemons. httpclientDEBUG, stdout Habilitar solo el registro de contexto log4j. rootLoggerINFO, Stdout log4j. appender. stdoutorg. apache. log4j. ConsoleAppender log4j. appender. stdout. layoutorg. apache. log4j. PatternLayout log4j. appender. stdout. layout. ConversionPattern5p c mn log4j. logger. org. apachemons. httpclientDEBUG Tenga en cuenta que la configuración predeterminada Para Log4J es muy ineficiente ya que hace que toda la información de registro se genere, pero en realidad no se envía a ninguna parte. El manual de Log4J es la mejor referencia para configurar Log4J. Está disponible en logging. apache. org/log4j/docs/manual. html java. util. logging Ejemplos Desde JDK 1.4 ha habido un paquete java. util. logging que proporciona un marco de registro similar al de Log4J. Por defecto lee un archivo de configuración de JAVAHOME / jre / lib / logging. properties que se parece a esto (comentarios despojado): handlersjava. util. logging. ConsoleHandler. levelINFO java. util. logging. FileHandler. pattern h / javau. log java. util. logging. FileHandler. limit 50000 java. util. logging. FileHandler. count 1 java. util. logging. FileHandler. formatter java. util. logging. XMLFormatter java. util. logging. ConsoleHandler. level INFO java. util. logging. ConsoleHandler. formatter java. util. logging. SimpleFormatter com. xyz. foo. level SEVERE Para personalizar el registro se debe crear un archivo logging. properties personalizado en el directorio del proyecto. La ubicación de este archivo se debe pasar a la JVM como una propiedad del sistema. Esto se puede hacer en la línea de comandos de la siguiente manera: JAVAHOME / java - Djava. util. logging. config. fileHOME / myapp / logging. properties - classpath HOME / myapp / target / classes com. myapp. Main Como alternativa LogManagerreadConfiguration (InputStream) puede Ser utilizado para pasar la configuración deseada. Habilitar el registro de contexto del cable de encabezado - Lo mejor para depurar. levelINFO handlersjava. util. logging. ConsoleHandler java. util. logging. ConsoleHandler. formatter java. util. logging. SimpleFormatter httpclient. wire. header. levelFINEST org. apachemons. httpclient. levelFINEST Habilitar full Wire (encabezado y contenido) contexto logging. levelINFO handlersjava. util. logging. ConsoleHandler java. util. logging. ConsoleHandler. formatter java. util. logging. SimpleFormatter httpclient. wire. levelFINEST org. apachemons. httpclient. levelFINEST Habilitar el registro de contexto justo. LevelINFO handlersjava. util. logging. ConsoleHandler java. util. logging. ConsoleHandler. formatter java. util. logging. SimpleFormatter org. apachemons. httpclient. levelFINEST Información más detallada está disponible en la documentación de Java Logging. El componente de registro Cuando se escribe una biblioteca, Es muy útil para registrar la información. Sin embargo, hay muchas implementaciones de registro por ahí, y una biblioteca no puede imponer el uso de una determinada en la aplicación general que la biblioteca es una parte de. El paquete Logging es un puente ultrafino entre diferentes implementaciones de registro. Una biblioteca que utiliza el commons-logging API puede utilizarse con cualquier implementación de registro en tiempo de ejecución. Commons-logging viene con soporte para una serie de implementaciones de registro populares, y escribir adaptadores para otros es una tarea razonablemente simple. Las aplicaciones (en lugar de las bibliotecas) también pueden elegir utilizar commons-logging. Mientras que la independencia de implementación de registro no es tan importante para las aplicaciones como para bibliotecas, el uso de commons-logging permite que la aplicación cambie a una implementación de registro diferente sin recompilar el código. Tenga en cuenta que commons-logging no intenta inicializar o finalizar la implementación de registro subyacente que se utiliza en tiempo de ejecución que es responsabilidad de la aplicación. Sin embargo, muchas implementaciones de registro populares se inicializan automáticamente en este caso, una aplicación puede evitar contener cualquier código que sea específico para la implementación de registro utilizada. Documentación Las notas de la versión documentan las nuevas características y correcciones de errores que se han incluido en la última versión. Los documentos de la API JavaDoc para la última versión están disponibles en línea. En particular, debe leer la descripción general del paquete org. apachemons. logging. Además, hay una (corta) guía del usuario. El sitio Wiki tiene las últimas actualizaciones, un FAQ y mucha otra información útil. Los usuarios que necesiten ser expertos o quieran ayudar a desarrollar JCL deben (además) consultar la Guía Técnica. Esto proporciona introducciones breves a temas como carga de clase avanzada. Lanzamientos Las distribuciones binarias y de fuentes están disponibles aquí. 1.2 Release - July 2014 El objetivo principal de la versión 1.2 es eliminar soporte para Java 1.1. Para obtener una lista completa de cambios desde la versión 1.1.3, consulte el informe de cambios. 1.1.3 Release - May 2013 La versión 1.1.3 sólo actualiza el Bundle-SymbolicName en el manifiesto a quotorg. apachemons. loggingquot. Para obtener una lista completa de cambios desde la versión 1.1.1, consulte el informe de cambios. 1.1.2 Release - Marzo de 2013 La versión 1.1.2 es un paquete de correcciones de errores desde la versión 1.1.1. Para obtener los detalles completos, consulte las notas de la versión de esta versión. 1.1.1 Release - Noviembre de 2007 Esta versión es una actualización menor de la versión 1.1 que corrige varios errores y resuelve los problemas de empaque para los usuarios de maven 1.x y maven 2.x. Para obtener los detalles completos, consulte las notas de la versión de esta versión. Esta versión hace varios cambios que están destinados a resolver los problemas que se han encontrado cuando se utiliza commons-log en contenedores de servlet o contenedores j2ee donde complejos classpaths están presentes y múltiples copias de las bibliotecas de registros comunes están presentes en diferentes niveles . Esta versión también agrega soporte para el nivel TRACE añadido a log4j en la versión 1.2.12. En versiones anteriores de commons-logging, el método log. trace hizo que log4j emitiera el mensaje en el nivel DEBUG (el nivel más bajo admitido por log4j en ese momento). Para obtener los detalles completos, consulte las notas de la versión de esta versión. 1.0.5 Release (Alpha) Nota: la versión 1.0.5 fue abandonada en estado alfa. La próxima versión de JCL se denominará 1.1 ya que creemos que esto refleja con mayor precisión las mejoras realizadas en la base de código. 1.0.4 Release - 16 Jun 2004 La versión 1.0.4 de commons-logging es una versión de servicio que contiene soporte para la serie 1.2.x y 1.3.x de las versiones de Log4J. 1.0.3 Release - 7 Apr 2003 La versión 1.0.3 es principalmente un mantenimiento y una versión de limpieza de código con un mínimo de nuevas características. 1.0.2 Release - 27 September 2002 La versión 1.0.2 es un paquete de correcciones de errores desde la versión 1.0.1. 1.0.1 Release - 13 August 2002 La versión 1.0.1 es un paquete de correcciones de errores y mejoras menores desde la versión 1.0. Construcciones de desarrollo Las versiones regulares del actual código SVN HEAD están disponibles. Vea el wiki para más detalles. Copyright copy 2001-2014 La Fundación Apache Software. Todos los derechos reservados. Apache Commons, Apache Commons Logging, Apache, el logotipo de la pluma Apache y los logotipos del proyecto Apache Commons son marcas registradas de The Apache Software Foundation. Todas las demás marcas mencionadas pueden ser marcas comerciales o marcas registradas de sus respectivos propietarios.
No comments:
Post a Comment