SampleRate 属性が付与されます。
ひとたびデータがサンプリングされると、単純な集計では正しい結果になりません。count() は実際に発生したイベント数より N 倍少ない値を返し、sum() や avg() には偏りが生じ、パーセンタイルもずれます。その結果、ダッシュボードにはリクエスト数、スループット、エラー率が実際より低く表示され、誤解を招きます。
ClickStack は、サンプリングを考慮したクエリエンジンでこれを解決します。トレースソースでサンプルレート式を設定すると、クエリビルダーが SQL の集計を書き換え、ダッシュボード、アラート、アドホック検索全体で各スパンをそのサンプルレートに基づいて重み付けします。
仕組み
sampleRateExpression が設定されている場合、ClickStack はこれを次のようにラップします:
SampleRate 属性がないスパンは重みがデフォルトで 1 になるため、サンプリングされていないデータでは元のクエリと同じ結果になります。
次に、クエリビルダーが集計を書き換えます。
サンプリング時のパーセンタイルには、近似的な T-Digest スケッチである
quantileTDigestWeighted を使用します。結果は元の値に近くなりますが、厳密に一致するわけではありません。サンプルレート式の設定
SpanAttributes['SampleRate'] に書き込む場合:
設定すると、すべてのチャート、ダッシュボード、アラート、サービスダッシュボードのパネルで、サンプルレートで重み付けされた集計が自動的に適用されます。個々のクエリを変更する必要はありません。