

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon OpenSearch Ingestion の主な概念
<a name="ingestion-process"></a>

OpenSearch Ingestion の使用を開始する前に、これらの主要な概念を理解しておくと役に立ちます。

**パイプライン**  
OpenSearch Ingestion の観点から見ると、*パイプライン*とは、OpenSearch Service 内で作成される単一のプロビジョニング済みデータコレクターを指します。これは、1 つ以上のサブパイプラインを含む YAML 設定ファイル全体と考えることができます。取り込みパイプラインを作成する手順については、「[パイプラインの作成](creating-pipeline.md#create-pipeline)」を参照してください。

**サブパイプライン**  
サブパイプラインは、YAML 設定ファイル*内*で定義します。各サブパイプラインは、ソース、バッファ、0 個以上のプロセッサ、1 個以上のシンクの組み合わせです。1 つの YAML ファイルで複数のサブパイプラインを定義することができます。各サブパイプラインには固有のソース、プロセッサ、シンクがあります。CloudWatch やその他のサービスによるモニタリングを容易にするために、パイプライン名は、すべてのサブパイプラインと異なる名前を指定することをお勧めします。  
1 つ目のサブパイプラインのソースが 2 つ目のサブパイプラインで、シンクが 3 つ目のサブパイプラインとなるように、複数のサブパイプラインを 1 つの YAML ファイル内に紐づけることができます。例については、[OpenSearch Ingestion パイプラインを OpenTelemetry コレクターで使用する](configure-client-otel.md)を参照してください。

**ソース**  
サブパイプラインの入力コンポーネントです。パイプラインがレコードを使用するメカニズムを定義します。ソースは、HTTPS 経由でイベントを受信するか、Amazon S3 などの外部エンドポイントから読み取ることでイベントを使用できます。ソースには、*プッシュ型*と*プル型*の 2 種類があります。[HTTP](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/http-source/) や [OTel logs](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-logs-source/) などのプッシュ型のソースは、レコードを取り込みエンドポイントにストリーミングします。[OTel trace](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-trace/) や [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/) などのプル型のソースは、ソースからデータを取得します。

**Processors**  
レコードをシンクに発行する前に、レコードを目的の形式にフィルタリング、変換、エンリッチ化できる中間処理ユニットです。プロセッサはパイプラインのオプションコンポーネントです。プロセッサを定義しない場合、レコードはソースで定義されている形式で発行されます。複数のプロセッサを使用することができます。パイプラインは、定義した順序でプロセッサを実行します。

**シンク**  
サブパイプラインの出力コンポーネントです。サブパイプラインがレコードを発行する 1 つ以上の宛先を定義します。OpenSearch Ingestion は、OpenSearch Service ドメインをシンクとしてサポートします。また、サブパイプラインをシンクとしてサポートします。これは、単一の OpenSearch Ingestion パイプライン (YAML ファイル) 内で複数のサブパイプラインをまとめて連結できることを意味します。セルフマネージド型の OpenSearch クラスターは、シンクとしてサポートされていません。

**バッファ**  
プロセッサの一部で、ソースとシンクの間のレイヤーとして機能します。パイプライン内のバッファを手動で設定することはできません。OpenSearch Ingestion はデフォルトのバッファ設定を使用します。

**ルート**  
プロセッサの一部で、パイプラインの作成者が、特定の条件に一致するイベントのみを異なるシンクに送信できるようにします。

有効なサブパイプラインの定義には、ソースとシンクが含まれている必要があります。こうしたパイプラインの各要素の詳細については、「[設定リファレンス](pipeline-config-reference.md#ingestion-parameters)」を参照してください。