Delta プロセッサーへの累積

リソースプロセッサを使用して、リソース属性の更新、追加、削除を行います。コンポーネントの設定方法については、続きをお読みください。

Delta プロセッサへの累積は、OpenTelemetry Collector のコンポーネントで、単調、累積和、およびヒストグラムメトリクスを、デルタ集約の時系列特性を持つ単調メトリクスに変換します。サポートされているパイプラインのタイプは metrics です。詳細については「パイプラインでデータを処理する」を参照してください。

累積ヒストグラムはプラットフォームで処理しにくいため、累積ヒストグラムデータを送信する場合は、メトリクスを累積的な時系列特性からデルタの時系列特性に変換すると便利です。プロセッサはステートフルであるため、複数の Collector インスタンスからデータを送信する場合は使用しないでください。「ステートフルネスに関する考察」を参照してください。

注: 非単調和と指数ヒストグラムはサポートされていません。

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:

  1. Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:

  2. 次のセクションで説明するように、累積を Delta プロセッサーに設定します。

  3. Collector を再起動します。

サンプル構成

累積 Delta プロセッサーを有効にするには、次の例のように、設定ファイルの processors セクションに cumulativetodelta を追加します:

processors:
   cumulativetodelta:
      include:
            metrics:
               - <metric_1_name>
               - <metric_2_name>
               - <metric_n_name>
            match_type: strict
      #
      #  Exclude rules take precedence over include rules
      #
      exclude:
            metrics:
               - ".*metric.*"
            match_type: regexp

include ルールと exclude ルールを使用して、デルタの時系列特性に変換するメトリクスを定義します。包含リストまたは除外リストを指定しないと、処理系はすべての累積和またはヒストグラムメトリクスをデルタの時系列特性に変換します。

構成を完了するには、構成ファイルの service セクションの任意のパイプラインにレシーバーを含めます。例:

service:
  pipelines:
    metrics:
      processors: [cumulativetodelta]

ステートフルネスに関する考察

Delta プロセッサへの累積は、メトリクスの以前の値を使用して Delta 集約を計算するため、メトリクスが Collector の同じインスタンスに継続的に送信されている場合にのみ正確です。複数の Collector インスタンスを使用するデプロイメントでは、Delta プロセッサへの累積が期待どおりに機能しない場合があります。

設定

以下の表は、Delta プロセッサーへの累積の設定オプションを示します:

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/processor/cumulativetodelta.yaml

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______