Delta プロセッサーへの累積

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

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

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

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

はじめに

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

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

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

  3. Collector を再起動します。

サンプル構成

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

YAML
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 セクションの任意のパイプラインにレシーバーを含めます。例:

YAML
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

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.