Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » Collector コンポーネント » Collectorコンポーネント: プロセッサー » リソースプロセッサー

リソースプロセッサー 🔗

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

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

ターゲット属性は key フィールドを通して定義されます。value フィールドは、属性に望ましい値を含みます。リスト内の各属性はアクションを必要とします。利用可能なアクションは以下の通りです:

アクション

説明

insert

キーが存在しない場合、属性にキーと値の組み合わせを追加します。以下のフィールドのいずれかが必要です: valuefrom_attribute、 または from_context

update

既存のキーを値で更新します。以下のフィールドのいずれか、valuefrom_attribute、または from_context が必要です。

upsert

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

delete

属性を削除します。

hash

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

extract

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

convert

属性が変換可能な場合、既存の属性の型を変換します。converted_type フィールドが必要です。

注釈

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

はじめに 🔗

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

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

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

  3. 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]

設定 🔗

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

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

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

Splunk Observability Cloudをご利用のお客様

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

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

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

This page was last updated on 2024年05月29日.