转换 Ingest 节点管道

编辑

在实现 ingest 管道来解析您的数据之后,您可能决定利用 Logstash 中更强大的转换功能。例如,如果您想:

  • 从更多输入源摄取数据。Logstash 可以原生摄取来自许多其他来源的数据,例如 TCP、UDP、syslog 和关系数据库。
  • 使用多个输出。Ingest 节点设计为仅支持 Elasticsearch 作为输出,但您可能希望使用多个输出。例如,您可能希望将传入数据存档到 S3,同时将其索引到 Elasticsearch 中。
  • 利用 Logstash 中更强大的转换功能,例如外部查找。
  • 使用持久队列功能来处理摄取数据(来自 Beats 和其他来源)时的峰值。

为了方便您迁移配置,Logstash 提供了一个 ingest 管道转换工具。转换工具以 ingest 管道定义作为输入,并在可能的情况下创建等效的 Logstash 配置作为输出。

请参阅 限制,了解工具限制的完整列表。

运行工具

编辑

您可以在 Logstash 安装的 bin 目录中找到转换工具。请参阅 Logstash 目录布局,查找系统上 bin 的位置。

要运行转换工具,请使用以下命令:

bin/ingest-convert.sh --input INPUT_FILE_URI --output OUTPUT_FILE_URI [--append-stdio]

其中

  • INPUT_FILE_URI 是一个文件 URI,它指定定义 ingest 节点管道的 JSON 文件的完整路径。
  • OUTPUT_FILE_URI 是工具将生成的 Logstash DSL 文件的文件 URI。
  • --append-stdio 是一个可选标志,它将 stdin 和 stdout 部分添加到配置中,而不是添加默认的 Elasticsearch 输出。

此命令需要一个文件 URI,因此请确保使用正斜杠并指定文件的完整路径。

例如

bin/ingest-convert.sh --input file:///tmp/ingest/apache.json --output file:///tmp/ingest/apache.conf

限制

编辑
  • 不支持 Painless 脚本转换。
  • 只有一部分可用的处理器 受支持 进行转换。对于不受支持的处理器,工具会发出警告并继续进行尽力而为的转换。

支持的处理器

编辑

当前工具支持转换以下 ingest 节点处理器:

  • Append
  • Convert
  • Date
  • GeoIP
  • Grok
  • Gsub
  • Json
  • Lowercase
  • Rename
  • Set