メトリクスと利用状況
OverflowLens
カーディナリティーのオーバーフローで結果が不明になったリクエストの正確な境界。OpenTelemetry がリクエスト属性をオーバーフロー系列にまとめたときに、あり得るエラー率を求めます。
- リリース
- v0.2.1, 2026年11月2日
- 動作環境
- ファイルをローカルで処理するブラウザーアプリ。単体アーカイブも利用可能
- ライセンス
- Apache-2.0
単体アーカイブをダウンロード: ブラウザーでアプリを利用できます。v0.2.1 アーカイブはローカルでも配信できます。
画面
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できること
保存した OpenTelemetry リクエストカウンターを読み込み、可能なエラー率をしきい値と比較します。delta は一つの収集区間を分析し、累積モードは対応する前後のスナップショットを比較します。ファイルは Web Worker でローカルに解析し、件数と境界はブラウザーで計算します。公開アプリは自身のリソースをダウンロードしますが、入力ファイル、しきい値、出力レポートは送信しません。
対象
- OpenTelemetry SDK のカーディナリティー上限超過後のエラー率を調べる開発者。
制限事項
- 非圧縮の UTF-8 OTLP JSON で、単調増加する整数 Sum カウンターを受け付けます。1 ファイル 5 MiB までです。ライブメトリクスのバックエンドや SLO 全体の評価器ではありません。
- 累積区間には、属性の割り当てが安定し、既知の開始時刻が変わらない、対応する完全なスナップショットが必要です。リセットやカウントの減少は扱えません。
- データの来歴について前提の確認が必要です。すべてのカウントと上限超過点が処理で保持されたことは、ファイルだけでは証明できません。
主な使い方
delta 区間を理解する
付属サンプルを開き、前提を確認すると、0.1% から 10% という境界では 1% のしきい値を満たすか判断できない理由がわかります。
累積スナップショットを比較する
一つの連続したカウンター履歴から前後のエクスポートを選びます。ブラウザー配布版には SDK ラボの合成データのペアが含まれます。
ダウンロード
最新の安定版 v0.2.1（2026年11月2日 公開）。 リリースノート （v0.2.1）. リリース情報は 2026年11月2日 に GitHub Releases から取得しました。
すべてのプラットフォーム
- ZIP を展開し、そのフォルダーを HTTP で配信します。Node.js と Go は不要です。
ダウンロードの検証
SHA256SUMS.txt にはリリースファイルの SHA-256 ハッシュが記載されています。ハッシュが一致すれば、ファイルはリリースで公開されたものと同一です。これはチェックサムであり作者の署名ではないため、誰がビルドしたかは証明しません。
shasum -a 256 -c --ignore-missing SHA256SUMS.txt初めて使うとき
アプリを開き、delta または累積サンプルを選びます。SDK や自分のファイルは不要です。
公開済みの単独配布版は ZIP をダウンロードして展開し、overflowlens-0.2.1 内で静的 HTTP サーバーを起動します。
python3 -m http.server 8080 --bind 127.0.0.1http://127.0.0.1:8080 を開き、モードを選び、来歴の前提を確認して最大許容エラー率を指定します。説明を保存するには JSON を出力します。
対応環境と確認方法
- 現在の一般的なブラウザー対応をうたっているが動作は未確認
GitHub Pages 上の静的アプリです。単体アーカイブは file:// ではなく HTTP サーバーで開いてください。
ドキュメントとサポート
質問やバグ報告はプロジェクトのIssue トラッカーへ。セキュリティ上の問題はセキュリティポリシーに従って報告してください。