. * * @link https://www.librenms.org * * @copyright 2022 Tony Murray * @author Tony Murray */ namespace App\Providers; use App\Logging\Reporting\Middleware\AddGitInformation; use App\Logging\Reporting\Middleware\CleanContext; use App\Logging\Reporting\Middleware\SetGroups; use App\Logging\Reporting\Middleware\SetInstanceId; use App\Models\Callback; use ErrorException; use Facade\FlareClient\Report; use Facade\Ignition\Facades\Flare; use Illuminate\Support\Facades\Log; use Illuminate\Support\Str; use LibreNMS\Config; use LibreNMS\Util\Git; class ErrorReportingProvider extends \Facade\Ignition\IgnitionServiceProvider { /** @var int */ protected $errorReportingLevel = E_ALL & ~E_NOTICE; /** @var callable */ private $laravelErrorHandler; /** @var bool */ private $reportingEnabled; /** @var string|null */ private static $instanceId; public function boot(): void { /* @phpstan-ignore-next-line */ if (! method_exists(\Facade\FlareClient\Flare::class, 'filterReportsUsing')) { Log::debug("Flare client too old, disabling Ignition to avoid bug.\n"); return; } Flare::filterExceptionsUsing(function (\Exception $e) { if (Config::get('reporting.dump_errors')) { dump('Exception: ' . $e->getMessage(), $e->getFile() . ':' . $e->getLine()); } return $this->isReportingEnabled(); }); Flare::filterReportsUsing(function (Report $report) { return $this->isReportingEnabled(); }); Flare::determineVersionUsing(function () { return \LibreNMS\Util\Version::VERSION; }); // add git information, but cache it unlike the upstream provider Flare::registerMiddleware(AddGitInformation::class); // Filter some extra fields for privacy // Move to header middleware when switching to spatie/laravel-ignition Flare::registerMiddleware(CleanContext::class); // Add more LibreNMS related info Flare::registerMiddleware(SetGroups::class); Flare::registerMiddleware(SetInstanceId::class); // Override the Laravel error handler but save it to call when in modern code $this->laravelErrorHandler = set_error_handler([$this, 'handleError']); parent::boot(); } /** * Checks the state of the config and current install to determine if reporting should be enabled * The primary factor is the setting reporting.error */ public function isReportingEnabled(): bool { if ($this->reportingEnabled !== null) { return $this->reportingEnabled; } // safety check so we don't leak early reports (but reporting should not be loaded before the config is) if (! Config::isLoaded()) { return false; } $this->reportingEnabled = false; // don't cache before config is loaded // check the user setting if (Config::get('reporting.error') !== true) { \Log::debug('Reporting disabled by user setting'); return false; } // Only run in production if (! $this->app->isProduction()) { \Log::debug('Reporting disabled because app is not in production'); return false; } // Check git $git = Git::make(180); if ($git->isAvailable()) { if (! Str::contains($git->remoteUrl(), ['git@github.com:librenms/librenms.git', 'https://github.com/librenms/librenms.git'])) { \Log::debug('Reporting disabled because LibreNMS is not from the official repository'); return false; } if ($git->hasChanges()) { \Log::debug('Reporting disabled because LibreNMS is not from the official repository'); return false; } if (! $git->isOfficialCommit()) { \Log::debug('Reporting disabled due to local modifications'); return false; } } $this->reportingEnabled = true; return true; } /** * Report PHP deprecations, or convert PHP errors to ErrorException instances. * * @param int $level * @param string $message * @param string $file * @param int $line * @param array $context * @return bool * * @throws \ErrorException */ public function handleError($level, $message, $file = '', $line = 0, $context = []): bool { // report errors if they are allowed if ($this->errorReportingLevel & $level) { Flare::report(new ErrorException($message, 0, $level, $file, $line)); } // call the laravel error handler, unless using a legacy entry point (init.php) if (! defined('IGNORE_ERRORS')) { call_user_func($this->laravelErrorHandler, $level, $message, $file, $line); } return true; } public static function getInstanceId(): string { if (is_null(self::$instanceId)) { $uuid = Callback::get('error_reporting_uuid'); if (! $uuid) { $uuid = Str::uuid(); Callback::set('error_reporting_uuid', $uuid); } self::$instanceId = $uuid; } return self::$instanceId; } }