Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector コンポーネント » Collectorコンポーネント;コネクター » Sumコネクター

Sumコネクター 🔗

Splunk Distribution of the OpenTelemetry Collectorでは、Sumコネクターを使用して、スパン、スパンイベント、メトリクス、データポイント、ログレコードの属性値を合計します。

レシーバーとして、サポートされるパイプラインタイプは metricstraceslogs です。エクスポーターとして、サポートされているパイプラインタイプは metrics です。詳細は パイプラインでデータを処理する を参照してください。

注釈

属性内で見つかった値は、合計されてメトリクス値として出力される前に、元の型に関係なくfloatに変換されます。変換不可能な文字列は削除され、含まれません。

はじめに 🔗

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

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

  1. 次のセクションで説明するように、コネクターを設定します。

  2. Collector を再起動します。

サンプル構成 🔗

コネクターをアクティブにするには、設定ファイルの connectors セクションに sum を追加します。

例:

connectors:
  sum:

設定を完了するには、設定ファイルの service セクションに、使用するパイプラインに応じてコネクターを追加します:

service:
  pipelines:
    metrics/sum:
       receivers: [sum]
    traces:
       exporters: [sum]

設定オプション 🔗

以下の設定が必要です:

  • テレメトリタイプ。sum: コネクター宣言の下にネストされます。traces の場合は spans または spaneventsmetrics の場合は datapoints、または logs のいずれかを指定できます。

  • メトリクス名。テレメトリタイプの下にネストされています。これは、合計コネクターが合計値を出力するメトリクス名です。

  • source_attribute。コネクターに供給されるソーステレメトリ内で検索する特定の属性。この属性は、コネクターが出力メトリクス値に合計する数値を探す場所です。

オプションで以下の設定が可能です:

  • conditions。OTTL構文を使用して、受信するテレメトリを処理する条件を指定できます。条件はOR接続されるため、いずれかの条件が満たされると、その属性の値が結果の合計に含まれます。詳細については、GitHubの OTTL文法 を参照してください。

  • attributes。含める属性の宣言。これらの属性のいずれかが見つかると、属性値のユニークな組み合わせのセットごとに個別の合計が生成され、メトリック時系列内の独自のデータポイントとして出力されます。

    • keyattributes では必須です。対照する属性名。

    • default_valueattributes ではオプションです。一致が見つからない場合のデフォルト値。 default_value 値は文字列、整数、または浮動小数です。

設定例:Sum属性値 🔗

この設定例では、コネクターにルーティングされたスパンテレメトリの属性 attribute.with.numerical.value 内で検出された数値を合計し、それらの合計値を持つ名前 my.example.metric.name のメトリック時系列を出力します。

receivers:
  foo:
connectors:
  sum:
    spans:
      my.example.metric.name:
        source_attribute: attribute.with.numerical.value

exporters:
  bar:

service:
  pipelines:
    metrics/sum:
       receivers: [sum]
       exporters: [bar]
    traces:
       receivers: [foo]
       exporters: [sum]

設定例:支払いログの確認 🔗

この例では、Sumコネクターがログを取り込み、source_attribute total.payment で見つかった数値で checkout.total という名前の出力メトリクスを作成します。 また、payment.processor 属性に値が存在するかどうかを受信ログテレメトリでチェックし、一意の値ごとにメトリック時系列内にデータポイントを作成します。

また、次のことも確認します:

  • 属性 total.paymentNULL ではありません。

  • payment.processor に値のないログはすべて、unspecified_processordefault_value を持つデータポイントに含まれます。

receivers:
  foo:
connectors:
  sum:
    logs:
      checkout.total:
        source_attribute: total.payment
        conditions:
          - attributes["total.payment"] != "NULL"
        attributes:
          - key: payment.processor
            default_value: unspecified_processor
exporters:
  bar:

service:
  pipelines:
    metrics/sum:
       receivers: [sum]
       exporters: [bar]
    logs:
       receivers: [foo]
       exporters: [sum]

メトリクスへのログ 🔗

ログからメトリクスへの接続において、ログが属性ではなく本文にすべての値を含む場合、パイプラインで トランスフォームプロセッサー を使用して、解析されたキーと値のペアをログに添付された属性にアップサートします。

例えば、JSONペイロードの場合:

processors:
  transform/logs:
    log_statements:
      - context: log
        statements:
          - merge_maps(attributes, ParseJSON(body), "upsert")

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

このページは 2025年02月11日 に最終更新されました。