kuborgh/logentries-bundle

Bundle to integrate logentries as monolog logger into symfony

Logentries Bundle

![Build Status][travis-image] This bundle integrates logentries.com into your symfony application. It is intended as a monolog handler, but can be used for other purposes, too., _(*1)

Features

• Logging in JSON Format
• Easy integration vie monolog
• Transport abstraction to use HTTP/TCP/UDP as needed

Installation

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:, _(*2)

$ composer require kuborgh/logentries-bundle

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:, _(*3)

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new Kuborgh\LogentriesBundle\LogentriesBundle(),
        );

        // ...
    }

    // ...
}

Configuration

The full configuration can be shown with php app/console config:dump-reference kuborgh_logentries, _(*4)

Following sample configuration can be used inside the config.yml of your project, _(*5)

kuborgh_logentries:
    # Possibility to disable logentries in dev mode
    enabled: true

    # Create monolog compatible handlers
    monolog:
        # Name of the handler
        my_handler:
            # Transport for logging.
            transport: http_guzzle

            # Account Key of logentries.com account for http transport
            account_key: <logentries account key>

            # LogSet
            log_set: my_log_set

            # Log channel
            log: my_log

            # Loglevel (can not be configured in monolog config!)
            level: error

    # Create simple logger service
    logger:
        # Name of the service will be kuborgh_logentries.my_logger
        my_logger:
            # Transport for logging.
            transport: http_guzzle

            # Account Key of logentries.com account for http transport
            account_key: <logentries account key>

            # LogSet
            log_set: my_log_set

            # Log channel
            log: my_log

UDP Transport

UDP transport only needs a port, _(*6)

my_logger:
    transport: udp

    # UPD port assigned by logentries
    port: 12345

    # Alternative host, when using a proxy 
    host: host.proxy.lan

To enable monolog logging, add the defined handler(s) to the monolog section, _(*7)

monolog:
    custom:
        type: service
        id: kuborgh_logentries.handler.my_handler

Testing

You can run the unitttests with, _(*8)

$ composer install
$ bin/phpunit

The coverage report is saved in the coverage folder., _(*9)