polares552/activity-logger-laravel

Armazenamento de Logs via middleware Laravel

1.0.4 2020-08-03 18:13 UTC

This package is auto-updated.

Last update: 2024-04-29 04:27:32 UTC


README

Armazenamento de Logs podendo ser acionado via Middleware ou Trait. Suporta Laravel 5.*, 6.* e 7 (Não testado).

Requisitos

Instalação

1 - No terminal acesse a raiz do projeto e execute o comando:

$ composer require polares552/activity-logger-laravel

2 - Laravel 5.5 e superior efetua a descoberta automática de pacotes, sem necessidade de editar o arquivo config/app.php.

  • Laravel 5.4 e abaixo é necessário registrar o pacote adicionando o provider no arquivo config/app.php:
'providers' => [
        polares552\ActivityLogger\ActivityLoggerServiceProvider::class,
];

3 - Efetue a publicação do arquivo de configuração:

$ php artisan vendor:publish --provider="polares552\ActivityLogger\ActivityLoggerServiceProvider" --tag="config"

4 - Efetue a publicação do arquivo de banco de dados:

$ php artisan vendor:publish --provider="polares552\ActivityLogger\ActivityLoggerServiceProvider" --tag="migrations"

5 - Execute a Migration para criar a tabela no banco de dados.

php artisan migrate

Utilização

Via Middleware

Você pode efetuar o rastreamento dos eventos das rotas e controller utilizando o name activity no Route::group. Por exemplo:

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

Via Trait

Eventos podem ser gravados diretamente usando a Trait, possibilitando a personalização da descrição do evento a ser armazenado.

1 - Para utilizar a Trait adicione a chamada no cabeçalho da classe:

use polares552\ActivityLogger\App\Http\Traits\ActivityLogger;

2 - Inclua a chamada da Trait na class:

use ActivityLogger;

3 - Para gravar um novo log utilize o método activity.

ActivityLogger::activity("Descrição do Log.");

Recursos

Atualmente o ActivityLogger efetua o armazenamento dos seguintes itens:

  • Id do usuário autenticado;
  • Descrição do Log armazenado;
  • Tipo de registro efetuado;
  • Rota acessada;
  • Controller associado a rota - caso exista;
  • Método associado a rota - caso exista;
  • Parâmetros enviados na requisição;
  • Endereço IP;
  • Agente utilizado;
  • Idioma
  • URL corrente;
  • Tipo de requisição;
  • Data de cadastro;

Screenshots

Armazenamento