Métricas e uso

OverflowLens

Limites exatos quando o estouro de cardinalidade oculta os resultados. Calcule a taxa de erro possível quando o OpenTelemetry juntou atributos de requisições em uma série de overflow.

Versão: v0.2.1, 2 de nov. de 2026
Funciona em: App de navegador com processamento local; arquivo autônomo disponível
Licença: Apache-2.0

Abrir app Baixar arquivo autônomo Ver o código

Baixar arquivo autônomo: O app está disponível no navegador. O arquivo v0.2.1 também pode ser servido localmente.

Known successes                 900
Known errors                      1
SDK overflow                     99
Total                         1,000

Possible true error rate       0.1% … 10%
Maximum allowed error rate       1%
Conclusion: Cannot determine from these data

Resultado documentado do exemplo sintético delta incluído com limite de 1%; não é uma medição de produção.

O que faz

Importe um contador de requisições OpenTelemetry salvo e compare suas taxas de erro possíveis com seu limite. Delta analisa um intervalo de coleta; cumulativo compara snapshots correspondentes de antes e depois. Os arquivos são analisados localmente em um Web Worker; contagens e limites são calculados no navegador. O app hospedado baixa seus recursos; arquivos importados, limites e relatórios exportados não são enviados.

Para quem é

Desenvolvedores que investigam taxas de erro após estouro de cardinalidade no SDK OpenTelemetry.

Limitações

Aceita UTF-8 OTLP JSON sem compressão com contadores Sum inteiros e monótonos, até 5 MiB por arquivo. Não é backend de métricas ao vivo nem avaliador geral de SLO.
Janelas cumulativas exigem snapshots completos correspondentes, atribuição estável e inícios conhecidos sem mudanças, sem reinícios nem contagens decrescentes.
As premissas de origem precisam ser confirmadas. Um arquivo não prova que o processamento preservou todas as contagens e pontos de estouro.

Usos comuns

Entender um intervalo delta

Abra o exemplo incluído, confirme as premissas e veja por que limites de 0,1% a 10% não permitem decidir sobre um limite de 1%.

Comparar snapshots cumulativos

Escolha exportações de antes e depois de um mesmo histórico contínuo do contador. A distribuição de navegador inclui um par sintético do laboratório SDK.

Baixar

Última versão estável v0.2.1, publicada em 2 de nov. de 2026. Notas da versão de v0.2.1. Dados de versões consultados em 2 de nov. de 2026 no GitHub Releases.

Qualquer plataforma

Baixar Arquivo ZIP 96 kB

Universal
Pacote

Extraia o ZIP e sirva sua pasta por HTTP. Node.js e Go não são necessários.

Verificar um download

SHA256SUMS.txt lista os hashes SHA-256 dos arquivos da versão. Um hash igual mostra que o seu arquivo é idêntico ao publicado. É uma soma de verificação, não uma assinatura do autor: não prova quem compilou o arquivo.

shasum -a 256 -c --ignore-missing SHA256SUMS.txt

Primeiro uso

Abra o app e escolha o exemplo delta ou cumulativo. SDK e arquivos próprios não são necessários.
Para a versão independente já publicada, baixe o ZIP, extraia e inicie um servidor HTTP estático dentro de overflowlens-0.2.1:
```
python3 -m http.server 8080 --bind 127.0.0.1
```
Abra http://127.0.0.1:8080, escolha o modo, confirme as premissas de origem e defina a porcentagem máxima de erros. Exporte JSON para salvar a explicação.

Plataformas e como foram verificadas

Navegador modernoSuporte declarado, sem execução verificada
Aplicação estática no GitHub Pages; o arquivo autônomo exige um servidor HTTP, não file://.

Documentação e suporte

Perguntas e relatos de bugs vão para o rastreador de issues do projeto. Relate problemas de segurança como descrito na política de segurança.

Como é