input-configurations

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-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 联合身份流程：输入分类、联合身份变量、auth.aws / use_cloud_connectors、输入门控（架构位于 package-spec）