v-pack/laravel-audit-trail

Package untuk logging aktivitas di file log dan MongoDB.

1.0.0 2025-03-14 09:25 UTC

Requires

• php: >=8.1
• laravel/framework: ^11.0

Suggests

• ext-mongodb: Required if using MongoDB as a database driver
• mongodb/laravel-mongodb: Required if using MongoDB for storing audit logs

MIT

• Miftach Noorvickia Mu'affaq

README

Pengenalan

v-pack/laravel-audit-trail adalah package untuk mencatat aktivitas pengguna di aplikasi Laravel. Log aktivitas akan disimpan di file .log Laravel dan MongoDB.

Instalasi

Tambahkan package ini ke Laravel menggunakan composer:

composer require v-pack/laravel-audit-trail

Konfigurasi

Setelah menginstal package, tambahkan middleware ke dalam alias middleware di bootstrap/app.php:

$middleware->alias([
    'log.activity' => \VPACK\AuditTrail\Middleware\LogActivity::class,
]);

Cara Penggunaan

Middleware log.activity akan otomatis mencatat setiap request yang masuk. Jika ingin menerapkannya pada route tertentu, tambahkan middleware ke dalam definisi route:

Route::middleware(['log.activity'])->group(function () {
    Route::get('/example', function () {
        return response()->json(['message' => 'Hello World']);
    });
});

Cara Kerja

1. Setiap request yang masuk akan dicatat melalui middleware LogActivity.
2. Log aktivitas akan disimpan dalam dua tempat:
   • File `** Laravel**: Disimpan dalam format harian (storage/logs/laravel-YYYY-MM-DD.log`).
   • MongoDB: Disimpan dalam koleksi activity_logs.
3. Jika MongoDB mengalami error saat menyimpan, aplikasi tetap berjalan tanpa error.

Pengecekan Log

Untuk melihat log yang tersimpan di MongoDB, buka MongoDB Compass dan sambungkan ke database MongoDB yang digunakan. Kemudian, buka koleksi activity_logs untuk melihat data yang tersimpan.

Untuk melihat log di file .log, cek di storage/logs/laravel-YYYY-MM-DD.log.

Lisensi

Package ini dirilis dengan lisensi MIT.