docs/index.asciidoc in logstash-input-file-4.1.15 vs docs/index.asciidoc in logstash-input-file-4.1.16

- old
+ new

@@ -166,10 +166,11 @@ |Setting |Input type|Required | <<plugins-{type}s-{plugin}-close_older>> |<<number,number>> or <<plugins-{type}s-{plugin}-string_duration,string_duration>>|No | <<plugins-{type}s-{plugin}-delimiter>> |<<string,string>>|No | <<plugins-{type}s-{plugin}-discover_interval>> |<<number,number>>|No | <<plugins-{type}s-{plugin}-exclude>> |<<array,array>>|No +| <<plugins-{type}s-{plugin}-exit_after_read>> |<<boolean,boolean>>|No | <<plugins-{type}s-{plugin}-file_chunk_count>> |<<number,number>>|No | <<plugins-{type}s-{plugin}-file_chunk_size>> |<<number,number>>|No | <<plugins-{type}s-{plugin}-file_completed_action>> |<<string,string>>, one of `["delete", "log", "log_and_delete"]`|No | <<plugins-{type}s-{plugin}-file_completed_log_path>> |<<string,string>>|No | <<plugins-{type}s-{plugin}-file_sort_by>> |<<string,string>>, one of `["last_modified", "path"]`|No @@ -238,9 +239,22 @@ path => "/var/log/*" In Tail mode, you might want to exclude gzipped files: [source,ruby] exclude => "*.gz" + +[id="plugins-{type}s-{plugin}-exit_after_read"] +===== `exit_after_read` + + * Value type is <<boolean,boolean>> + * Default value is `false` + +This option can be used in `read` mode to enforce closing all watchers when file gets read. +Can be used in situation when content of the file is static and won't change during execution. +When set to `true` it also disables active discovery of the files - only files that were in +the directories when process was started will be read. +It supports `sincedb` entries. When file was processed once, then modified - next run will only +read newly added entries. [id="plugins-{type}s-{plugin}-file_chunk_count"] ===== `file_chunk_count` * Value type is <<number,number>>