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

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

リソースプロセッサは 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` フィールドが必要です。

注: リソース検出プロセッサについては、「リソース検出プロセッサ」を参照してください。

はじめに

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

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
次のセクションで説明するように、リソースプロセッサーを設定します。
Collector を再起動します。

サンプル構成

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

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

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

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______