Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Logging support for Android devices
Latest commit c9ae8b1 @ConallH ConallH Update

Logging support for Android devices


Build requirements: Android SDK 2.3+ Runtime requirements: Android OS 2.3+


  • Send Logs via HTTP POST

    Option of changing from Token TCP to using HTTP POST sending to the endpoint ''

  • Send Logs via SSL

    The library can send logs via Token TCP over TLS/SSL over port 443 by default

  • Storing logs offline and sending when connected.

    While sending logs, if the device looses connection, logs are stored locally until a connection is reestablished then sent to Logentries. 10mb queue limit

  • TraceID

    Each log sent contains the device TraceID which is a unique 35 character ID.


Set up an account with Logentries at, and create a logfile, by clicking + Add New button and selecting the Manual Configuration Option at the bottom. Select Token TCP as the source type and copy the Token UUID printed in green.

Next, download the library jar file here and place it in the /yourProject/libs folder of your Android project.

Add the android.permission.INTERNET to the project manifest file.


In the desired Activity class, import

To create an instance of the Logger object in an Activity class:

AndroidLogger logger = AndroidLogger.createInstance(Context context, boolean useHttpPost, boolean useSsl,       boolean isUsingDataHub, String dataHubAddr, int dataHubPort, String token, boolean logHostName);

The library provides AndroidLogger object, which provides log() method to send messages to the endpoint. Example of usage is provided below:

In module 1.

private AndroidLogger logger = null;

logger = AndroidLogger.createInstance(getApplicationContext(), useHttp, useSSL, false, null, 0, token, appendHost);

logger.log(“Test message 1”);

In module 2.

private AndroidLogger logger2 = null;

Logger is set-up during to call to createInstance() in module 1. Also, we can re-create the instance with another token or different values for SSL or useHttp options.

logger2 = AndroidLogger.getInstance();
logger2.log(“Test message 2”);

DataHub Support

Additional constructors for AndroidLogger have been created for use with Logentries DataHub. There are two additional constructors added, one with a customID and one without customID. They are respectively:

  AndroidLogger logger = AndroidLogger.getLogger(Context context, String datahub_address, int datahub_port);


 AndroidLogger logger = AndroidLogger.getLogger(Context context, String datahub_address, int datahub_port, String customID);
  • context: for example, if in an Activity class, use getApplicationContext(), or if in an Application class, use getBaseContext().

  • datahub_address: is a String of the IP Address of your DataHub machine.

  • datahub_port: is an int of the port number of your incoming connection on your DataHub machine. The default is port 10000, but this can be changed to any port by altering the /etc/leproxy/leproxyLocal.config file on your DataHub machine and restarting the leproxy daemon using "sudo service leproxy restart".

  • customID - is a String of the customID you may wish to add to your log events.

NOTE: You cannot use both Token-based and DataHub-based AndroidLogger constructors in your application. You can only use one or the other.

Something went wrong with that request. Please try again.