Guia de Projeto Laravel

Setup completo de observabilidade para backends Laravel

Use este guia para serviços Laravel que precisam de contexto estável entre ciclo HTTP e workers de fila.

Escopo de Arquitetura

  • Kernel HTTP e middleware.
  • Controllers/serviços/repositórios.
  • Workers de fila e tarefas agendadas.

Setup Recomendado

  1. Inicialize SDK no bootstrap/service provider.
  2. Instrumente ciclo de requisição HTTP.
  3. Capture exceções no handler global.
  4. Instrumente jobs e APIs externas.

Contrato Mínimo de Dados

  • Tags consistentes service, env, version.
  • Correlation ID entre request e job enfileirado.
  • Contexto de erro com rota e classe de exceção.

Lista de Verificação

  • Requisições web geram logs/traces.
  • Jobs de fila geram sinais com mesmas tags de ambiente.
  • Jobs falhos com contexto suficiente para triagem.

Fortalecimento de Produção

  1. Credenciais apenas em secret store de deploy.
  2. Buffer seguro para workers de fila.
  3. Revalidação após upgrades do framework.

Solução de Problemas

  • Dados web sem fila: inicialize SDK também no worker.
  • Ruído alto: restrinja eventos de baixo valor.
  • Correlação quebrada: padronize IDs compartilhados.

Nesta página