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

バッチプロセッサー 🔗

バッチ・プロセッサーは、スパン、メトリクス、またはログをサイズまたは時間に基づいてバッチ化し、圧縮する OpenTelemetry Collector コンポーネントです。バッチ処理は、エクスポーターによる送信リクエストの数を減らし、パイプライン内の複数または単一のレシーバーからのテレメトリのフローを調整するのに役立ちます。

データサンプリングとフィルターリングの後にバッチ処理が行われるようにするには、memory_limiter プロセッサーと他のサンプリングプロセッサーの後にバッチプロセッサーを追加します。

はじめに 🔗

注釈

このコンポーネントは、ホスト監視 (エージェント) モードまたはデータ転送 (ゲートウェイ) モードでデプロイする場合、Splunk Distribution of the OpenTelemetry Collector のデフォルト設定に含まれます。詳細は Collector のデプロイモード を参照してください。

デフォルト設定の詳細については、Helmで Collector for Kubernetes を設定する、Collector for Linux のデフォルト設定、または Collector for Windows のデフォルト設定 を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。

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

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

  1. 本書の説明に従ってプロセッサーを設定します。

  2. Collector を再起動します。

サンプル構成 🔗

Splunk Distribution of the OpenTelemetry Collector では、デフォルトの設定でバッチプロセッサが追加されます：

processors:
  batch:

プロセッサーは、設定ファイルの service セクションのすべてのパイプラインに含まれます：

service:
  pipelines:
    metrics:
      processors: [batch]
    logs:
      processors: [batch]
    traces:
      processors: [batch]

基本的なバッチ処理の例 🔗

次の例は、5,000スパン、データポイント、またはログが収集された後にバッチを送信するようにバッチプロセッサーを設定する方法を示しています。タイムアウト設定は、サイズ条件が満たされない場合のフォールバック条件として機能します。

processors:
  batch/custom:
    send_batch_size: 5000
    timeout: 15s

メタデータによるバッチ処理 🔗

OpenTelemetry Collectorのバージョン0.78から、メタデータに基づいてテレメトリをバッチ処理できるようになりました。例：

processors:
  batch:
    # batch data by tenant-id
    metadata_keys:
    - tenant_id

    # limit to 10 batcher processes before raising errors
    metadata_cardinality_limit: 10

メタデータをバッチ基準として使用するには、include_metadata: true の設定をレシーバーの設定に追加し、バッチプロセッサーが使用可能なメタデータキーを使用できるようにします。

注意

メタデータによるバッチ処理は、各メタデータの組み合わせがCollectorの新しいバックグラウンドタスクの割り当てをトリガーするため、メモリ消費量が増加する可能性があります。別個の組み合わせの最大数は、metadata_cardinality_limit 設定を使用して定義します（デフォルトは 1000 ）。

設定 🔗

次の表は、バッチプロセッサーの設定オプションを示しています：

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

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

Splunk Observability Cloudをご利用のお客様

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

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

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

このページは 2024年12月12日 に最終更新されました。