لاگ‌گیری با SDK لاراول

"repositories": [
    { "type": "composer", "url": "https://center.abrova.ir/api/packages/abrova/composer" }
]

composer require abrova-trace/laravel-sdk

'channels' => [
    // ... other channels

    'abrovatrace' => [
        'driver' => 'custom',
        'via' => AbrovaTrace\Laravel\Logging\AbrovaTraceLogChannel::class,
    ],
],

use Illuminate\Support\Facades\Log;

// Send logs to AbrovaTrace
Log::channel('abrovatrace')->info('User signed up', ['userId' => 123]);
Log::channel('abrovatrace')->warning('Rate limit approaching', ['remaining' => 5]);
Log::channel('abrovatrace')->error('Payment failed', [
    'orderId' => 'ORD-456',
    'reason' => 'insufficient_funds',
]);

use Illuminate\Support\Facades\Log;

Log::channel('abrovatrace')->debug('Debug information');
Log::channel('abrovatrace')->info('User action completed');
Log::channel('abrovatrace')->notice('Approaching rate limit');   // Maps to 'info'
Log::channel('abrovatrace')->warning('Slow query detected');     // Maps to 'warn'
Log::channel('abrovatrace')->error('Failed to save data');
Log::channel('abrovatrace')->critical('Service unavailable');    // Maps to 'fatal'
Log::channel('abrovatrace')->alert('Database connection lost');  // Maps to 'fatal'
Log::channel('abrovatrace')->emergency('App crashed');           // Maps to 'fatal'

use AbrovaTrace\Laravel\AbrovaTraceFacade as AbrovaTrace;
use AbrovaTrace\Laravel\Logging\LogLevel;

// Basic log
AbrovaTrace::log('Server started', LogLevel::INFO);

// With metadata
AbrovaTrace::log('Order processed', LogLevel::INFO, [
    'orderId' => 'ORD-123',
    'amount' => 99.99,
]);

// User ID: logs carry the id from setUser() (set automatically by the middleware)
AbrovaTrace::setUser(['id' => 'user_abc123']);
AbrovaTrace::log('Payment declined', LogLevel::ERROR, [
    'reason' => 'card_expired',
]);

// Convenience methods
AbrovaTrace::info('User logged in');
AbrovaTrace::warn('API rate limit at 80%');
AbrovaTrace::logError('Failed to send email');
// also: trace(), logDebug(), fatal()

// config/logging.php
'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['daily', 'abrovatrace'],
        'ignore_exceptions' => false,
    ],

    'abrovatrace' => [
        'driver' => 'custom',
        'via' => AbrovaTrace\Laravel\Logging\AbrovaTraceLogChannel::class,
    ],
],

// Now Log::info() sends to both daily file AND AbrovaTrace
Log::info('User action', ['userId' => 123]);

// Structured metadata
Log::channel('abrovatrace')->info('Order placed', [
    'orderId' => 'ORD-12345',
    'amount' => 4500000,
    'currency' => 'IRR',
    'items' => 3,
]);

// Automatically included with every log:
// - Platform ('laravel'), environment name and release
// - User id, when a user is set (the middleware sets the authenticated user)

// config/abrovatrace.php
'logging' => [
    'source_id' => env('ABROVATRACE_LOG_SOURCE_ID', null),     // Groups logs into one source; enables batch sending
    'source_name' => env('ABROVATRACE_LOG_SOURCE_NAME', null), // Display name for the source
    'batch_size' => 50,           // Send when buffer reaches this size
],