IOpipe Logger Adapter for log4j2 (Java)

Support for Log4j2 using the IOpipe Logger Plugin. This plugin is to be used with the IOpipe Java Agent.

It is licensed under the Apache 2.0.

Building With The Adapter

Your pom.xml file may be modified to include the following dependency:

<dependency>
  <groupId>com.iopipe</groupId>
  <artifactId>iopipe-logger-log4j2</artifactId>
</dependency>

Due to the way shading works, you will be required to always use the Log4j2 Transformer if you wish to support multiple appenders within your project and its dependencies. Not doing so may result in not being able to use multiple various plugins with Log4j2.

Configuration

Configuring your project to use this adapter for Log4j2 will be the same as configuring other appenders as specified in the configuration documentation.

Using the following as an example log4j2.xml resource at a very basic level to report to IOpipe (the error level may be modified accordingly as needed):

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="error">
  <Appenders>
    <IOpipe name="IOpipe">
    </IOpipe>
  </Appenders>
  <Loggers>
    <Root level="error">
      <AppenderRef ref="IOpipe" />
    </Root>
  </Loggers>
</Configuration>

Once you’re setup, you will need to configure IOpipe to enable the logging plugin. You can do this by setting the IOPIPE_LOGGER_ENABLED environment variable to true in the AWS Lambda configuration.