リソースプロセッサ（廃止）

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

リソースプロセッサは OpenTelemetry Collector のコンポーネントで、リソース属性の追加、更新、削除ができます。サポートされるパイプラインタイプは、traces、metrics、logs です。詳細については「パイプラインでデータを処理する」を参照してください。

リソースプロセッサは、インストルメンテーションが提供しない属性を追加したい場合や、他の属性を使用してレシーバーが収集した属性の値を上書きする必要がある場合に便利です。既存の属性を編集するには、たとえば機密情報を難読化する場合は、属性プロセッサを使用します。「属性プロセッサ」を参照してください。

ターゲット属性は key フィールドで定義されます。value フィールドには、その属性に対して必要な値が含まれます。リスト内の各属性にはアクションが必要です。使用可能なアクションは、次のとおりです。

アクション

説明

insert

キーが存在しない場合、属性にキーと値の組み合わせを追加します。次のいずれかのフィールドが必要です：value、from_attribute、from_context。

update

値を使用して既存のキーを更新します。次のいずれかのフィールドが必要です：value、from_attribute、from_context。

upsert

キーを含む属性に応じて、キーと値の組み合わせを追加または更新します。次のいずれかのフィールドが必要です：value、from_attribute、from_context。

delete

属性を削除します。

hash

既存の値をSHA-1アルゴリズムでハッシュします。

extract

正規表現を使って属性から値を抽出し、ルールで指定されたキーの値を追加または更新します。pattern フィールドが必要です。

convert

属性が変換可能な場合、既存の属性の型を変換します。converted_type フィールドが必要です。
注: リソース検出プロセッサについては、「リソース検出プロセッサ」を参照してください。

はじめに

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

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

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

  3. Collector を再起動します。

サンプル構成

リソースプロセッサーを有効にするには、次の例のように、設定ファイルの processors セクションに resource を追加します：

YAML 
resource:
  attributes:
  # Adds the attribute overriding existing values
  - key: cloud.availability_zone
    value: zone-1
    action: upsert
  # Copies the value of an attribute into another
  - key: k8s.cluster.name
    from_attribute: k8s-cluster
    action: insert
   # Removes an attribute
  - key: redundant-attribute
    action: delete

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

YAML 
service:
  pipelines:
    metrics:
      processors: [resource]
    logs:
      processors: [resource]
    traces:
      processors: [resource]

設定

以下の表に、リソースプロセッサーの設定オプションを示します：

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/processor/resource.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.