Logentries currently supports logging from Java using the following logging libraries:
You can sign up for a Logentries account simply by clicking Sign Up and entering your email address. Once you have your credentials and have logged in, create a new host in the UI with a name that represents your app. Then, select this host and create a new logfile with a name that represents what you're logging. Select 'TOKEN TCP' as the source_type and click Register to create the log.
To configure log4j, you will need to perform the following:
* (1) Install Log4j (if you are not already using it).
* (2) Install the Logentries Log4j plugin.
* (3) Configure the Logentries Log4j plugin.
Place this in your pom.xml
<dependencies>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>com.logentries</groupId>
<artifactId>logentries-appender</artifactId>
<version>RELEASE</version>
</dependency>
</dependencies>
Download log4j from:
https://logging.apache.org/log4j/1.2/download.html
Retrieve log4j jar file and place it the WEB-INF/lib folder of your project.
Then add it to the build path from within your project.
The next file you need is logentriesappender-1.1.27.jar which is the plugin for log4j. You can get it here.
Place this in the WEB-INF/lib folder of your project and add it to the buildpath as done above with log4j jar.
Download the required log4j.xml config file from here
Add this file to your project as it is the config which adds the plugin for log4j to send logs to Logentries. This file should be in added to the classpath.
In this file, you will see the following:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration debug="true">
<appender name="le" class="com.logentries.log4j.LogentriesAppender">
<!-- Enter your Logentries token, like bc0c4f90-a2d6-11e1-b3dd-0800200c9a66 -->
<!-- Or set an evironment variable like LOGENTRIES_TOKEN=bc0c4f90-a2d6-11e1-b3dd-0800200c9a66 -->
<param name="Token" value="LOGENTRIES_TOKEN" />
<param name="Debug" value="false" />
<param name="Ssl" value="false" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d{yyyy-MM-dd HH:mm:ss ZZZ} %-5p (%F:%L) %m" />
</layout>
</appender>
<logger name="example">
<level value="debug" />
</logger>
<root>
<priority value="debug"></priority>
<appender-ref ref="le" />
</root>
</log4j:configuration>
Replace the value "LOGENTRIES_TOKEN" with the token UUID that is to the right of your newly created logfile. Alternatively leave the Token entry empty in the log4j configuration and provide the token via an environment variable e.g., export LOGENTRIES_TOKEN=bc0c4f90-a2d6-11e1-b3dd-0800200c9a66. This approach makes it easy to provide different logging tokens without repackaging when moving an app through dev, test, and prod etc.
For debugging purposes set the debug parameter to true.
To log to a DataHub we can change log4j.xml configuration to send logs to your instance of DataHub.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration debug="true">
<appender name="le" class="com.logentries.log4j.LogentriesAppender">
<!-- Enter your Logentries token, like bc0c4f90-a2d6-11e1-b3dd-0800200c9a66 -->
<!-- Or set an evironment variable like LOGENTRIES_TOKEN=bc0c4f90-a2d6-11e1-b3dd-0800200c9a66 -->
<param name="Token" value="LOGENTRIES_TOKEN" />
<param name="Debug" value="false" />
<param name="Ssl" value="false" />
<param name="IsUsingDataHub" value="true"/>
<param name="DataHubAddr" value="localhost"/>
<param name="DataHubPort" value="10000"/>
<param name="LogHostName" value="true"/>
<param name="HostName" value="TestHost*001"/>
<param name="LogID" value="JavaTestID"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d{yyyy-MM-dd HH:mm:ss ZZZ} %-5p (%F:%L) %m" />
</layout>
</appender>
<logger name="example">
<level value="debug" />
</logger>
<root>
<priority value="debug"></priority>
<appender-ref ref="le" />
</root>
</log4j:configuration>
The extra parameters are the following,
<param name="IsUsingDataHub" value="true"/>: Sent to a DataHub instance if true.
<param name="DataHubAddr" value="localhost"/>: The IP of the DataHub instance that we will connect to.
<param name="DataHubPort" value="10000"/>: The Port of the DataHub instance that we will connect to.
<param name="LogHostName" value="true"/>: Prefixes log messages with a HostName
<param name="HostName" value="TestHost*001"/>: The HostName to prefix each log message with. If not set will be automatically detected.
<param name="LogID" value="JavaTestID"/>: The LogID to be prefixed with each log message. If not set it will not be logged.
With that done, you are ready to send logs to Logentries.
In each class you wish to log from, enter the following using directives at the top if not already there:
import org.apache.log4j.Logger;
import org.apache.log4j.LogManager;
Then create this object at class-level:
private static Logger log = LogManager.getRootLogger();
Now within your code in that class, you can log using log4j as normal and it will log to Logentries.
Example:
log.debug("Debugging Message");
log.info("Informational message");
log.warn("Warning Message");
To configure logback, you will need to perform the following:
* (1) Install Logback (if you are not already using it).
* (2) Install the Logentries Logback plugin.
* (3) Configure the Logentries Logback plugin.
Place this in your pom.xml
<dependencies>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.5</version>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.0.11</version>
</dependency>
<dependency>
<groupId>com.logentries</groupId>
<artifactId>logentries-appender</artifactId>
<version>RELEASE</version>
</dependency>
</dependencies>
Download the required logback.xml config file from here
Add this file to your project as it is the config which adds the plugin for logback to send logs to Logentries. This file should be in added to the classpath.
In this file, you will see the following:
<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
<appender name="LE"
class="com.logentries.logback.LogentriesAppender">
<Token>LOGENTRIES_TOKEN</Token>
<Ssl>False</Ssl>
<facility>USER</facility>
<layout>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</layout>
</appender>
<root level="debug">
<appender-ref ref="LE" />
</root>
</configuration>
Replace the value "LOGENTRIES_TOKEN" with the token UUID that is to the right of your newly created logfile.
Note that internal debug support for the appender itself is only available with log4j.
To log to a DataHub we can change logback.xml configuration to send logs to your instance of DataHub as seeb below.
<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
<appender name="LE"
class="com.logentries.logback.LogentriesAppender">
<Token>LOGENTRIES_TOKEN</Token>
<Ssl>False</Ssl>
<IsUsingDataHub>True</IsUsingDataHub>
<DataHubAddr>localhost</DataHubAddr>
<DataHubPort>10000</DataHubPort>
<LogHostName>true</LogHostName>
<LogID>MyLog</LogID>
<facility>USER</facility>
<layout>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</layout>
</appender>
<root level="debug">
<appender-ref ref="LE" />
</root>
</configuration>
The extra parameters are the following,
<IsUsingDataHub>True</IsUsingDataHub>: Sent to a DataHub instance if true.
<DataHubAddr>localhost</DataHubAddr>: The IP of the DataHub instance that we will connect to.
<DataHubPort>10000</DataHubPort>: The Port of the DataHub instance that we will connect to.
<LogHostName>true</LogHostName>: Prefixes log messages with a HostName
<HostName>MyHost</HostName>: The HostName to prefix each log message with. If not set will be automatically detected.
<LogID>MyLog</LogID>: The LogID to be prefixed with each log message. If not set it will not be logged.
With that done, you are ready to send logs to Logentries.
In each class you wish to log from, enter the following using directives at the top if not already there:
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
Then create this object at class-level:
private static Logger log = LoggerFactory.getLogger("logentries");
Now within your code in that class, you can log using logback as normal and it will log to Logentries.
Example:
log.debug("Debugging Message");
log.info("Informational message");
log.warn("Warning Message");
Currently logs which exceed 65536 characters in length, including any patterns and timestamps you may include, will be split and sent as multiple logs.