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 マニュアルの チャットグループ を参照してください。