logstash.yml

你可以在Logstash设置文件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文件还支持bash风格的环境变量插值设置值。

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

logstash.yml文件包括以下设置，如果你使用的是X-Pack，请参阅Logstash中的X-Pack设置。