Weave Code
Laravel Graylog Laravel Package
exolnet/laravel-graylog
Exolnet's Laravel Graylog package integrates Graylog with Laravel's logging system via a GELF handler, sending application logs to Graylog. Configure host, port, and transport for centralized log collection and search.
This package extends Laravel’s log package to add a graylog channel.
Frequently asked questions about Laravel Graylog
- How do I install and configure exolnet/laravel-graylog in Laravel?
- Install the package with Composer, then define a Graylog channel in Laravel's config/logging.php using the package's GELF driver. Configure the Graylog host, port, and transport through environment variables or the channel options, then select that channel or add it to a stack. Clear the config cache and send a test log to confirm Graylog receives the event.
- Which Laravel and PHP versions does exolnet/laravel-graylog support?
- Version 1.15.0 adds Laravel 12 support and PHP 8.4 CI coverage, but it drops Laravel 10 support. Laravel 11 and 12 applications on supported PHP versions are the intended path for v1.15.0, while Laravel 10 applications should remain on v1.14.x. Always verify the exact Composer constraints for laravel/framework, monolog/monolog, and PHP before upgrading.
- Does v1.15.0 support Laravel 12, and what changed for Laravel 10 users?
- Yes, v1.15.0 adds Laravel 12 support and PHP 8.4 CI coverage. The important change is that it drops Laravel 10 support, even though the release is versioned as a minor update. Laravel 10 applications should stay on v1.14.x unless they are upgraded, and Laravel 11 applications should validate v1.15.0 in staging before widening constraints.
- What Graylog GELF transports can I use with this package?
- The package sends logs to Graylog through a GELF handler and lets you configure the host, port, and transport. The exact transport options depend on the underlying GELF handler and package configuration, so verify support for UDP, TCP, TLS, or HTTP in the package documentation. Test your chosen Graylog input in staging because transport behavior affects reliability and packet loss.
- How do I add a Graylog channel to Laravel's config/logging.php?
- Add a channel entry in config/logging.php using the package's Graylog/GELF driver and set the host, port, and transport values from your environment. Then set LOG_CHANNEL to that channel or include it in a logging stack alongside local fallback channels. After changing configuration, run php artisan config:clear and send a test log to verify ingestion.
- Can laravel-graylog log exceptions and structured context?
- Because the package plugs into Laravel's Monolog logging stack, normal Laravel logging APIs and exception reporting can flow through the Graylog channel. Structured context depends on how the GELF handler formats Monolog records and extra fields. Verify exception traces and custom context fields in Graylog before relying on them for production troubleshooting.
- Does this package support buffering, retry, or fallback logging if Graylog is down?
- The package is a Laravel logging channel, so buffering, retry, and asynchronous delivery depend on the GELF handler and transport configuration you choose. Keep a local fallback log channel and explicitly test what happens during a Graylog outage, DNS failure, or TLS error. Do not assume remote logging is non-blocking or lossless without validating the full pipeline.
- Is exolnet/laravel-graylog suitable for production and high log volume?
- It is suitable as observability plumbing for Laravel applications already using Graylog, not as business-critical application logic. Log volume affects application egress, network reliability, and Graylog ingestion capacity, so use buffered or asynchronous delivery where supported, sample noisy logs, and avoid blocking request paths on remote logging. Monitor both application latency and Graylog ingestion health.
- What are alternatives to exolnet/laravel-graylog for Laravel Graylog logging?
- You can configure Monolog's GELF handler directly in Laravel or use another Laravel Graylog/GELF package. Compare maintenance activity, Laravel and PHP version support, transport options, fallback behavior, and configuration conventions. This package is a good fit when you want a simple Laravel log channel that integrates with Graylog through GELF.
- How is exolnet/laravel-graylog maintained, licensed, and released?
- The package is actively versioned, with v1.15.0 adding Laravel 12 and PHP 8.4 CI while dropping Laravel 10. Because a minor release can contain a meaningful compatibility break, pin the package version in composer.json and review release notes before upgrading. Confirm the license and maintainer responsiveness from the repository before relying on it for critical logs.
Weaver
How can I help you explore Laravel packages today?