Observabilidade do widget

Política do Telescope

Os batches do Telescope associados a rotas /api/widget/* são descartados integralmente quando o status HTTP é menor que 500. Somente respostas 5xx do widget são persistidas. As demais rotas não são afetadas.

Quando o status está ausente ou é inválido, o filtro opera em modo fail-open e mantém o batch para evitar a perda de diagnósticos.

A política reduz o alto volume de respostas 200 e 401 produzido pelo polling e pelo ticket SSE, sem esconder falhas do servidor.

Implicações operacionais

Respostas 4xx do widget devem ser investigadas pelos logs do browser e da camada edge. Não relaxe o filtro com base no header X-Visitor-Id: ele não deve ser usado para decidir quais batches persistir.

Build e versionamento

Execute o build a partir do site de documentação:

bun run --cwd ../widget build

O comando gera os arquivos api/public/widget/loader.dist.js e api/public/widget/widget.dist.js. O loader referencia o bundle com ?v=<timestamp> para invalidar cache.

A versão gerada atual é 1791238207984.

Após deploy de código PHP, recarregue os workers do Octane para que a alteração entre em vigor:

php artisan octane:reload