---
title: Observabilidade do widget
description: Política do Telescope, investigação de erros e versionamento dos bundles do widget.
---

# 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:

```bash
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:

```bash
php artisan octane:reload
```