Laravel Activity Tracker

Fork Notice: This package is a fork of the excellent laravel-logger by Jeremy Kenedy. This fork adds enhancements and maintains compatibility with newer Laravel versions. All credit for the original work goes to Jeremy Kenedy.

Laravel Activity Tracker is an activity event logger for your Laravel or Lumen application. It comes out the box with ready to use with dashboard to view your activity. It can be added as a middleware or called through a trait. Easily have an Activity Log. This package is easily configurable and customizable. Supports Laravel 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 6, 7, 8, 9, 10 and 11+

Table of contents

• Features
• Requirements
• Integrations
• Laravel Installation Instructions
• Lumen Installation Instructions
• Configuration
  • Environment File
• Usage
  • Authentication Middleware Usage
  • Trait Usage
• Routes
• Search
• Screenshots
• File Tree
• Opening an Issue
• License

Features

Laravel Activity Logger Features
Logs login page visits
Logs user logins
Logs user logouts
Routing Events can recording using middleware
Records activity timestamps
Records activity description
Records activity details (optional)
Records model related to the activity (optional)
Records activity user type with crawler detection
Records activity Method
Records activity Route
Records activity Ip Address
Records activity User Agent
Records activity Browser Language
Records activity referrer
Customizable activity model
Activity panel dashboard
Individual activity drilldown report dashboard
Activity Drilldown looks up Id Address meta information
Activity Drilldown shows user roles if enabled
Activity Drilldown shows associated user events
Activity log can be cleared, restored, and destroyed using eloquent softdeletes
Cleared activity logs can be viewed and have drilldown ability
Uses font awesome, cdn assets can be optionally called in configuration
Uses Geoplugin API for drilldown IP meta information
Uses Language localization files
Lots of configuration options

Requirements

• Laravel 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 6, and 7+
• jaybizzle/laravel-crawler-detect included dependency in composer.json (for crawler detection)

🎞️ Video Tour

If you'd prefer a more visual review of this package, please watch this video on Laravel Package Tutorial.

Integrations

Laravel logger can work out the box with or without the following roles packages:

• jeremykenedy/laravel-roles
• spatie/laravel-permission
• Zizaco/entrust
• romanbican/roles
• ultraware/roles

Laravel Installation Instructions

1. From your projects root folder in terminal run:

    composer require dimer47/laravel-activity-tracker

2. Register the package

• Laravel 5.5 and up Uses package auto discovery feature, no need to edit the config/app.php file.

• Laravel 5.4 and below Register the package with laravel in config/app.php under providers with the following:

    'providers' => [
        Dimer47\LaravelActivityTracker\LaravelActivityTrackerServiceProvider::class,
    ];

3. Run the migration to add the table to record the activities to:

    php artisan migrate

• Note: If you want to specify a different table or connection make sure you update your .env file with the needed configuration variables.

4. Optionally Update your .env file and associated settings (see Environment File section)

5. Optionally publish the packages views, config file, assets, and language files by running the following from your projects root folder:

    php artisan vendor:publish --tag=LaravelActivityTracker

Lumen Installation Instructions

This installs laravel-activity-tracker without the GUI

1. From your projects root folder in terminal run:

    composer require dimer47/laravel-activity-tracker

2. Register the package

Register the package with laravel in bootstrap/app.php with the following:

    $app->register(\Jaybizzle\LaravelCrawlerDetect\LaravelCrawlerDetectServiceProvider::class);
    $app->configure('laravel-activity-tracker');
    $app->register(\Dimer47\LaravelActivityTracker\LaravelActivityTrackerServiceProvider::class);
    $app->routeMiddleware(['activity' => \Dimer47\LaravelActivityTracker\App\Http\Middleware\LogActivity::class, ]);

3. Copy the configuration file laravel-activity-tracker.php to your config/ directory

Set LARAVEL_ACTIVITY_TRACKER_DISABLE_ROUTES=true in your .env file!

4. Run the migration to add the table to record the activities to:

    php artisan migrate

• Note: If you want to specify a different table or connection make sure you update your .env file with the needed configuration variables.

5. Optionally Update your .env file and associated settings (see Environment File section)

Configuration

Laravel Activity Logger can be configured in directly in /config/laravel-activity-tracker.php if you published the assets. Or you can variables to your .env file.

Environment File

Here are the .env file variables available:

