イベント契約
クエリが期待するフィールド
| フィールド | 種類 | なぜ存在するのか |
|---|---|---|
| timestamp_utc | Timestamp | キャッシュ ルックアップの完了時刻 (UTC)。 |
| cache_key_pattern | Utf8 | 製品:{id} などの境界パターン。生のキーではありません。 |
| cache_hit | Boolean | ルックアップがキャッシュされた値を返したかどうか。 |
| concurrent_misses | Int64 | 同じパターンの飛行中の塗りつぶしが観察されました。 |
| backend_duration_ms | Float64 | フォールバック期間。ヒットの場合はゼロ。 |
| environment | Utf8 | 導入環境。 |
クエリをコピーする
SELECT
cache_key_pattern,
COUNT(*) AS requests,
SUM(CASE WHEN cache_hit THEN 1 ELSE 0 END) AS hits,
SUM(CASE WHEN cache_hit THEN 0 ELSE 1 END) AS misses,
100.0 * SUM(CASE WHEN cache_hit THEN 0 ELSE 1 END)
/ NULLIF(COUNT(*), 0) AS miss_rate_pct,
MAX(concurrent_misses) AS maximum_concurrent_misses,
AVG(CASE WHEN cache_hit THEN NULL ELSE backend_duration_ms END)
AS average_backend_duration_ms
FROM cache_request_events
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
AND environment = 'production'
GROUP BY cache_key_pattern
ORDER BY maximum_concurrent_misses DESC, cache_key_pattern;この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。
クエリ結果
キャッシュミスとスタンピードのインジケーター
製品ルックアップでは、50% のミス率と 31 の同時フィル、およびバックエンドのコストが高くなります。
| cache_key_pattern | requests | hits | misses | miss_rate_pct | maximum_concurrent_misses | average_backend_duration_ms |
|---|---|---|---|---|---|---|
| product:{id} | 10 | 5 | 5 | 50 | 31 | 232 |
| feature-flags:{account} | 8 | 7 | 1 | 12.5 | 7 | 75 |
合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。
例を再現する
パブリックフィクスチャをダウンロードする
JSON バンドルには、型付きイベント コントラクトが含まれています。 reproducible 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。
SQL の仕組み
- 1グループ化キーは、カーディナリティの高い生のキャッシュ キーではなく、制限されたアプリケーション定義のパターンです。
- 2ミス率は効率を捉え、最大同時ミス数はバースト動作を明らかにします。
- 3ヒットではフォールバックが実行されないため、バックエンド期間はミスについてのみ平均化されます。
決定すべきエッジケース
- ルックアップ時またはフィル開始時に一貫して concurrent_misses を定義します。
- キャッシュのウォームアップが予想される場合は、コールド スタート デプロイメントを定常状態のトラフィックから分割します。
- バックエンドの継続時間が重いテールを持つ場合は、平均ではなくパーセンタイルを使用します。
推奨されるダッシュボード
- 散布図: miss_rate_pct 対 maximum_concurrent_misses
- 傾向: キャッシュ キー パターン別のミスとバックエンドの継続時間
- 表: バックエンド作業ごとの上部境界パターン
レシピを活用する
関連する機器とガイド
分析を続ける
実際のイベントで実行する
テーブルを作成し、フィールドを調整して、結果を保存します
無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。