Download the PHP package viu/viu-laravel without Composer
On this page you can find all versions of the php package viu/viu-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package viu-laravel
viu-laravel
Laravel SDK para o sistema Viu de centralização de logs
✨ Quer ver logs? → Joga no Viu. Viu?
viu-laravel integra o sistema de logging nativo do Laravel com a plataforma Viu, oferecendo:
- Monolog Handler — integração nativa via
config/logging.php - Facade — acesso direto via
Viu::info(),Viu::error(), etc. - Middleware — propagação automática de Correlation ID
- HTTP Transport (recomendado) — via Guzzle com retry + circuit breaker
- Kafka Transport (alternativo) — envio direto ao tópico Kafka
🚀 Features
- ✅ Monolog Handler — plug-and-play com
Log::channel('viu') - ✅ Auto-discovery — zero configuração manual de providers
- ✅ Circuit Breaker — previne connection storms
- ✅ Retry automático — backoff exponencial em 429/5xx
- ✅ Smart Batching — envia em lote, flush automático no shutdown
- ✅ Correlation IDs — rastreamento de requisições ponta-a-ponta
- ✅ PHP 8.1+ / Laravel 10/11/12
- ✅ Kafka support — via
longlang/phpkafka(pure PHP, sem extensão C)
📦 Instalação
O service provider é registrado automaticamente via auto-discovery do Laravel.
Opcional — Transport Kafka:
⚙️ Configuração
1. Publicar o arquivo de configuração
Isso cria config/viu.php no seu projeto.
2. Variáveis de ambiente (.env)
🎯 Formas de uso
1. Canal Monolog (recomendado)
Adicione o canal viu em config/logging.php:
Uso em código:
Sobrescrever o nível mínimo por canal:
2. Facade Viu
3. Injeção de dependência
🔗 Middleware — Correlation ID
O ViuCorrelationMiddleware propaga automaticamente o Correlation ID e Trace ID entre requisições,
garantindo rastreabilidade ponta-a-ponta nos logs.
Laravel 10 — app/Http/Kernel.php
Laravel 11/12 — bootstrap/app.php
Comportamento
| Cenário | Comportamento |
|---|---|
Header X-Correlation-ID presente |
Usa o valor recebido |
| Header ausente | Gera um novo UUID v4 |
Header X-Trace-ID presente |
Usa como Trace ID |
X-Trace-ID ausente |
Usa o Correlation ID como Trace ID |
Headers adicionados na response:
X-Correlation-IDX-Trace-ID
🚀 Modo Kafka (alternativo)
Para ambientes de alta performance onde o envio direto ao Kafka é desejado:
O modo HTTP é recomendado para a maioria dos casos por sua simplicidade e segurança (não expõe Kafka diretamente).
📋 Configuração completa
🧩 Payload enviado ao backend
🧪 Flush manual (queue workers / jobs)
Em processos de longa duração (queue workers, Octane, etc.), chame flush() após cada job para garantir o envio dos logs pendentes:
Via Facade:
🧪 Testes
📄 Licença
MIT — veja LICENSE.
All versions of viu-laravel with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/log Version ^10.0|^11.0|^12.0
illuminate/http Version ^10.0|^11.0|^12.0
monolog/monolog Version ^3.0
guzzlehttp/guzzle Version ^7.0