LARAVEL_ACTIVITY_TRACKER_DATABASE_CONNECTION=mysql
LARAVEL_ACTIVITY_TRACKER_DATABASE_TABLE=laravel_logger_activity
LARAVEL_ACTIVITY_TRACKER_ROLES_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_ROLES_MIDDLWARE=role:admin
LARAVEL_ACTIVITY_TRACKER_MIDDLEWARE_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_MIDDLEWARE_EXCEPT=
LARAVEL_ACTIVITY_TRACKER_ACTIVITY_MODEL=Dimer47\LaravelActivityTracker\App\Models\Activity
LARAVEL_ACTIVITY_TRACKER_USER_MODEL=App\User
LARAVEL_ACTIVITY_TRACKER_USER_ID_FIELD=id
LARAVEL_ACTIVITY_TRACKER_DISABLE_ROUTES=false
LARAVEL_ACTIVITY_TRACKER_PAGINATION_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_CURSOR_PAGINATION_ENABLED=false
LARAVEL_ACTIVITY_TRACKER_PAGINATION_PER_PAGE=25
LARAVEL_ACTIVITY_TRACKER_DATATABLES_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_ENABLE_SEARCH=true
LARAVEL_ACTIVITY_TRACKER_SEARCH_FIELDS=description,user,method,route,ip
LARAVEL_ACTIVITY_TRACKER_DASHBOARD_MENU_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_DASHBOARD_DRILLABLE=true
LARAVEL_ACTIVITY_TRACKER_LOG_RECORD_FAILURES_TO_FILE=true
LARAVEL_ACTIVITY_TRACKER_FLASH_MESSAGE_BLADE_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_LAYOUT=layouts.app
LARAVEL_ACTIVITY_TRACKER_BOOTSTRAP_VERSION=4
LARAVEL_ACTIVITY_TRACKER_BLADE_PLACEMENT=stack                    #option: yield or stack
LARAVEL_ACTIVITY_TRACKER_BLADE_PLACEMENT_CSS=css-header           #placement name
LARAVEL_ACTIVITY_TRACKER_BLADE_PLACEMENT_JS=scripts-footer        #placement name
LARAVEL_ACTIVITY_TRACKER_JQUERY_CDN_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_JQUERY_CDN_URL=https://code.jquery.com/jquery-2.2.4.min.js
LARAVEL_ACTIVITY_TRACKER_BOOTSTRAP_CSS_CDN_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_BOOTSTRAP_CSS_CDN_URL=https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css
LARAVEL_ACTIVITY_TRACKER_BOOTSTRAP_JS_CDN_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_BOOTSTRAP_JS_CDN_URL=https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js
LARAVEL_ACTIVITY_TRACKER_POPPER_JS_CDN_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_POPPER_JS_CDN_URL=https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.js
LARAVEL_ACTIVITY_TRACKER_FONT_AWESOME_CDN_ENABLED=true
LARAVEL_ACTIVITY_TRACKER_FONT_AWESOME_CDN_URL=https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css

Usage

Middleware Usage

Events for laravel authentication scaffolding are listened for as providers and are enabled via middleware. You can add events to your routes and controllers via the middleware:

activity

Example to start recording page views using middlware in web.php:

Route::group(['middleware' => ['web', 'activity']], function () {
    Route::get('/', 'WelcomeController@welcome')->name('welcome');
});

This middlware can be enabled/disabled in the configuration settings.

Trait Usage

Events can be recorded directly by using the trait. When using the trait you can customize the event description.

To use the trait:

1. Include the call in the head of your class file:

       use Dimer47\LaravelActivityTracker\App\Http\Traits\ActivityLogger;

2. Include the trait call in the opening of your class:

       use ActivityLogger;

3. You can record the activity by calling the traits method:

       ActivityLogger::activity("Logging this activity.");
   

   Or as bellow to include extended activity details:

       ActivityLogger::activity("Logging this activity.", "Additional activity details.");
   

   Or even including the model related to the activity:

       ActivityLogger::activity("Logging this activity.", "Additional activity details.", ["id" => 1, "model" => "App\Models\User"]);
   

Routes

Laravel Activity Dashbaord Routes

• /activity
• /activity/cleared
• /activity/log/{id}
• /activity/cleared/log/{id}

Custom package routes

If you wish to change the route paths, names or other options you can disable the default routes in your .env file by setting

LARAVEL_ACTIVITY_TRACKER_DISABLE_ROUTES=true

If you are on an existing install, you will also need update your laravel-activity-tracker.php config file to add the config option:

'disableRoutes' => env('LARAVEL_ACTIVITY_TRACKER_DISABLE_ROUTES', false),

You can then add the routes directly to your application's routes/web.php file, and customise as required.

Route::group(['prefix' => 'activity', 'namespace' => 'Dimer47\LaravelActivityTracker\App\Http\Controllers', 'middleware' => ['web', 'auth', 'activity']], function () {

    // Dashboards
    Route::get('/', 'ActivityTrackerController@showAccessLog')->name('activity');
    Route::get('/cleared', ['uses' => 'ActivityTrackerController@showClearedActivityLog'])->name('cleared');

    // Drill Downs
    Route::get('/log/{id}', 'ActivityTrackerController@showAccessLogEntry');
    Route::get('/cleared/log/{id}', 'ActivityTrackerController@showClearedAccessLogEntry');

    // Forms
    Route::delete('/clear-activity', ['uses' => 'ActivityTrackerController@clearActivityLog'])->name('clear-activity');
    Route::delete('/destroy-activity', ['uses' => 'ActivityTrackerController@destroyActivityLog'])->name('destroy-activity');
    Route::post('/restore-log', ['uses' => 'ActivityTrackerController@restoreClearedActivityLog'])->name('restore-activity');
});

