README

This package extends Laravel’s log package to add a graylog driver.

Installation

1. Require this package with composer:

   composer require exolnet/laravel-graylog

2. If you don't use package auto-discovery, add the service provider to the providers array in config/app.php:

   Exolnet\Graylog\GraylogServiceProvider::class

3. Add a graylog channel in your logging.php configuration file:

   'graylog' => [ 'driver' => 'graylog', 'level' => 'notice', 'handler_with' => [ 'transport' => env('LOG_GRAYLOG_TRANSPORT', 'udp'), 'host' => env('LOG_GRAYLOG_HOST', 'localhost'), 'port' => env('LOG_GRAYLOG_PORT', 12201), 'path' => env('LOG_GRAYLOG_PATH', '/gelf'), 'extra' => [ // ] ], ],

4. Change your LOG_CHANNEL for graylog or add it to your stack in the logging.php configuration file

Usage

Supported Transports

The following transports are supported: udp, tcp, ssl, http and https. Select the transport accordingly to your Graylog set up using the GRAYLOG_TRANSPORT configuration. By default, the udp transport is used.

The default path for http and https transports is /gelf. This value can be configured using the GRAYLOG_PATH configuration.

GRAYLOG_PATH=/gelf 

Testing

To run the phpUnit tests, please use:

composer test

Contributing

Please see CONTRIBUTING and CODE OF CONDUCT for details.

Security

If you discover any security related issues, please email security@exolnet.com instead of using the issue tracker.

Credits

• Simon Gaudreau
• Patricia Gagnon-Renaud
• Alexandre D'Eschambeault
• All Contributors

License

Copyright © eXolnet. All rights reserved.

This code is licensed under the MIT license. Please see the license file for more information.