felipemenezesdm/laravel-logger-adapter

There is no license information available for the latest version (v1.0.0) of this package.

Gerenciador de eventos de log para projetos Laravel

v1.0.0 2023-03-26 10:35 UTC

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

Unknown License

• Felipe Menezes

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

Links úteis

• Laravel Logger Adapter on GitHub
• Laravel Logger Adapter on Packagist