logstash.yml

配置文件 logstash.yml 的选项可以控制Logstash执行。例如，您可以对管道、配置文件的位置、日志等进行配置。当Logstash运行时，logstash.yml 文件中的大多数设置也可用作 命令行运行 参数。在命令行中设置的参数，都会覆盖 logstash.yml 文件中的相应配置项。

logstash.yml 文件是用YAML编写的，其中的配置项目取决于Logstash（请参阅 目录结构），文件结构可以使用分层模式或平铺模式。 例如，要使用分层模式来设置管道批处理大小和批处理延迟，请指定：

pipeline:
  batch:
    size: 125
    delay: 50

同样的配置项，如果采用平铺模式，如下：

pipeline.batch.size: 125
pipeline.batch.delay: 50

logstash.yml 也支持使用基本的环境变量作为值

pipeline:
  batch:
    size: ${BATCH_SIZE}
    delay: ${BATCH_DELAY:50}
node:
  name: "node_${LS_NODE_NAME}"
path:
   queue: "/tmp/${QUEUE_DIR:queue}"

需要注意的是，${VAR_NAME:default_value} 表达式同样支持，在上面的示例中设置默认批处理延迟 50 和的 path.queue 默认值为 /tmp/queue。

可以在 logstash.yml 中指定模块。 模块定义格式如下：

modules:
  - name: MODULE_NAME1
    var.PLUGIN_TYPE1.PLUGIN_NAME1.KEY1: VALUE
    var.PLUGIN_TYPE1.PLUGIN_NAME1.KEY2: VALUE
    var.PLUGIN_TYPE2.PLUGIN_NAME2.KEY1: VALUE
    var.PLUGIN_TYPE3.PLUGIN_NAME3.KEY1: VALUE
  - name: MODULE_NAME2
    var.PLUGIN_TYPE1.PLUGIN_NAME1.KEY1: VALUE
    var.PLUGIN_TYPE1.PLUGIN_NAME1.KEY2: VALUE

如果命令行中使用了 命令行参数 --module，则上面定义的所有模块都会被忽略。

logstash.yaml 文件包括如下配置项，如果你使用了X-Pack，可以查看 设置X-Pack