Métriques et usage

OverflowLens

Des bornes exactes quand le dépassement de cardinalité masque les résultats. Calculer le taux d’erreur possible quand OpenTelemetry a fusionné des attributs de requêtes dans une série de débordement.

Version: v0.2.1, 2 nov. 2026
Fonctionne sur: Application web avec traitement local ; archive autonome disponible
Licence: Apache-2.0

Ouvrir l’application Télécharger l’archive autonome Voir les sources

Télécharger l’archive autonome: L’application est disponible dans le navigateur. L’archive v0.2.1 peut aussi être servie en local.

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

Résultat documenté de l’exemple synthétique delta inclus au seuil de 1 % ; ce n’est pas une mesure de production.

Ce qu’il fait

Importez un compteur de requêtes OpenTelemetry enregistré et comparez les taux d’erreur possibles à votre seuil. Le mode delta analyse un intervalle de collecte ; le mode cumulatif compare des instantanés correspondants avant et après. Les fichiers sont analysés localement dans un Web Worker ; comptes et bornes sont calculés dans le navigateur. L’application hébergée télécharge ses ressources ; les fichiers importés, seuils et rapports exportés ne sont pas envoyés.

Pour qui

Les développeurs qui examinent les taux d’erreur après un dépassement de cardinalité du SDK OpenTelemetry.

Limites

Accepte du UTF-8 OTLP JSON non compressé avec compteurs Sum entiers et monotones, jusqu’à 5 Mio par fichier. Ce n’est ni un serveur de métriques en direct ni un évaluateur général de SLO.
Les fenêtres cumulatives exigent des instantanés complets correspondants, une attribution stable, des débuts connus inchangés, sans remise à zéro ni baisse des comptes.
Les hypothèses de provenance doivent être confirmées. Un fichier ne prouve pas que le traitement a préservé tous les comptes et points de dépassement.

Usages courants

Comprendre un intervalle delta

Ouvrez l’exemple inclus, confirmez ses hypothèses et voyez pourquoi des bornes de 0,1 % à 10 % ne permettent pas de décider pour un seuil de 1 %.

Comparer des instantanés cumulatifs

Choisissez les exports avant et après d’un même historique continu de compteur. La distribution de navigateur inclut une paire synthétique issue du laboratoire SDK.

Télécharger

Dernière version stable v0.2.1, publiée le 2 nov. 2026. Notes de version de v0.2.1. Données de version vérifiées le 2 nov. 2026 sur GitHub Releases.

Toute plateforme

Télécharger : Archive ZIP 96 ko

Universel
Paquet

Extrayez le ZIP et servez son dossier par HTTP. Node.js et Go ne sont pas nécessaires.

Vérifier un téléchargement

SHA256SUMS.txt liste les empreintes SHA-256 des fichiers de la version. Une empreinte identique montre que votre fichier est le même que celui publié. C’est une somme de contrôle, pas une signature de l’auteur : elle ne prouve pas qui a compilé le fichier.

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

Premier lancement

Ouvrez l’application et choisissez l’exemple delta ou cumulatif. Ni SDK ni fichiers personnels ne sont nécessaires.
Pour la version autonome déjà publiée, téléchargez le ZIP, extrayez-le et démarrez un serveur HTTP statique dans overflowlens-0.2.1 :
```
python3 -m http.server 8080 --bind 127.0.0.1
```
Ouvrez http://127.0.0.1:8080, choisissez un mode, confirmez les hypothèses de provenance et fixez le pourcentage maximal d’erreurs. Exportez le JSON pour conserver l’explication.

Plateformes et manière dont elles ont été vérifiées

Navigateur modernePrise en charge annoncée, sans exécution vérifiée
Application statique sur GitHub Pages ; l’archive autonome nécessite un serveur HTTP, pas file://.

Documentation et assistance

Les questions et rapports de bogue vont dans le gestionnaire de tickets du projet. Signalez les problèmes de sécurité comme indiqué dans sa politique de sécurité.

Aperçu