[jira] [Created] (LOG4J2-1179) Log4j performance documentation

["Remko Popma (JIRA)" <ji...@apache.org>]

Remko Popma created LOG4J2-1179:
-----------------------------------

             Summary: Log4j performance documentation
                 Key: LOG4J2-1179
                 URL: https://issues.apache.org/jira/browse/LOG4J2-1179
             Project: Log4j 2
          Issue Type: Documentation
          Components: Documentation, Performance Benchmarks
    Affects Versions: 2.4.1
            Reporter: Remko Popma
            Assignee: Remko Popma
             Fix For: 2.5


_(Work in progress. Still thinking this through.)_

The web site currently has two performance pages:

*[Performance|https://logging.apache.org/log4j/2.x/performance.html]*
A general performance page comparing Log4j 2 to Logback and Log4j 1. This page is not part of the manual, and the only link to it is from the About top page. This page covers:
* logging turned off (with isXxxEnabled)
* Parameters vs. String concatenation
* Synchronous logging (to unspecified appender with unspecified layout)
* Filters (ThreadContextMapFilter and MarkerFilter)
* Environment: MacBook Pro laptop specifying clock speed but omitting OS, JDK and # cores.

*[Async Loggers Performance|https://logging.apache.org/log4j/2.x/manual/async.html#Performance]*
Intended as in-depth analysis of async loggers. Mostly a comparison of Log4j 2 to Logback and Log4j 1. This page covers:
* Synchronous vs. asynchronous logging
* Async Logger vs. Async Appender
* Cost of logging location information
* Separate analysis for throughput and latency 
* FileAppender vs. RandomAccessFileAppender (should not be on this page)
* Environment: laptop Windows 7 with JDK1.7 on 4 cores and enterprise server Solaris 10 with JDK1.7 on 16 cores

*TODO: dedicated Performance section on web site*
I would like to add a Performance section to the site (accessible from the nav side menu). Not sure if this should be part of the manual or under APACHE LOG4J™ 2 in the nav side menu.

This section would include and reorganize what we already have, and in addition have sections (separate pages?) on:
* General tips to improve logging performance
* Cost of various layouts (HTML, XML, CSV, Pattern)
* Cost of various Pattern Layout options
* Cost of various appenders (File, RandomAccess File, MemoryMapped File, Console, Rewrite, other?) TODO: decide on layout for these tests.
* Cost of various APIs/wrappers (SLF4J, Log4j1, JUL, Commons Logging)



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
For additional commands, e-mail: log4j-dev-help@logging.apache.org