Sumコネクター 🔗
Splunk Distribution of the OpenTelemetry Collectorでは、Sumコネクターを使用して、スパン、スパンイベント、メトリクス、データポイント、ログレコードの属性値を合計します。
レシーバーとして、サポートされるパイプラインタイプは metrics 、traces、logs です。エクスポーターとして、サポートされているパイプラインタイプは metrics です。詳細は パイプラインでデータを処理する を参照してください。
注釈
属性内で見つかった値は、合計されてメトリクス値として出力される前に、元の型に関係なくfloatに変換されます。変換不可能な文字列は削除され、含まれません。
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：
Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように、コネクターを設定します。
Collector を再起動します。
サンプル構成 🔗
コネクターをアクティブにするには、設定ファイルの connectors セクションに sum を追加します。
例：
connectors:
sum:
設定を完了するには、設定ファイルの service セクションに、使用するパイプラインに応じてコネクターを追加します：
service:
pipelines:
metrics/sum:
receivers: [sum]
traces:
exporters: [sum]
設定オプション 🔗
以下の設定が必要です：
テレメトリタイプ。
sum:コネクター宣言の下にネストされます。tracesの場合はspansまたはspanevents、metricsの場合はdatapoints、またはlogsのいずれかを指定できます。設定例：Sum属性値 では、
spansと宣言されています。
メトリクス名。テレメトリタイプの下にネストされています。これは、合計コネクターが合計値を出力するメトリクス名です。
設定例：Sum属性値 では、
my.example.metric.nameと宣言されています。
source_attribute。コネクターに供給されるソーステレメトリ内で検索する特定の属性。この属性は、コネクターが出力メトリクス値に合計する数値を探す場所です。設定例：Sum属性値 では、
attribute.with.numerical.valueと宣言されています。
オプションで以下の設定が可能です：
conditions。OTTL構文を使用して、受信するテレメトリを処理する条件を指定できます。条件はOR接続されるため、いずれかの条件が満たされると、その属性の値が結果の合計に含まれます。詳細については、GitHubの OTTL文法 を参照してください。attributes。含める属性の宣言。これらの属性のいずれかが見つかると、属性値のユニークな組み合わせのセットごとに個別の合計が生成され、メトリック時系列内の独自のデータポイントとして出力されます。key。attributesでは必須です。対照する属性名。default_value。attributesではオプションです。一致が見つからない場合のデフォルト値。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.paymentはNULLではありません。payment.processorに値のないログはすべて、unspecified_processorのdefault_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 サポートポータル でケースを送信する
Splunkサポート に連絡する
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。