リソースプロセッサー 🔗
リソースプロセッサーはOpenTelemetry Collectorのコンポーネントで、リソース属性の追加、更新、削除ができます。サポートされているパイプラインタイプは、traces
、metrics
、および logs
です。詳細は パイプラインでデータを処理する を参照してください。
リソースプロセッサーは、インストルメンテーションが提供しない属性を追加したい場合や、他の属性を使用してレシーバーが収集した属性の値を上書きする必要がある場合に便利です。既存の属性を編集するには、例えば機密情報を難読化するには、属性プロセッサーを使用します。属性プロセッサー を参照してください。
ターゲット属性は key
フィールドを通して定義されます。value
フィールドは、属性に望ましい値を含みます。リスト内の各属性はアクションを必要とします。利用可能なアクションは以下の通りです:
アクション |
説明 |
---|---|
|
キーが存在しない場合、属性にキーと値の組み合わせを追加します。以下のフィールドのいずれかが必要です: |
|
既存のキーを値で更新します。以下のフィールドのいずれか、 |
|
キーを含む属性に応じて、キーと値の組み合わせを追加または更新します。以下のフィールドのいずれかが必要です: |
|
属性を削除します。 |
|
既存の値をSHA-1アルゴリズムでハッシュします。 |
|
正規表現を使って属性から値を抽出し、ルールで指定されたキーの値を追加または更新します。 |
|
属性が変換可能な場合、既存の属性の型を変換します。 |
注釈
リソース検出プロセッサーについては、リソース検出プロセッサー を参照してください。
はじめに 🔗
以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください:
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]
設定 🔗
以下の表に、リソースプロセッサーの設定オプションを示します:
トラブルシューティング 🔗
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。
Splunk Observability Cloudをご利用のお客様
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
見込み客および無料トライアルユーザー様
Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。