Search

adding dynamic search fields (description , user, URL , method and ip address)

High Performance Paginator

When dealing with millions activity records, default behavior of not paginate records or Laravel's paginator (enabled LARAVEL_ACTIVITY_TRACKER_PAGINATION_ENABLED=true) may lead to huge performance penalties. For that use case you may set LARAVEL_ACTIVITY_TRACKER_CURSOR_PAGINATION_ENABLED=true to enable Laravel's Cursor Pagination feature. This will heavily improve Laravel Activity Tracker page loading time. If you choose to do so it's advisable to read Cursor vs. Offset Pagination section on Laravel's documentation to get acquainted with Cursor Pagination limitations.

.env file

add these configurations to your .env file to control the logging search

LARAVEL_ACTIVITY_TRACKER_ENABLE_SEARCH=true
// you can customize your search using these options [description,user,method,route,ip]
LARAVEL_ACTIVITY_TRACKER_SEARCH_FIELDS=description,user,method,route,ip

by default all search fields are enabled when you enable the search with this one line configuration

LARAVEL_ACTIVITY_TRACKER_SEARCH_ENABLE=true

Screenshots

File Tree

├── .env.travis
├── .gitignore
├── .travis.yml
├── CODE_OF_CONDUCT.md
├── LICENSE
├── README.md
├── composer.json
└── src
    ├── .env.example
    ├── LaravelActivityTrackerServiceProvider.php
    ├── app
    │   ├── Http
    │   │   ├── Controllers
    │   │   │   └── ActivityTrackerController.php
    │   │   ├── Middleware
    │   │   │   └── LogActivity.php
    │   │   └── Traits
    │   │       ├── ActivityLogger.php
    │   │       ├── IpAddressDetails.php
    │   │       └── UserAgentDetails.php
    │   ├── Listeners
    │   │   ├── LogAuthenticated.php
    │   │   ├── LogAuthenticationAttempt.php
    │   │   ├── LogFailedLogin.php
    │   │   ├── LogLockout.php
    │   │   ├── LogPasswordReset.php
    │   │   ├── LogSuccessfulLogin.php
    │   │   └── LogSuccessfulLogout.php
    │   ├── Logic
    │   │   └── helpers.php
    │   └── Models
    │       └── Activity.php
    ├── config
    │   └── laravel-activity-tracker.php
    ├── database
    │   └── migrations
    │       └── 2017_11_04_103444_create_activity_tracker_table.php
    ├── resources
    │   ├── lang
    │   │   ├── de
    │   │   │   └── laravel-activity-tracker.php
    │   │   └── en
    │   │       └── laravel-activity-tracker.php
    │   └── views
    │       ├── forms
    │       │   ├── clear-activity-log.blade.php
    │       │   ├── delete-activity-log.blade.php
    │       │   └── restore-activity-log.blade.php
    │       ├── logger
    │       │   ├── activity-log-cleared.blade.php
    │       │   ├── activity-log-item.blade.php
    │       │   ├── activity-log.blade.php
    │       │   └── partials
    │       │       └── activity-table.blade.php
    │       ├── modals
    │       │   └── confirm-modal.blade.php
    │       ├── partials
    │       │   ├── form-search.blade.php
    │       │   ├── form-status.blade.php
    │       │   ├── scripts.blade.php
    │       │   └── styles.blade.php
    │       └── scripts
    │           ├── add-title-attribute.blade.php
    │           ├── clickable-row.blade.php
    │           ├── confirm-modal.blade.php
    │           ├── datatables.blade.php
    │           └── tooltip.blade.php
    └── routes
        └── web.php

• Tree command can be installed using brew: brew install tree
• File tree generated using command tree -a -I '.git|node_modules|vendor|storage|tests'

Opening an Issue

Before opening an issue there are a couple of considerations:

• You are all awesome!
• Read the instructions and make sure all steps were followed correctly.
• Check that the issue is not specific to your development environment setup.
• Provide duplication steps.
• Attempt to look into the issue, and if you have a solution, make a pull request.
• Show that you have made an attempt to look into the issue.
• Check to see if the issue you are reporting is a duplicate of a previous reported issue.
• Following these instructions show me that you have tried.
• If you have a questions send me an email to jeremykenedy@gmail.com
• Need some help, I can do my best on Slack: https://opensourcehelpgroup.slack.com
• Please be considerate that this is an open source project that I provide to the community for FREE when opening an issue.

License

Laravel-logger is licensed under the MIT license. Enjoy!