README

LogSentry.dev 👋

Effortless log management—store, search, and secure your logs with ease!

Effortlessly collect, monitor, and secure your logs in real time—we store them for you! Search live data, get full audit context, and safely archive logs with encryption. Need old logs? Restore them in a click! 🚀🔎🔒

Important

You’ll need an account and API key to get started—sign up and start logging in minutes! 🔑🚀

Features

• 🚀 Seamless Log Collection – Easily gather logs from any app that can send a POST request. No complex setup required!
• 🔎 Real-Time Search & Monitoring – Instantly filter, search, and track your logs as they happen. Stay ahead of issues before they escalate!
• 🛡️ Complete Audit Trail – Collect valuable context with every log entry, making audits and debugging a breeze.
• 🔒 Secure Log Archiving – Encrypt and store old logs safely, ensuring compliance and long-term accessibility.
• ♻️ Instant Log Restoration – Need past logs? Restore them from the archive anytime with just a few clicks!

Installation

You can install the package via composer:

composer require logsentrydev/logsentry-laravel

You can publish the config file with:

php artisan vendor:publish --tag="logsentry-config"

This is the contents of the published config file:

return [
    'secret' => env('LOGSENTRY_SECRET'),
    'endpoint' => env('LOGSENTRY_ENDPOINT', 'https://logsentry.dev/api/v1/event'),
];

Usage

Note

In order to use this package you need a free LogSentry account. You also need to create an API key under your account.

1. Add the following to the channels key in your config/logging.php file

use LogSentry\Laravel\LogSentryLogHandler;

...

'channels' => [
    'logsentry' => [
        'driver'  => 'monolog',
        'handler' => LogSentryLogHandler::class,
        'with' => [
        ],
    ],

    ....
],

1. Set your logging channel to logsentry in your .env file.

LOG_CHANNEL=logsentry

1. Add your API key to your .env file. For example:

LOGSENTRY_SECRET="1|APl3KOP8vKDRuNS2SwvCEjn3whO6lXWODlPOz9b44e9daf29"

Testing

composer test

License

The MIT License (MIT). Please see License File for more information.