felipemenezesdm / laravel-logger-adapter
Gerenciador de eventos de log para projetos Laravel
Requires
- php: ^8.1
- felipemenezesdm/laravel-commons: ^1.0
- google/cloud-logging: ^1.0
- illuminate/support: >=9.0
- maxbanton/cwh: ^2.0
- psr/log: ^2.0
This package is auto-updated.
Last update: 2025-03-26 14:43:20 UTC
README
Descrição
Biblioteca para gerenciamento de eventos de log para aplicações desenvolvidas com Laravel.
Instalação
Para instalar esta dependência, é necessário ter o Composer disponível em sua máquina. Baixe e instale o Composer a partir deste link: https://getcomposer.org/download/
Após ter instalado o composer, execute o seguinte comando para instalar a dependência no seu projeto Laravel:
composer require felipemenezesdm/laravel-logger-adapter
Uso
No arquivo de configuração de log do laravel logging.php, é necessário configurar os canais de log:
<?php return [ # ... 'channels' => [ # ... 'gcp' => [ 'driver' => 'custom', 'via' => \FelipeMenezesDM\LaravelLoggerAdapter\Loggers\GCPLogger::class, 'level' => env('LOG_LEVEL', 'debug'), ], 'aws' => [ 'driver' => 'custom', 'via' => \FelipeMenezesDM\LaravelLoggerAdapter\Loggers\AWSLogger::class, 'level' => env('LOG_LEVEL', 'debug'), ], # ... ], # ... ]
No arquivo de variáveis de ambiente .env, é necessário definir qual canal a ser utilizado, por exemplo:
APP_LOG_CHANNEL=gcp
Crie as fronteiras de log na aplicação usando a classe LogHandler, conforme o exemplo abaixo. É possível também usar o payload padronizado LogPayload, que foi implementado usando o pattern builder:
LogHandler::info(__('validate.access.token'), LogPayload::build()->setEndPoint("/test"));
Configuração
Abaixo, as variáveis de ambiente disponíveis para configurar a biblioteca:
Name | Valor padrão | Observação |
---|---|---|
APP_LOG_CHANNEL | stack, aws ou gcp | Driver de log: gcp, aws, stack |
APP_NAME | *** | Nome da aplicação |
APP_SERVICE_ID | *** | ID do serviço da aplicação |
APP_ENV | LOCAL, DEV, HOM ou PROD | Ambiente onde a aplicação está alocada |
AWS_ACCOUNT_ID | 000000000000 | Definir a ID da conta AWS para a aplicação |
AWS_ENDPOINT | http://127.0.0.1 | Definir o endpoint dos serviços AWS (indicado quando houver o uso do localstack) |
AWS_DEFAULT_REGION | us-east-1 | Definir a região padrão para uma aplicação alocada na AWS |
GCP_PROJECT_ID | N/A | ID do projeto no Google Cloud Plataform |
GOOGLE_APPLICATION_CREDENTIALS | N/A | Arquivo de credenciais do Google Cloud Platform |