PHPackages davigs/laravel-tracker - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. davigs/laravel-tracker ActiveLibrary[Logging & Monitoring](/categories/logging) davigs/laravel-tracker ====================== A Laravel Visitor Tracker - Upgrading Laravel v10 1.0.0(2y ago)15MITPHPPHP ^8.1 Since Jun 30Pushed 2y agoCompare [ Source](https://github.com/davigs/laravel-tracker)[ Packagist](https://packagist.org/packages/davigs/laravel-tracker)[ RSS](/packages/davigs-laravel-tracker/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (11)Versions (2)Used By (0) Laravel Stats Tracker ===================== [](#laravel-stats-tracker) [![Latest Stable Version](https://camo.githubusercontent.com/40893718c95375a74e1d26058cac97113acb70c812ddc4029568a0044c3ac4d6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707261676d6172782f747261636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pragmarx/tracker) [![License](https://camo.githubusercontent.com/a7d953c880516e66cbc40f3833498c010255e60ca0142114a22829dc66fe28e4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4253445f335f436c617573652d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) [![Downloads](https://camo.githubusercontent.com/696e9d84b1e186d9a912e10c5746560bc063a71c8c3e09948e16d877a5c03420/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f707261676d6172782f747261636b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pragmarx/tracker) ### Tracker gathers a lot of information from your requests to identify and store: [](#tracker-gathers-a-lot-of-information-from-your-requests-to-identify-and-store) - **Sessions** - **Page Views (hits on routes)** - **Users (logged users)** - **Devices** (computer, smartphone, tablet...) - **Languages** (preference, language range) - **User Devices** (by, yeah, storing a cookie on each device) - **Browsers** (Chrome, Mozilla Firefox, Safari, Internet Explorer...) - **Operating Systems** (iOS, Mac OS, Linux, Windows...) - **Geo Location Data** (Latitute, Longitude, Country and City) - **Routes and all its parameters** - **Events** - **Referers** (url, medium, source, search term...) - **Exceptions/Errors** - **Sql queries and all its bindings** - **Url queries and all its arguments** - **Database connections** Index ----- [](#index) - [Why?](#why) - [How To Use It](#usage) - [Screenshots](#screenshots) - [Blade Views](#views) - [Table Schemas](#how-data-is-stored) - [System Requirements](#requirements) - [Installing](#installing) - [Upgrading](upgrading.md) - [Changelog](changelog.md) - [Contributing](#contributing) Why? ---- [](#why) Storing user tracking information, on indexed and normalized database tables, wastes less disk space and ease the extract of valuable information about your application and business. Usage ----- [](#usage) As soon as you install and enable it, Tracker will start storing all information you tell it to, then you can in your application use the Tracker Facade to access everything. Here are some of the methods and relationships available: #### Current Session/Visitor [](#current-sessionvisitor) ``` $visitor = Tracker::currentSession(); ``` Most of those methods return an Eloquent model or collection, so you can use not only its attributes, but also relational data: ``` var_dump( $visitor->client_ip ); var_dump( $visitor->device->is_mobile ); var_dump( $visitor->device->platform ); var_dump( $visitor->geoIp->city ); var_dump( $visitor->language->preference ); ``` #### Sessions (visits) [](#sessions-visits) ``` $sessions = Tracker::sessions(60 * 24); // get sessions (visits) from the past day ``` ``` foreach ($sessions as $session) { var_dump( $session->user->email ); var_dump( $session->device->kind . ' - ' . $session->device->platform ); var_dump( $session->agent->browser . ' - ' . $session->agent->browser_version ); var_dump( $session->geoIp->country_name ); foreach ($session->session->log as $log) { var_dump( $log->path ); } } ``` #### Online Users [](#online-users) Brings all online sessions (logged and unlogged users) ``` $users = Tracker::onlineUsers(); // defaults to 3 minutes ``` #### Users [](#users) ``` $users = Tracker::users(60 * 24); ``` #### User Devices [](#user-devices) ``` $users = Tracker::userDevices(60 * 24, $user->id); ``` #### Events [](#events) ``` $events = Tracker::events(60 * 24); ``` #### Errors [](#errors) ``` $errors = Tracker::errors(60 * 24); ``` #### PageViews summary [](#pageviews-summary) ``` $pageViews = Tracker::pageViews(60 * 24 * 30); ``` #### PageViews By Country summary [](#pageviews-by-country-summary) ``` $pageViews = Tracker::pageViewsByCountry(60 * 24); ``` #### Filter range [](#filter-range) You can send timestamp ranges to those methods using the Minutes class: ``` $range = new Minutes(); $range->setStart(Carbon::now()->subDays(2)); $range->setEnd(Carbon::now()->subDays(1)); Tracker::userDevices($range); ``` #### Routes By Name [](#routes-by-name) Having a route of ``` Route::get('user/{id}', ['as' => 'user.profile', 'use' => 'UsersController@profile']); ``` You can use this method to select all hits on that particular route and count them using Laravel: ``` return Tracker::logByRouteName('user.profile') ->where(function($query) { $query ->where('parameter', 'id') ->where('value', 1); }) ->count(); ``` And if you need count how many unique visitors accessed that route, you can do: ``` return Tracker::logByRouteName('tracker.stats.log') ->where(function($query) { $query ->where('parameter', 'uuid') ->where('value', '8b6faf82-00f1-4db9-88ad-32e58cfb4f9d'); }) ->select('tracker_log.session_id') ->groupBy('tracker_log.session_id') ->distinct() ->count('tracker_log.session_id'); ``` Screenshots ----------- [](#screenshots) ### Visits [](#visits) [![visits](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/visits.png)](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/visits.png) ### Charts [](#charts) [![charts](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/summary.png)](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/summary.png) ### Users [](#users-1) [![users](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/users.png)](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/users.png) ### Events [](#events-1) [![events](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/events.png)](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/events.png) ### Errors [](#errors-1) [![errors](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/errors.png)](https://raw.githubusercontent.com/antonioribeiro/tracker/master/src/views/screenshots/errors.png) Blade Views ----------- [](#blade-views) The views above are available in this package, but you need to install the `sb-admin` panel on your public folder, please look at the instructions below. How data is stored ------------------ [](#how-data-is-stored) All tables are prefixed by `tracker_`, and here's an extract of some of them, showing columns and contents: ### sessions [](#sessions) ``` +-----+--------------------------------------+---------+-----------+----------+-----------------+------------+-----------+----------+-------------+ | id | uuid | user_id | device_id | agent_id | client_ip | referer_id | cookie_id | geoip_id | language_id | +-----+--------------------------------------+---------+-----------+----------+-----------------+------------+-----------+----------+-------------+ | 1 | 09465be3-5930-4581-8711-5161f62c4373 | 1 | 1 | 1 | 186.228.127.245 | 2 | 1 | 2 | 3 | | 2 | 07399969-0a19-47f0-862d-43b06d7cde45 | | 2 | 2 | 66.240.192.138 | | 2 | 2 | 2 | +-----+--------------------------------------+---------+-----------+----------+-----------------+------------+-----------+----------+-------------+ ``` ### devices [](#devices) ``` +----+----------+-------------+-------------+------------------+-----------+ | id | kind | model | platform | platform_version | is_mobile | +----+----------+-------------+-------------+------------------+-----------+ | 1 | Computer | unavailable | Windows 8 | | | | 2 | Tablet | iPad | iOS | 7.1.1 | 1 | | 3 | Computer | unavailable | Windows XP | | | | 5 | Computer | unavailable | Other | | | | 6 | Computer | unavailable | Windows 7 | | | | 7 | Computer | unavailable | Windows 8.1 | | | | 8 | Phone | iPhone | iOS | 7.1 | 1 | +----+----------+-------------+-------------+------------------+-----------+ ``` ### agents [](#agents) ``` +----+-----------------------------------------------------------------------------------------------------------------------------------------+-------------------+-----------------+ | id | name | browser | browser_version | +----+-----------------------------------------------------------------------------------------------------------------------------------------+-------------------+-----------------+ | 1 | Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36 | Chrome | 35.0.1916 | | 2 | Mozilla/5.0 (iPad; CPU OS 7_1_1 like Mac OS X) AppleWebKit/537.51.1 (KHTML, like Gecko) CriOS/34.0.1847.18 Mobile/11D201 Safari/9537.53 | Chrome Mobile iOS | 34.0.1847 | | 3 | Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) | IE | 6.0 | | 4 | Python-urllib/2.6 | Other | | | 5 | Other | Other | | | 6 | Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.137 Safari/537.36 | Chrome | 34.0.1847 | | 7 | Mozilla/5.0 (Windows NT 6.3; rv:28.0) Gecko/20100101 Firefox/28.0 | Firefox | 28.0 | | 8 | Mozilla/5.0 (iPhone; CPU iPhone OS 7_1 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like Gecko) Version/7.0 Mobile/11D169 Safari/9537.53 | Mobile Safari | 7.0 | +----+-----------------------------------------------------------------------------------------------------------------------------------------+-------------------+-----------------+ ``` ### languages [](#languages) ``` +----+------------+----------------+ | id | preference | language_range | +----+------------+----------------+ | 1 | en | ru=0.8,es=0.5 | | 2 | es | en=0.7,ru=0.3 | | 3 | ru | en=0.5,es=0.5 | +----+------------+----------------+ ``` ### domains [](#domains) ``` +----+--------------------------+ | id | name | +----+--------------------------+ | 1 | antoniocarlosribeiro.com | +----+--------------------------+ ``` ### errors [](#errors-2) ``` +----+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | id | code | message | +----+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 1 | 404 | | | 2 | 500 | Call to undefined method PragmaRX\Tracker\Tracker::sessionLog() | | 3 | 500 | Trying to get property of non-object (View: /home/forge/stage.antoniocarlosribeiro.com/app/views/admin/tracker/log.blade.php) | | 4 | 500 | syntax error, unexpected 'foreach' (T_FOREACH) | | 5 | 500 | Call to undefined method PragmaRX\Tracker\Tracker::pageViewsByCountry() | | 6 | 500 | Class PragmaRX\Firewall\Vendor\Laravel\Artisan\Base contains 1 abstract method and must therefore be declared abstract or implement the remaining methods (Illuminate\Console\Command::fire) | | 7 | 405 | | | 8 | 500 | Trying to get property of non-object | | 9 | 500 | Missing argument 2 for Illuminate\Database\Eloquent\Model::setAttribute(), called in /home/forge/stage.antoniocarlosribeiro.com/vendor/laravel/framework/src/Illuminate/Database/Eloquent/Model.php on line 2444 and defined | +----+------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ ``` ### events [](#events-2) ``` +----+------------------------------------------------+ | id | name | +----+------------------------------------------------+ | 1 | illuminate.log | | 2 | router.before | | 3 | router.matched | | 4 | auth.attempt | | 5 | auth.login | | 6 | composing: admin.tracker.index | | 7 | creating: admin.tracker._partials.menu | | 8 | composing: admin.tracker._partials.menu | | 9 | creating: admin.layout | | 10 | composing: admin.layout | | 11 | creating: admin._partials.mainMenu | | 12 | composing: admin._partials.mainMenu | | 13 | creating: admin._partials.messages | | 14 | composing: admin._partials.messages | | 15 | creating: global._partials.google-analytics | | 16 | composing: global._partials.google-analytics | +----+------------------------------------------------+ ``` ### geoip [](#geoip) ``` +----+----------+-----------+--------------+---------------+---------------------------+--------+----------------+-------------+-----------+----------+------------+----------------+ | id | latitude | longitude | country_code | country_code3 | country_name | region | city | postal_code | area_code | dma_code | metro_code | continent_code | +----+----------+-----------+--------------+---------------+---------------------------+--------+----------------+-------------+-----------+----------+------------+----------------+ | 1 | 37.4192 | -122.057 | US | USA | United States | CA | Mountain View | 94043 | 650 | 807 | 807 | NA | | 2 | -10 | -55 | BR | BRA | Brazil | | | | | | | SA | | 3 | 30.3909 | -86.3161 | US | USA | United States | FL | Miramar Beach | 32550 | 850 | 686 | 686 | NA | | 4 | 38.65 | -90.5334 | US | USA | United States | MO | Chesterfield | 63017 | 314 | 609 | 609 | NA | | 5 | 42.7257 | -84.636 | US | USA | United States | MI | Lansing | 48917 | 517 | 551 | 551 | NA | | 6 | 42.8884 | -78.8761 | US | USA | United States | NY | Buffalo | 14202 | 716 | 514 | 514 | NA | | 7 | 40.1545 | -75.3809 | US | USA | United States | PA | Norristown | 19403 | 610 | 504 | 504 | NA | | 8 | 47.4891 | -122.291 | US | USA | United States | WA | Seattle | 98168 | 206 | 819 | 819 | NA | | 9 | 33.7516 | -84.3915 | US | USA | United States | GA | Atlanta | 30303 | 404 | 524 | 524 | NA | | 10 | 33.7633 | -117.794 | US | USA | United States | CA | Santa Ana | 92705 | 714 | 803 | 803 | NA | | 11 | 33.4357 | -111.917 | US | USA | United States | AZ | Tempe | 85281 | 480 | 753 | 753 | NA | | 12 | 40.7421 | -74.0018 | US | USA | United States | NY | New York | 10011 | 212 | 501 | 501 | NA | | 13 | 28.6185 | -81.4336 | US | USA | United States | FL | Orlando | 32810 | 407 | 534 | 534 | NA | | 14 | 38.6312 | -90.1922 | US | USA | United States | MO | Saint Louis | 63101 | 314 | 609 | 609 | NA | | 15 | 51 | 9 | DE | DEU | Germany | | | | | | | EU | | 16 | 52.5 | 5.75 | NL | NLD | Netherlands | | | | | | | EU | | 17 | 48.86 | 2.35 | FR | FRA | France | | | | | | | EU | | 18 | 60 | 100 | RU | RUS | Russian Federation | | | | | | | EU | | 19 | 51.5 | -0.13 | GB | GBR | United Kingdom | | | | | | | EU | | 20 | 42.8333 | 12.8333 | IT | ITA | Italy | | | | | | | EU | | 21 | 59.3333 | 18.05 | SE | SWE | Sweden | 26 | Stockholm | | | | | EU | | 22 | -41 | 174 | NZ | NZL | New Zealand | | | | | | | OC | | 23 | 37.57 | 126.98 | KR | KOR | Korea, Republic of | | | | | | | AS | | 24 | 1.3667 | 103.8 | SG | SGP | Singapore | | | | | | | AS | | 25 | -43.5333 | 172.633 | NZ | NZL | New Zealand | E9 | Christchurch | 8023 | | | | OC | | 26 | -27.471 | 153.024 | AU | AUS | Australia | 04 | Brisbane | | | | | OC | | 27 | 26.9167 | 75.8167 | IN | IND | India | 24 | Jaipur | | | | | AS | | 28 | 32 | 53 | IR | IRN | Iran, Islamic Republic of | | | | | | | AS | | 29 | 32.0617 | 118.778 | CN | CHN | China | 04 | Nanjing | | | | | AS | | 30 | -22.9 | -47.0833 | BR | BRA | Brazil | 27 | Campinas | | | | | SA | | 31 | 32.8073 | -117.132 | US | USA | United States | CA | San Diego | 92123 | 858 | 825 | 825 | NA | | 32 | -22.9 | -43.2333 | BR | BRA | Brazil | 21 | Rio De Janeiro | | | | | SA | +----+----------+-----------+--------------+---------------+---------------------------+--------+----------------+-------------+-----------+----------+------------+----------------+ ``` ### log [](#log) ``` +-----+------------+---------+----------+--------+---------------+---------+-----------+---------+------------+----------+ | id | session_id | path_id | query_id | method | route_path_id | is_ajax | is_secure | is_json | wants_json | error_id | +-----+------------+---------+----------+--------+---------------+---------+-----------+---------+------------+----------+ | 1 | 1 | 1 | | GET | 1 | | 1 | | | | | 2 | 1 | 2 | | GET | 2 | | 1 | | | | | 3 | 1 | 3 | | GET | 3 | | 1 | | | | | 4 | 1 | 3 | | POST | 4 | | 1 | | | | +-----+------------+---------+----------+--------+---------------+---------+-----------+---------+------------+----------+ ``` ### paths [](#paths) ``` +----+--------------------------------------------------------+ | id | path | +----+--------------------------------------------------------+ | 1 | / | | 2 | admin | | 3 | login | | 4 | admin/languages | | 5 | admin/tracker | | 6 | admin/pages | | 7 | jmx-console | | 8 | manager/html | | 9 | administrator | | 10 | joomla/administrator | | 11 | cms/administrator | | 12 | Joomla/administrator | | 13 | phpmyadmin | | 14 | phpMyAdmin | | 15 | mysql | | 16 | sql | | 17 | myadmin | | 18 | webdav | +----+--------------------------------------------------------+ ``` ### route\_paths [](#route_paths) ``` +----+----------+--------------------------------------------------------+ | id | route_id | path | +----+----------+--------------------------------------------------------+ | 1 | 1 | / | | 2 | 2 | admin | | 3 | 3 | login | | 4 | 4 | login | | 5 | 5 | admin/languages | | 6 | 6 | admin/tracker | | 7 | 7 | admin/pages | +----+----------+--------------------------------------------------------+ ``` ### routes [](#routes) ``` +----+--------------------------------------+----------------------------------------------------------+ | id | name | action | +----+--------------------------------------+----------------------------------------------------------+ | 1 | home | ACR\Controllers\Home@index | | 2 | admin | ACR\Controllers\Admin\Admin@index | | 3 | login.form | ACR\Controllers\Logon@form | | 4 | login.do | ACR\Controllers\Logon@login | | 5 | admin.languages.index | ACR\Controllers\Admin\Languages@index | | 6 | admin.tracker.index | ACR\Controllers\Admin\Tracker@index | | 7 | admin.pages.index | ACR\Controllers\Admin\Pages@index | | 8 | admin.tracker.log | ACR\Controllers\Admin\Tracker@log | | 9 | technology | ACR\Controllers\Technology@index | | 10 | technology.articles.show | ACR\Controllers\Technology@show | | 11 | language.select | ACR\Controllers\Language@select | | 12 | admin.tracker.summary | ACR\Controllers\Admin\Tracker@summary | | 13 | admin.tracker.api.pageviews | ACR\Controllers\Admin\Tracker@apiPageviews | | 14 | admin.tracker.api.pageviewsbycountry | ACR\Controllers\Admin\Tracker@apiPageviewsByCountry | | 15 | admin.pages.create | ACR\Controllers\Admin\Pages@create | | 16 | api.markdown | ACR\Controllers\Api@markdown | | 17 | admin.pages.store | ACR\Controllers\Admin\Pages@store | | 18 | bio | ACR\Controllers\StaticPages@show | | 19 | logout.do | ACR\Controllers\Logon@logout | | 20 | admin.tracker.index | ACR\Controllers\Admin\UsageTracker@index | | 21 | admin.tracker.api.pageviewsbycountry | ACR\Controllers\Admin\UsageTracker@apiPageviewsByCountry | | 22 | admin.tracker.api.pageviews | ACR\Controllers\Admin\UsageTracker@apiPageviews | +----+--------------------------------------+----------------------------------------------------------+ ``` ### sql\_queries ; [](#sql_queries-------------------) ``` +----+------------------------------------------+-------------------------------------------------------------------------------------------------+-------+---------------+ | id | sha1 | statement | time | connection_id | +----+------------------------------------------+-------------------------------------------------------------------------------------------------+-------+---------------+ | 1 | 5aee121018ac16dbf26dbbe0cf35fd44a29a5d7e | select * from "users" where "id" = ? limit 1 | 3.13 | 1 | | 2 | 0fc3f3a722b0f9ef38e6bee44fc3fde9fb1fd1d9 | select "created_at" from "articles" where "published_at" is not null order by "created_at" desc | 1.99 | 1 | +----+------------------------------------------+-------------------------------------------------------------------------------------------------+-------+---------------+ ``` Manually log things ------------------- [](#manually-log-things) If your application has special needs, you can manually log things like: #### Events [](#events-3) ``` Tracker::trackEvent(['event' => 'cart.add']); Tracker::trackEvent(['event' => 'cart.add', 'object' => 'App\Cart\Events\Add']); ``` #### Routes [](#routes-1) ``` Tracker::trackVisit( [ 'name' => 'my.dynamic.route.name', 'action' => 'MyDynamic@url' ], ['path' => 'my/dynamic/url'] ); ``` Requirements ------------ [](#requirements) - Laravel 5+ - PHP 5.3.7+ - Package "geoip/geoip":"~1.14" or "geoip2/geoip2":"~2.0" (If you are planning to store Geo IP information) For Laravel 4+ please use version 2.0.10. Installing ---------- [](#installing) #### Require the `tracker` package by **executing** the following command in your command line: [](#require-the-tracker-package-by-executing-the-following-command-in-your-command-line) ``` composer require pragmarx/tracker ``` #### Add the service provider to your app/config/app.php: [](#add-the-service-provider-to-your-appconfigappphp) ``` PragmaRX\Tracker\Vendor\Laravel\ServiceProvider::class, ``` #### Add the alias to the facade on your app/config/app.php: [](#add-the-alias-to-the-facade-on-your-appconfigappphp) ``` 'Tracker' => 'PragmaRX\Tracker\Vendor\Laravel\Facade', ``` #### Publish tracker configuration: [](#publish-tracker-configuration) **Laravel 4** ``` php artisan config:publish pragmarx/tracker ``` **Laravel 5** ``` php artisan vendor:publish --provider="PragmaRX\Tracker\Vendor\Laravel\ServiceProvider" ``` #### Enable the Middleware (Laravel 5) [](#enable-the-middleware-laravel-5) Open the newly published config file found at `app/config/tracker.php` and enable `use_middleware`: ``` 'use_middleware' => true, ``` #### Add the Middleware to Laravel Kernel (Laravel 5) [](#add-the-middleware-to-laravel-kernel-laravel-5) Open the file `app/Http/Kernel.php` and add the following to your web middlewares: ``` \PragmaRX\Tracker\Vendor\Laravel\Middlewares\Tracker::class, ``` #### Enable Tracker in your config.php (Laravel 4) or tracker.php (Laravel 5) [](#enable-tracker-in-your-configphp-laravel-4-or-trackerphp-laravel-5) ``` 'enabled' => true, ``` #### Publish the migration [](#publish-the-migration) ``` php artisan tracker:tables ``` This is only needed if you are on Laravel 4, because `vendor:publish` does it for you in Laravel 5. #### Create a database connection for it on your `config/database.php` [](#create-a-database-connection-for-it-on-your-configdatabasephp) ``` 'connections' => [ 'mysql' => [ ... ], 'tracker' => [ 'driver' => '...', 'host' => '...', 'database' => ..., 'strict' => false, // to avoid problems on some MySQL installs ... ], ], ``` #### Migrate it [](#migrate-it) If you have set the default connection to `tracker`, you can ``` php artisan migrate ``` Otherwise you'll have to ``` php artisan migrate --database=tracker ``` #### If you are planning to store Geo IP information, also install the geoip package: [](#if-you-are-planning-to-store-geo-ip-information-also-install-the-geoip-package) ``` composer require "geoip/geoip":"~1.14" or composer require "geoip2/geoip2":"~2.0" ``` #### And make sure you don't have the PHP module installed. This is a Debian/Ubuntu example: [](#and-make-sure-you-dont-have-the-php-module-installed-this-is-a-debianubuntu-example) ``` sudo apt-get purge php5-geoip ``` Everything Is Disabled By Default --------------------------------- [](#everything-is-disabled-by-default) Tracker has a lot of logging options, but you need to decide what you want to log. Starting by enabling this one: ``` 'log_enabled' => true, ``` It is responsible for logging page hits and sessions, basically the client IP address. Multiple authentication drivers ------------------------------- [](#multiple-authentication-drivers) You just have to all your auth IOC bidings to the array: ``` 'authentication_ioc_binding' => ['auth', 'admin'], ``` Stats Panel ----------- [](#stats-panel) To use the stats panel on your website you'll need to download the sb-admin 2 sources to your public folder: ``` git clone https://github.com/BlackrockDigital/startbootstrap-sb-admin-2.git public/templates/sb-admin-2 cd public/templates/sb-admin-2 git checkout tags/v3.3.7+1 git checkout -b v3.3.7+1 ``` And enabled in your config file: ``` 'stats_panel_enabled' => true, ``` Set the web middleware for stats routes (Laravel 5) ``` 'stats_routes_middleware' => 'web', ``` Only admins can view the stats, so if you don't have an is\_admin attribute on your user model, you'll have to add one: ``` public function getIsAdminAttribute() { return true; } ``` It can be 'admin', 'is\_admin', 'root' or 'is\_root'. Troubleshooting --------------- [](#troubleshooting) ### Is everything enabled? [](#is-everything-enabled) Make sure Tracker is enabled in the config file. Usually this is the source of most problems. ### Tail your laravel.log file [](#tail-your-laravellog-file) ``` tail -f storage/logs/laravel.log ``` Usually non-trackable IP addresses and other messages will appear in the log: ``` [2018-03-19 21:28:08] local.WARNING: TRACKER (unable to track item): 127.0.0.1 is not trackable. ``` ### SQLSTATE\[42000\]: Syntax error or access violation: 1067 Invalid default value for 'field name' [](#sqlstate42000-syntax-error-or-access-violation-1067-invalid-default-value-for-field-name) This is probably related to SQL modes on MySQL, specifically with `NO_ZERO_IN_DATE` and `NO_ZERO_DATE` modes: Because Laravel's defaults to ``` set session sql_mode='ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION' ``` You may need to change your Tracker database connection configuration to ``` 'connections' => [ ... 'tracker' => [ ... 'strict' => false, ], ], ``` Not able to track users? ------------------------ [](#not-able-to-track-users) If you get an error like: ``` Base table or view not found: 1146 Table 'tracker.users' doesn't exist ``` You probably need to change: ``` 'user_model' => 'PragmaRX\Tracker\Vendor\Laravel\Models\User', ``` To create (or use a current) a User model: ``` 'user_model' => 'App\TrackerUser', ``` And configure the Connection related to your users table: ``` protected $connection = 'mysql'; ``` Not able to track API's? ------------------------ [](#not-able-to-track-apis) In your kernel ``` protected $middlewareGroups = [ 'web' => [ ....... \PragmaRX\Tracker\Vendor\Laravel\Middlewares\Tracker::class, ], 'api' => [ ....... \PragmaRX\Tracker\Vendor\Laravel\Middlewares\Tracker::class, ], ]; ``` Author ------ [](#author) [Antonio Carlos Ribeiro](http://twitter.com/iantonioribeiro)[All Contributors](https://github.com/antonioribeiro/tracker/graphs/contributors) License ------- [](#license) Tracker is licensed under the BSD 3-Clause License - see the `LICENSE` file for details Contributing ------------ [](#contributing) Pull requests and issues are more than welcome. ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community19 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 89.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1044d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/fd92c340179f870d834d13903ef705fb6d0a5d1198087085f9b1079888edb8b6?d=identicon)[davigs](/maintainers/davigs) --- Top Contributors [![antonioribeiro](https://avatars.githubusercontent.com/u/3182864?v=4)](https://github.com/antonioribeiro "antonioribeiro (523 commits)")[![igorhaf](https://avatars.githubusercontent.com/u/1664569?v=4)](https://github.com/igorhaf "igorhaf (8 commits)")[![napestershine](https://avatars.githubusercontent.com/u/8603325?v=4)](https://github.com/napestershine "napestershine (6 commits)")[![aleplusplus](https://avatars.githubusercontent.com/u/6319838?v=4)](https://github.com/aleplusplus "aleplusplus (5 commits)")[![marlocorridor](https://avatars.githubusercontent.com/u/5117811?v=4)](https://github.com/marlocorridor "marlocorridor (5 commits)")[![ben-nsng](https://avatars.githubusercontent.com/u/5063993?v=4)](https://github.com/ben-nsng "ben-nsng (4 commits)")[![rogervila](https://avatars.githubusercontent.com/u/6053012?v=4)](https://github.com/rogervila "rogervila (4 commits)")[![mohabhassan](https://avatars.githubusercontent.com/u/17481828?v=4)](https://github.com/mohabhassan "mohabhassan (3 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (3 commits)")[![yuters](https://avatars.githubusercontent.com/u/801718?v=4)](https://github.com/yuters "yuters (2 commits)")[![gabriel-cardoso](https://avatars.githubusercontent.com/u/701338?v=4)](https://github.com/gabriel-cardoso "gabriel-cardoso (2 commits)")[![hafael](https://avatars.githubusercontent.com/u/571130?v=4)](https://github.com/hafael "hafael (2 commits)")[![kduma](https://avatars.githubusercontent.com/u/1062582?v=4)](https://github.com/kduma "kduma (2 commits)")[![ndberg](https://avatars.githubusercontent.com/u/13345669?v=4)](https://github.com/ndberg "ndberg (2 commits)")[![jet-deployer](https://avatars.githubusercontent.com/u/17733318?v=4)](https://github.com/jet-deployer "jet-deployer (1 commits)")[![xembill](https://avatars.githubusercontent.com/u/8319808?v=4)](https://github.com/xembill "xembill (1 commits)")[![kingsloi](https://avatars.githubusercontent.com/u/2467444?v=4)](https://github.com/kingsloi "kingsloi (1 commits)")[![LasseRafn](https://avatars.githubusercontent.com/u/2689341?v=4)](https://github.com/LasseRafn "LasseRafn (1 commits)")[![doncadavona](https://avatars.githubusercontent.com/u/8132015?v=4)](https://github.com/doncadavona "doncadavona (1 commits)")[![djam90](https://avatars.githubusercontent.com/u/979271?v=4)](https://github.com/djam90 "djam90 (1 commits)") --- Tags laravelloggingtrackinguser agentvisitorpragmarxtrackermobile-detection ### Embed Badge ![Health badge](/badges/davigs-laravel-tracker/health.svg) ``` [![Health](https://phpackages.com/badges/davigs-laravel-tracker/health.svg)](https://phpackages.com/packages/davigs-laravel-tracker) ``` ### Alternatives [pragmarx/tracker A Laravel Visitor Tracker 2.9k300.0k1](/packages/pragmarx-tracker) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)