input-configurations について
input-configurationsは、Elastic Agentの入力テンプレートの作成、変更、レビューに使うスキルです。共通設定パターンと入力タイプ別のガイドを提供し、CELロジックやパッケージスキーマなどの作業は関連スキルに引き継ぎます。
主な機能
- 01共通の入力設定パターン
- 02HTTPJSONとクラウド入力のガイド
- 03ネットワークとファイル入力のガイド
- 04入力タイプ別の参照先案内
- 05関連するパッケージ作業の引き継ぎ
活用シーン
- 01HTTPJSONテンプレートでのページネーション設定
- 02クラウドストレージ入力の設定
- 03ネットワークまたはファイル入力テンプレートのレビュー
- 04インテグレーションでのAWS Federated Identityの有効化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ elastic/ integration-skills --skill input-configurationsインストール後、Claude Code で/input-configurationsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/aws-cloudwatch-guide.mdaws-s3-guide.mdazure-blob-storage-guide.mdazure-eventhub-guide.mdcommon-input-patterns.mdfederated-identity-aws.mdfilestream-logfile-guide.mdgcp-pubsub-guide.mdgcs-guide.mdhttp-endpoint-guide.mdhttpjson-guide.mdjournald-guide.mdtcp-udp-guide.mdwebsocket-guide.mdwinlog-guide.md詳細
input-configurations
使用するタイミング
タスクに以下が含まれる場合は、いつでもこのスキルを読み込んでください。
- CEL 以外の入力タイプ用の
agent/stream/*.yml.hbsテンプレートの作成、変更、レビュー - HTTPJSON テンプレートでのリクエスト、レスポンス、ページネーション、カーソル、認証ブロックの設定
- クラウドストレージ入力(AWS S3、GCS、Azure Blob、Azure EventHub)の接続
- ネットワーク入力(TCP、UDP、HTTP Endpoint、WebSocket)の設定
- ファイルベース入力(Filestream、Logfile、Journald、Winlog)の設定
- AWS インテグレーションパッケージでの Federated Identity(Cloud Connectors)の有効化
使用しないタイミング
以下の主なガイドとして、このスキルを使用しないでください。
- CEL プログラムの開発(
cel-programs)-- CEL プログラムの構造、状態モデル、mito ワークフロー。例外:Federated Identity 用のauth.aws/use_cloud_connectorsテンプレートブロックは、references/federated-identity-aws.mdを通じてこのスキルが担当します - Ingest パイプラインプロセッサーの設計(
ingest-pipelines) - フィールドマッピングと ECS 準拠(
ecs-field-mappings) var_groups/provider_permissionsスキーマとformat_versionの最低バージョン要件のみ(package-spec)-- それらを適用するエンドツーエンドのフェデレーション手順には、このスキルを使用してください
最初に必ず読むもの
必ず最初に references/common-input-patterns.md を読み込んでください。 すべての入力タイプに適用されるパターン(タグ、プロセッサーのパススルー、変数の規約、forwarded と publisher_pipeline.disable_host の連携)を説明しています。これらのパターンは、すべてのタイプ固有ガイドを読む前提となります。
タイプの振り分け表
agent/stream/ のファイル名パターン、またはデータストリームマニフェストの input: フィールドから入力タイプを特定し、該当するガイドを読み込んでください。
| 入力タイプ | ファイル名パターン | ガイド |
|---|---|---|
| HTTPJSON | httpjson.yml.hbs | references/httpjson-guide.md |
| AWS S3 | aws-s3.yml.hbs | references/aws-s3-guide.md |
| CloudWatch | aws-cloudwatch.yml.hbs | references/aws-cloudwatch-guide.md |
| Azure Blob Storage | azure-blob-storage.yml.hbs | references/azure-blob-storage-guide.md |
| Azure Event Hub | azure-eventhub.yml.hbs | references/azure-eventhub-guide.md |
| GCS | gcs.yml.hbs | references/gcs-guide.md |
| GCP Pub/Sub | gcp-pubsub.yml.hbs | references/gcp-pubsub-guide.md |
| TCP | tcp.yml.hbs | references/tcp-udp-guide.md |
| UDP | udp.yml.hbs | references/tcp-udp-guide.md |
| HTTP Endpoint | http_endpoint.yml.hbs | references/http-endpoint-guide.md |
| Filestream | filestream.yml.hbs | references/filestream-logfile-guide.md |
| Logfile | log.yml.hbs | references/filestream-logfile-guide.md |
| Journald | journald.yml.hbs | references/journald-guide.md |
| Winlog | winlog.yml.hbs | references/winlog-guide.md |
| WebSocket | websocket.yml.hbs | references/websocket-guide.md |
特定した入力タイプのガイドのみを読み込み、すべてのガイドを読み込まないでください。
Federated Identity に関するタスクでは、対象となる入力タイプ(cel を含む)にかかわらず、references/federated-identity-aws.md を読み込んでください。
引き継ぎ
- CEL プログラムのロジックについては、
cel-programsスキルに引き継いでください。cel.yml.hbsの Federated Identity に関するauth.aws/use_cloud_connectorsの編集では、このスキルも引き続き読み込んでください。 - マニフェストスキーマ(
var_groups、provider_permissions、format_version/ 条件の最低バージョン要件)については、package-specスキル(references/var-groups-and-provider-permissions.md)に引き継いでください。 - 入力テンプレートのレビュー中に見つかったパイプラインの問題については、
ingest-pipelinesスキルに引き継いでください。 - テンプレートの変数接続で見つかったフィールドマッピングの問題については、
ecs-field-mappingsスキルに引き継いでください。
参照資料
references/common-input-patterns.md-- タグ、プロセッサーのパススルー、変数の規約、レビュー用フラグ(すべての入力タイプに適用)references/httpjson-guide.md-- HTTPJSON のテンプレート構文、構造、検証ルール、ページネーションパターン、認証、カーソルの永続化references/aws-s3-guide.md-- S3 バケット/SQS 通知の収集references/aws-cloudwatch-guide.md-- CloudWatch ロググループの収集references/azure-blob-storage-guide.md-- Azure Blob Storage の収集references/azure-eventhub-guide.md-- Azure Event Hub の収集references/gcs-guide.md-- Google Cloud Storage の収集references/gcp-pubsub-guide.md-- GCP Pub/Sub の収集references/tcp-udp-guide.md-- TCP および UDP(syslog 形式)のリスナーreferences/http-endpoint-guide.md-- HTTP Endpoint(webhook レシーバー)references/filestream-logfile-guide.md-- Filestream および従来の Logfile 入力references/journald-guide.md-- Journald の収集references/winlog-guide.md-- Windows Event Log の収集references/websocket-guide.md-- WebSocket ストリーミング(CEL を埋め込む場合があります)references/federated-identity-aws.md-- AWS Federated Identity の手順:入力の分類、フェデレーション変数、auth.aws/use_cloud_connectors、入力のゲーティング(スキーマはpackage-specにあります)
コメント
Markdown 対応