You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@logging.apache.org by "Curt Combar (Jira)" <ji...@apache.org> on 2022/08/04 17:38:00 UTC

[jira] [Comment Edited] (LOG4J2-3567) ThreadContext in append() method of an Appender plugin?

    [ https://issues.apache.org/jira/browse/LOG4J2-3567?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17575382#comment-17575382 ] 

Curt Combar edited comment on LOG4J2-3567 at 8/4/22 5:37 PM:
-------------------------------------------------------------

Thanks for the quick response, Piotr!  I implemented ContextDataProvider and configured it in my app under META-INF/services.  Works like a charm!

With this approach, is there any need to clear the thread context map anywhere?

 
{code:java}
package com.foo.bar;

import java.util.HashMap;
import java.util.Map;

import org.apache.logging.log4j.core.util.ContextDataProvider;

import com.ibm.commerce.ras.DDThreadContextManager;
import com.ibm.websphere.management.AdminService;
import com.ibm.websphere.management.AdminServiceFactory;/**

 * Implementation of the log4j2 ContextDataProvider interface to add thread context
 * information to every log event. In addition to this implementation, the java 
 * ServiceLoader text file "WebSphereCommerceServerExtensionsLogic\src\META-INF\services\
 * org.apache.logging.log4j.core.util.ContextDataProvider" has been added, containing
 * the full path to this implementation class.
 * 
 * @see https://docs.oracle.com/javase/tutorial/ext/basics/spi.html for info on the
 *         Java Service Provider Interface (SPI)
 */
public class MyContextDataProvider implements ContextDataProvider {    

    @Override
    public Map<String, String> supplyContextData() {
        Map<String,String> threadContext = new HashMap<String, String>();
        threadContext.put("Thread ID", Thread.currentThread().getName() + DDThreadContextManager.getThreadTraceId());
        threadContext.put("Client ID", DDThreadContextManager.getThreadSessionId());

        AdminService adminService = AdminServiceFactory.getAdminService();
        String processName = (adminService != null) ? adminService.getProcessName() : "null";
        threadContext.put("App server", processName == null ? "null" : processName);

        return threadContext;
    }
} {code}


was (Author: JIRAUSER293833):
Thanks for the quick response, Piotr!  I implemented ContextDataProvider and configured it in my app under META-INF/services.  Works like a charm!

With this approach, is there any need to clear the thread context map anywhere?

 
{code:java}
package com.foo.bar;

import java.util.HashMap;
import java.util.Map;

import org.apache.logging.log4j.core.util.ContextDataProvider;

import com.ibm.commerce.ras.DDThreadContextManager;
import com.ibm.websphere.management.AdminService;
import com.ibm.websphere.management.AdminServiceFactory;/**

 * Implementation of the log4j2 ContextDataProvider interface to add thread context
 * information to every log event. In addition to this implementation, the java 
 * ServiceLoader text file "WebSphereCommerceServerExtensionsLogic\src\META-INF\services\
 * org.apache.logging.log4j.core.util.ContextDataProvider" has been added, containing
 * the full path to this implementation class.
 * 
 * @see https://docs.oracle.com/javase/tutorial/ext/basics/spi.html for info on the
 *         Java Service Provider Interface (SPI)
 *  
 * @author spctc
 */
public class MyContextDataProvider implements ContextDataProvider {    

    @Override
    public Map<String, String> supplyContextData() {
        Map<String,String> threadContext = new HashMap<String, String>();
        threadContext.put("Thread ID", Thread.currentThread().getName() + DDThreadContextManager.getThreadTraceId());
        threadContext.put("Client ID", DDThreadContextManager.getThreadSessionId());

        AdminService adminService = AdminServiceFactory.getAdminService();
        String processName = (adminService != null) ? adminService.getProcessName() : "null";
        threadContext.put("App server", processName == null ? "null" : processName);

        return threadContext;
    }
} {code}

> ThreadContext in append() method of an Appender plugin?
> -------------------------------------------------------
>
>                 Key: LOG4J2-3567
>                 URL: https://issues.apache.org/jira/browse/LOG4J2-3567
>             Project: Log4j 2
>          Issue Type: Question
>          Components: Appenders
>    Affects Versions: 2.17.2
>            Reporter: Curt Combar
>            Priority: Major
>
> I recently converted a log4j1 implementation over to log4j2 v2.17.2 for a WebSphere Commerce application.  The log4j1 implementation used a custom appender which added thread info to MDC in the append method. With that implementation, _every_ log statement had thread information logged. 
> For the log4j2 implementation, I developed an Appender plugin, overriding the append() method to add the ThreadContext map. With this implementation, roughly 10% of our log statements come through with no thread context.  At one point I added System.out.println()'s in the append() method to verify the thread info and noticed that it printed to sysout 100% of the time.
> I also developed a similar Console appender plugin, to rule out any socket server issues, but got the same results.
> *With log4j2, is there any concern with adding to the ThreadContext map within an Appender Plugin's append() method?*
> Here is the code for the Socket Appender plugin.  Note the append() override.:
> {code:java}
> package com.foo.bar;
> import java.io.Serializable;
> import org.apache.logging.log4j.ThreadContext;
> import org.apache.logging.log4j.core.AbstractLifeCycle;
> import org.apache.logging.log4j.core.Appender;
> import org.apache.logging.log4j.core.Core;
> import org.apache.logging.log4j.core.Filter;
> import org.apache.logging.log4j.core.Layout;
> import org.apache.logging.log4j.core.LogEvent;
> import org.apache.logging.log4j.core.appender.SocketAppender;
> import org.apache.logging.log4j.core.config.Property;
> import org.apache.logging.log4j.core.config.plugins.Plugin;
> import org.apache.logging.log4j.core.config.plugins.PluginBuilderFactory;
> import org.apache.logging.log4j.core.net.AbstractSocketManager;
> import org.apache.logging.log4j.core.net.Advertiser;
> import org.apache.logging.log4j.core.net.Protocol;
> import com.ibm.commerce.ras.DDThreadContextManager;
> import com.ibm.websphere.management.AdminService;
> import com.ibm.websphere.management.AdminServiceFactory;
> /**
>  * Overrides SocketAppender so that thread-local information can be
>  * stored for a LoggingEvent before it is sent over the wire.
>  * 
>  */
> @Plugin(
>           name = "MySocketAppender", 
>           category = Core.CATEGORY_NAME,
>           elementType = Appender.ELEMENT_TYPE,
>           printObject = true)
> public class MySocketAppender extends SocketAppender {
>     
>     protected MySocketAppender(String name, Layout<? extends Serializable> layout, Filter filter, AbstractSocketManager manager, boolean ignoreExceptions, boolean immediateFlush, Advertiser advertiser, Property[] properties) {
>         super(name, layout, filter, manager, ignoreExceptions, immediateFlush, advertiser, properties);
>     }
>     
>     @PluginBuilderFactory
>     public static Builder newBuilder() {
>         return new Builder();
>     }
>     
>     @Override
>     public void append(LogEvent event) {
>         ThreadContext.put("Thread ID", Thread.currentThread().getName() + DDThreadContextManager.getThreadTraceId());
>         ThreadContext.put("Client ID", DDThreadContextManager.getThreadSessionId());
>         AdminService adminService = AdminServiceFactory.getAdminService();
>         String processName = (adminService != null) ? adminService.getProcessName() : "null";
>         ThreadContext.put("App server", processName == null ? "null" : processName);
>         
>         super.append(event);
>         
>         ThreadContext.clearAll();
>     }
>     
>     /**
>      * Builds a MySocketAppender.
>      */
>     public static class Builder extends SocketAppender.Builder {        
>         @Override
>         public MySocketAppender build() {
>             boolean immediateFlush = isImmediateFlush();
>             final boolean bufferedIo = isBufferedIo();
>             final Layout<? extends Serializable> layout = getLayout();
>             if (layout == null) {
>                 AbstractLifeCycle.LOGGER.error("No layout provided for MySocketAppender");
>                 return null;
>             }            
>             final String name = getName();
>             if (name == null) {
>                 AbstractLifeCycle.LOGGER.error("No name provided for MySocketAppender");
>                 return null;
>             }
>             final Protocol protocol = getProtocol();
>             final Protocol actualProtocol = protocol != null ? protocol : Protocol.TCP;
>             if (actualProtocol == Protocol.UDP) {
>                 immediateFlush = true;
>             }
>             final AbstractSocketManager manager = SocketAppender.createSocketManager(name, actualProtocol, getHost(), getPort(),
>                     getConnectTimeoutMillis(), getSslConfiguration(), getReconnectDelayMillis(), getImmediateFail(), layout, getBufferSize(), getSocketOptions());
>             return new MySocketAppender(name, layout, getFilter(), manager, isIgnoreExceptions(),
>                     !bufferedIo || immediateFlush, getAdvertise() ? getConfiguration().getAdvertiser() : null,
>                     getPropertyArray());
>         }
>     }
> }
> {code}
> log4j2.xml:
> {code:java}
> <?xml version="1.0" encoding="UTF-8"?>
> <Configuration status="debug" packages="com.foo.bar">
>     <Properties>
>         <Property name="baseDir">C:/temp</Property>
>     </Properties>
>     
>     <Appenders>
>         <MySocketAppender name="socket" host="localhost" port="11005" reconnectionDelayMillis="1000" >
>             <JsonLayout properties="true" compact="true" />
>         </MySocketAppender>
>      
>         <MyConsoleAppender name="console">
>             <PatternLayout pattern="%-5p %d{ISO8601} - %n%m%nThread ID: &lt;%X{Thread ID}&gt;%nClient ID: &lt;%X{Client ID}&gt;%nApp Server: &lt;%X{App server}&gt;%n%n" />
>         </MyConsoleAppender>
>     </Appenders>
>     
>     <Loggers>
>         <Root level="DEBUG">
>              <Appender-Ref ref="socket" />
>         </Root>
>     </Loggers>
> </Configuration>
>  {code}
> This application runs with the 1.8 IBM VM. Version info:
> {noformat}
> java version "1.8.0_321"
> Java(TM) SE Runtime Environment (build 8.0.7.5 - pxa6480sr7fp5-20220208_01(SR7 FP5))
> IBM J9 VM (build 2.9, JRE 1.8.0 Linux amd64-64-Bit Compressed References 20220104_19630 (JIT enabled, AOT enabled)
> OpenJ9   - 2d4c7d9
> OMR      - 59845b7
> IBM      - 3c151c1)
> JCL - 20220120_01 based on Oracle jdk8u321-b07
> {noformat}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)