Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

3.13. Probabilistic Sampling Processor

大量のテレメトリーデータを処理し、処理するデータ量を減らすことでコストを削減したい場合は、Tail Sampling Processor の代わりに Probabilistic Sampling Processor を使用できます。

重要

Probabilistic Sampling Processor は、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

プロセッサーは、指定された割合のトレース範囲またはログレコードをステートレスに、そしてリクエストごとにサンプリングします。

プロセッサーは、使用された有効サンプリング確率に関する情報をテレメトリーデータに追加します。

  • トレーススパンでは、プロセッサーは、しきい値とオプションのランダム性情報を W3C Trace Context tracestate フィールドにエンコードします。
  • ログレコードでは、プロセッサーはしきい値とランダム性の情報を属性としてエンコードします。

以下は、トレース範囲をサンプリングするための Probabilistic Sampling Processor の OpenTelemetryCollector カスタムリソース設定の例です。 

# ...
  config:
    processors:
      probabilistic_sampler:
1 

        sampling_percentage: 15.3
2 

        mode: "proportional"
3 

        hash_seed: 22
4 

        sampling_precision: 14
5 

        fail_closed: true
6 

# ...
service:
  pipelines:
    traces:
      processors: [probabilistic_sampler]
# ...
1
トレースパイプラインの場合、ランダム性のソースとなるのは、スパントレース ID のハッシュ値です。
2
必須。スパンをサンプリングする割合を、32 ビット浮動小数点数のパーセンテージ値で受け入れます。
3
任意。サンプリングロジックのモードにサポートされている文字列値 (デフォルトは hash_seed、proportional、または equalizing) を受け入れます。hash_seed モードは、トレース ID に Fowler–Noll–Vo (FNV) ハッシュ関数を適用し、そのハッシュ値をサンプリングのパーセンテージ値と比較します。トレース ID 以外のテレメトリー単位で hash_seed モードを使用することもできます。proportional モードでは、総スパン量の厳密な確率ベースの比率がサンプリングされ、OpenTelemetry および World Wide Web Consortium の仕様に基づいています。equalizing モードは、パイプライン全体でサンプリング確率を最小値に下げたり、クライアント SDK にさまざまなサンプリング設定がある Collector デプロイメントで均一なサンプリング確率を適用したりする際に役立ちます。
4
任意。ハッシュアルゴリズムの計算に使用される 32 ビットの符号なし整数を受け入れます。このフィールドが設定されていない場合、デフォルトのシード値は 0 です。複数の層の Collector インスタンスを使用する場合は、同じ層のすべての Collector を同じシード値に設定する必要があります。
5
任意。サンプリングしきい値をエンコードするために使用される 16 進数の桁数を決定します。整数値を受け入れます。サポートされる値は 1-14 です。デフォルト値 4 では、しきい値に 16 を超える有効ビットが含まれる場合、つまり 56 ビットを使用する proportional モードの場合、しきい値は丸められます。proportional モードを選択した場合は、前のサンプラーによって適用された精度を維持するために、より大きな値を使用します。
6
任意。サンプリングエラーのあるスパンを拒否します。ブール値を受け入れます。デフォルト値は true です。

以下は、ログレコードをサンプリングするための Probabilistic Sampling Processor の OpenTelemetryCollector カスタムリソース設定の例です。 

# ...
  config:
    processors:
      probabilistic_sampler/logs:
        sampling_percentage: 15.3
1 

        mode: "hash_seed"
2 

        hash_seed: 22
3 

        sampling_precision: 4
4 

        attribute_source: "record"
5 

        from_attribute: "<log_record_attribute_name>"
6 

        fail_closed: true
7 

# ...
service:
  pipelines:
    logs:
      processors: [ probabilistic_sampler/logs ]
# ...
1
必須。スパンをサンプリングする割合を、32 ビット浮動小数点数のパーセンテージ値で受け入れます。
2
任意。サンプリングロジックモードにサポートされている文字列値 (デフォルトは hash_seed、equalizing、または proportional) を受け入れます。hash_seed モードは、トレース ID または指定されたログレコードの属性に Fowler–Noll–Vo (FNV) ハッシュ関数を適用し、そのハッシュ値をサンプリングのパーセンテージ値と比較します。また、hash_seed モードは、トレース ID 以外のテレメトリー単位で使用することもできます。たとえば、service.instance.id リソース属性を使用して、一定の割合の Pod からログレコードを収集できます。equalizing モードは、パイプライン全体でサンプリング確率を最小値に下げたり、クライアント SDK にさまざまなサンプリング設定がある Collector デプロイメントで均一なサンプリング確率を適用したりする際に役立ちます。proportional モードでは、総スパン量の厳密な確率ベースの比率がサンプリングされ、OpenTelemetry および World Wide Web Consortium の仕様に基づいています。
3
任意。ハッシュアルゴリズムの計算に使用される 32 ビットの符号なし整数を受け入れます。このフィールドが設定されていない場合、デフォルトのシード値は 0 です。複数の層の Collector インスタンスを使用する場合は、同じ層のすべての Collector を同じシード値に設定する必要があります。
4
任意。サンプリングしきい値をエンコードするために使用される 16 進数の桁数を決定します。整数値を受け入れます。サポートされる値は 1-14 です。デフォルト値 4 では、しきい値に 16 を超える有効ビットが含まれる場合、つまり 56 ビットを使用する proportional モードの場合、しきい値は丸められます。proportional モードを選択した場合は、前のサンプラーによって適用された精度を維持するために、より大きな値を使用します。
5
任意。from_attribute でログレコード属性を検索する場所を定義します。ログレコード属性はランダム性のソースとして使用されます。デフォルトの traceID 値または record 値を受け入れます。
6
任意。一意のログレコード ID など、サンプリングハッシュの計算に使用されるログレコード属性の名前。文字列値を受け入れます。デフォルト値は "" です。このフィールドは、トレース ID が存在しないか、トレース ID サンプリングが無効になっているか、attribute_source フィールドが record 値に設定されている状況で、ランダム性のソースとしてログレコード属性を指定する必要がある場合にのみ使用してください。
7
任意。サンプリングエラーのあるスパンを拒否します。ブール値を受け入れます。デフォルト値は true です。
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る