Logentries logging for iOS

This plugin is no longer officially supported or maintained by Logentries.

Main features

• online/offline logging
• dictionary serialization
• secure TLS connection
• thread safety
• application lifecycle logging
• application crash logging with stack traces

Installation

Just add files from lelib group into your project.

Need a token? Get a free account if you don't already have one.

Simple example

#import "lelib.h"

LELog* log = [LELog sharedInstance];
log.token = @"LOGENTRIES_TOKEN";

[log log:@"Hello World"];

Or with the class methods

#import "lelib.h"

[LELog sessionWithToken:@"LOGENTRIES_TOKEN"];

[LELog log:@"Hello World"];

Log easy around your classes

Add to your .pch

#import "lelib.h"

and call from your classes

[LELog log:@"Hello World"];

Early initialization

The library automatically hooks up to the exception handler and logs unhandled exceptions. This means that you should initialize the library as soon as possible to log all exceptions. Insert following lines to main.m to log exceptions even before application:didFinishLaunchingWithOptions: is invoked.

#import "lecore.h"

int main(int argc, char * argv[])
{
  @autoreleasepool {

    le_init();
    le_set_token("LOGENTRIES_TOKEN");

    return UIApplicationMain(argc, argv, nil, NSStringFromClass([AppDelegate class]));
  }
}

The token is stored in global variable. You do not have to setup token property
of LELog instance later.

Disable Console Logger

To disable the logger from logging to the console set debugLogs to false:

Objective-c

[log setDebugLogs:false];

Swift

log.debugLogs = false

Quick questions

Any dependencies? No dependencies. The library uses standard Obj-C and POSIX C.

How to log an event? Simply call [log log:@"Hello world"];

No network coverage? Log entries are stored in a file and sent to Logentries when the network is back.

When app crashes? If configured, the library logs information about the application crash with stack trace.

When app is forced to shut down by OS? There is no way to log it.