integration-testing

統合テスト

使用するタイミング

以下を含むタスクでは、このスキルを読み込んでください。

• パイプラインのテストフィクスチャ（.log／.json の入力、*-expected.json の出力、設定ファイル）の作成またはデバッグ
• システムテスト（_dev/test/system/、_dev/deploy/、モック API、0 件ヒットの失敗）のセットアップまたはデバッグ
• 失敗時の処理、API エラー処理、パッケージのアップグレードに関するスクリプトテストの作成

使用しないタイミング

以下の主要なガイドとして、このスキルを使用しないでください。

• インジェストパイプラインのプロセッサーの設計とアーキテクチャ（ingest-pipelines）
• CEL プログラムの開発（cel-programs）
• elastic-package コマンドの幅広い選択とスタックのライフサイクル（elastic-package-cli）

参照ファイル — テストの種類に合ったものを読み込む

テストの種類	読み込むタイミング	参照ファイル
パイプラインテスト	フィクスチャ、設定ファイル、期待される出力の作成、またはパイプラインテストの失敗のデバッグ	references/pipeline-testing.md
システムテスト（一般）	システムテストに関する作業では必ず読み込みます — 設定フィールド、コマンド、後処理、デバッグ	references/system-testing.md
スクリプトテスト	txtar の失敗／エラーテスト、アップグレードテスト、txtar に埋め込まれたモックサービス	references/script-testing.md

システムテストの入力タイプ別参照ファイル

一般的な system-testing.md に加えて、データストリームの入力タイプに合った参照ファイルを読み込んでください。

入力タイプ	参照ファイル
cel	references/system-testing-cel.md
tcp、udp	references/system-testing-tcp-udp.md
http_endpoint	references/system-testing-http-endpoint.md
logfile、filestream	references/system-testing-logfile.md
kafka、gcp-pubsub	references/system-testing-kafka-pubsub.md
aws-s3、gcs、azure-blob-storage、azure-eventhub	references/system-testing-cloud-skip.md

インテグレーションが複数の入力タイプに対応している場合は、一般的な参照ファイルに加えて、該当する各入力タイプの参照ファイルを読み込んでください。

1 つのタスクで複数のテストタイプを扱う場合（例：新しいデータストリームをエンドツーエンドで作成する場合）は、該当するすべての参照ファイルを読み込んでください。

参考資料

• references/pipeline-testing.md — ディレクトリ構成、命名規則、フィクスチャ形式、設定オプション、期待される出力形式とレビュー、基本的なワークフロー、フィクスチャのシナリオ網羅範囲、データの匿名化、トラブルシューティング
• references/system-testing.md — 一般的なシステムテストのリファレンス：必須の構成、設定フィールド、基本コマンド、ティアダウンの失敗、sample_event.json の検証、一般的なデバッグ
• references/system-testing-cel.md — CEL モック API の接続、CEL のヒット数が 0 の場合のデバッグ、変数取得パターン
• references/system-testing-tcp-udp.md — elastic/stream を使用した TCP/UDP ログ送信パターン、シグナルの調整、ポートの整合
• references/system-testing-http-endpoint.md — STREAM_PROTOCOL=webhook を使用した Webhook/HTTP エンドポイントのテスト、認証ヘッダー
• references/system-testing-logfile.md — ログファイル／filestream 入力向けの Alpine コンテナーと SERVICE_LOGS_DIR のパターン
• references/system-testing-kafka-pubsub.md — Kafka ブローカーとストリームプロデューサー、Pub/Sub エミュレーターのパターン
• references/system-testing-cloud-skip.md — クラウドストレージ入力（aws-s3、gcs、azure-blob-storage、azure-eventhub）のシステムテストをスキップする時期と理由
• references/script-testing.md — txtar 形式、環境のスモークテスト、システムレベルの骨組み、モックサービスの docker-compose と config.yml、アップグレードテストのパターン、注意点、o365 の完全な例
• references/builder-setup-subagent-guidance.md — CEL 以外のデータストリームでデータ収集を接続するためのサブエージェント用作業マニュアル（docker-compose、サンプルログ、エージェントストリームのテンプレート、システムテスト設定、マニフェスト変数のクリーンアップ）。オーケストレーターは、タスクプロンプトでこのファイルのパスを渡してサブエージェントをディスパッチします。サブエージェントは自身の新しいコンテキストでファイルを読み込みます。内容をタスクプロンプトに埋め込んだり貼り付けたりしないでください。
• references/builder-system-test-subagent-guidance.md — パイプライン作業の完了後に elastic-package test system --generate を実行するためのサブエージェント用作業マニュアル（テスト可能なすべての入力が対象）。ディスパッチのルールは上記と同じです。オーケストレーターはパスを渡し、サブエージェント自身がファイルを読み込みます。