Phalcon library to connect and make log entries using Logentries. You can adapt it to your own needs or improve it if you want.

Please write us if you have any feedback.

Thanks.

The master branch will always contain the latest stable version. If you wish to check older versions or newer ones currently under development, please switch to the relevant branch.

To use this library on your machine, you need at least:

• Composer
• PHP >= 5.4
• Latest stable Phalcon Framework release extension enabled

Additional requirements:

• Codeception >= 2.1.x (for testing)
• PHP_CodeSniffer >= 2.x (for testing)

Install composer in a common location or in your project:

$ curl -s http://getcomposer.org/installer | php

Create the composer.json file as follows:

{
    "require": {
        "sergeyklay/phalcon-logentries": "dev-master"
    }
}

Run the composer installer:

$ php composer.phar install

When you have made your account on Logentries. Log in and create a new host with a name that best represents your app. Then, click on your new host and inside that, create a new log file with a name that represents what you are logging, example: myerrors. Bear in mind, these names are purely for your own benefit. Under source type, select Token TCP and click Register. You will notice a token appear beside the name of the log, these is a unique identifier that the logging library will use to access that logfile. You can copy and paste this now or later.

Then create adapter instance:

$di->set('logger', function() {
    $logger = new \Phalcon\Logger\Adapter\Logentries([
        'token' => getenv('LOGENTRIES_TOKEN'),
        // optional parameters
    ]);
    
    return $logger;
});

LOGENTRIES_TOKEN is the token we copied earlier from the Logentries UI. It associates that logger with the log file on Logentries.

To Set a custom host name that will appear in your PHP log events as Key / Value pairs pass to the Logentries::__constructor the following parameters:

• host_name_enabled
• host_name
• host_id

For example:

$di->set('logger', function() {
    $logger = new \Phalcon\Logger\Adapter\Logentries([
        'token'             => getenv('LOGENTRIES_TOKEN'),
        'host_name_enabled' => true,
        'host_name'         => 'Custom_host_name_here',
        'host_id'           => 'Custom_ID_here_12345'
    ]);

    return $logger;
});

The host_name param can be left as an empty string, and the Logentries component will automatically attempt to assign a host name from your local host machine and use that as the custom host name.

To set a custom Host ID that will appear in your PHP log events as Key / Value pairs:

• Enter a value instead of the empty string in host_id => '';
• If no host_id is set and the empty string is left unaltered, no Host ID or Key / Value pairing will appear in your PHP logs.

Phosphorum use Codeception unit test.

First you need to re-generate base classes for all suites:

$ vendor/bin/codecept build

Execute all test with run command:

$ vendor/bin/codecept run
# OR
$ vendor/bin/codecept run --debug # Detailed output

More details about Console Commands see here.

Phalcon Logentries is open-sourced software licensed under the New BSD License. © Phalcon Framework Team and contributors