suver/laravel-gelf-logger

A package to send logs to a gelf compatible backend like graylog

1.0.1 2017-05-10 16:19 UTC

Requires

• php: >=5.6
• graylog2/gelf-php: ^1.5
• illuminate/support: ~5.2.0|~5.3.0|~5.4.0

Requires (Dev)

• orchestra/testbench: ^3.3
• phpunit/phpunit: ^5.5

MIT

• suver

• php
• laravel
• graylog
• gelf
• laravel-gelf
• suver

README

Form from

Laravel Gelf Logger

A package to send gelf logs to a gelf compatible backend like graylog. It is a laravel wrapper for bzikarsky/gelf-php package.

Table of contents

• Table of contents
• Installation
• Usage
  • Example
• Testing
• License

Installation

Install via composer

composer require suver/laravel-gelf-logger

Add it to your providers array in config/app.php:

suver\LaravelGelfLogger\LaravelGelfLoggerServiceProvider::class

If you want to use the facade, add it to your aliases array in config/app.php:

'GelfLogger' => \suver\LaravelGelfLogger\Facades\GelfLogger::class

Publish the configuration file:

php artisan vendor:publish --provider="suver\LaravelGelfLogger\LaravelGelfLoggerServiceProvider"

See the content of the published configuration file in config/gelf-logger.php if you want to change the defaults.

/**
 * The ip address of the log server. If the value below is null,
 * the default value '127.0.0.1' will be used.
 */
'host' => null,

/**
 * The udp port of the log server. If the value below is null,
 * the default value 12201 will be used.
 */
'port' => null

Usage

See the bzikarsky/gelf-php examples in his repo to find the available methods for the gelf() function.

Example

gelf()->alert('There was a foo in bar', ['foo' => 'bar']);

try {
    throw new \Exception('test exception');
} catch (\Exception $e) {
    gelf()->emergency('Exception example', [
        'exception' => $e
    ]);
}

Testing

composer test

License

laravel-gelf-logger is released under the MIT Licence. See the bundled LICENSE file for details.