Download the PHP package pgtruesdell/laravel-logsnag without Composer
On this page you can find all versions of the php package pgtruesdell/laravel-logsnag. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pgtruesdell/laravel-logsnag
More information about pgtruesdell/laravel-logsnag
Files in pgtruesdell/laravel-logsnag
Package laravel-logsnag
Short Description Logsnag's realtime monitoring + your Laravel project = 😎
License MIT
Homepage https://github.com/pgtruesdell/laravel-logsnag
Informations about the package laravel-logsnag
Laravel LogSnag
A full-featured Laravel integration for LogSnag's real-time event tracking API. Track events, monitor metrics, identify users, and pipe your Laravel logs straight to LogSnag.
Requirements
- PHP 8.2+
- Laravel 11 or 12
Installation
Publish the config file:
Add your LogSnag credentials to .env:
Configuration
The published config file (config/logsnag.php) contains:
Usage
The package provides three ways to interact with LogSnag: helper functions, the Facade, or by resolving the Logsnag class from the container. All three offer the same API.
Log Events
Track events happening in your application.
Or with the helper function:
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
channel |
string |
required | Event channel/category |
event |
string |
required | Event name |
description |
?string |
null |
Event description (supports Markdown when parser is set) |
icon |
?string |
null |
Emoji icon |
notify |
bool |
false |
Send push notification |
tags |
?array |
null |
Key-value tags for filtering |
parser |
?Parser |
null |
Parser::Markdown or Parser::Text |
userId |
?string |
null |
Associate event with a user |
timestamp |
?int |
null |
Unix timestamp (backdate events) |
Insights
Create or set a metric value.
Or with the helper:
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
title |
string |
required | Metric name |
value |
string\|int\|float |
required | Metric value |
icon |
?string |
null |
Emoji icon |
Mutate Insights
Increment or decrement an existing metric without knowing its current value.
Or with the helper:
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
title |
string |
required | Metric name |
incrementBy |
int\|float |
required | Amount to increment (negative to decrement) |
icon |
?string |
null |
Emoji icon |
Identify Users
Associate properties with a user for user-level analytics.
Or with the helper:
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
userId |
string |
required | Unique user identifier |
properties |
array<string, mixed> |
required | Key-value user properties |
Monolog Integration
Route your Laravel logs to LogSnag by adding a custom channel to config/logging.php:
Then use it like any other log channel:
You can also add it to your stack channel to send logs to LogSnag alongside your other drivers.
Monolog driver behavior:
- Uses the
logsnag.channelconfig value as the LogSnag channel name - Maps log levels to emoji icons via the
logsnag.iconsconfig - Automatically enables notifications for
Errorlevel and above - Appends log context as formatted JSON in the event description
- Respects the
levelsetting to filter out lower-priority logs
Error Handling
All API methods throw PGT\Logsnag\Client\LogsnagClientException on failure. The exception includes the HTTP response for debugging:
API Reference
This package covers the full LogSnag API:
| Endpoint | HTTP Method | Package Method |
|---|---|---|
/v1/log |
POST |
Logsnag::log() / logsnag() |
/v1/insight |
POST |
Logsnag::insight() / insight() |
/v1/insight |
PATCH |
Logsnag::mutateInsight() / mutate_insight() |
/v1/identify |
POST |
Logsnag::identify() / identify() |
Testing
Code Quality
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Paul Grant Truesdell, II
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-logsnag with dependencies
spatie/laravel-package-tools Version ^1.15.0
illuminate/contracts Version ^11.0|^12.0