Class: LogStash::Inputs::File
- Inherits:
-
Base
- Object
- Base
- LogStash::Inputs::File
- Defined in:
- lib/logstash/inputs/file.rb
Overview
Stream events from files.
By default, each event is assumed to be one line. If you would like to join multiple log lines into one event, you’ll want to use the multiline codec.
Files are followed in a manner similar to ‘tail -0F`. File rotation is detected and handled by this input.
Instance Method Summary collapse
Instance Method Details
#register ⇒ Object
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 |
# File 'lib/logstash/inputs/file.rb', line 72 def register require "addressable/uri" require "filewatch/tail" require "digest/md5" @logger.info("Registering file input", :path => @path) @host = Socket.gethostname.force_encoding(Encoding::UTF_8) @tail_config = { :exclude => @exclude, :stat_interval => @stat_interval, :discover_interval => @discover_interval, :sincedb_write_interval => @sincedb_write_interval, :delimiter => @delimiter, :logger => @logger, } @path.each do |path| if Pathname.new(path).relative? raise ArgumentError.new("File paths must be absolute, relative path specified: #{path}") end end if @sincedb_path.nil? if ENV["SINCEDB_DIR"].nil? && ENV["HOME"].nil? @logger.error("No SINCEDB_DIR or HOME environment variable set, I don't know where " \ "to keep track of the files I'm watching. Either set " \ "HOME or SINCEDB_DIR in your environment, or set sincedb_path in " \ "in your Logstash config for the file input with " \ "path '#{@path.inspect}'") raise # TODO(sissel): HOW DO I FAIL PROPERLY YO end #pick SINCEDB_DIR if available, otherwise use HOME sincedb_dir = ENV["SINCEDB_DIR"] || ENV["HOME"] # Join by ',' to make it easy for folks to know their own sincedb # generated path (vs, say, inspecting the @path array) @sincedb_path = File.join(sincedb_dir, ".sincedb_" + Digest::MD5.hexdigest(@path.join(","))) # Migrate any old .sincedb to the new file (this is for version <=1.1.1 compatibility) old_sincedb = File.join(sincedb_dir, ".sincedb") if File.exists?(old_sincedb) @logger.info("Renaming old ~/.sincedb to new one", :old => old_sincedb, :new => @sincedb_path) File.rename(old_sincedb, @sincedb_path) end @logger.info("No sincedb_path set, generating one based on the file path", :sincedb_path => @sincedb_path, :path => @path) end @tail_config[:sincedb_path] = @sincedb_path if @start_position == "beginning" @tail_config[:start_new_files_at] = :beginning end end |
#run(queue) ⇒ Object
131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 |
# File 'lib/logstash/inputs/file.rb', line 131 def run(queue) @tail = FileWatch::Tail.new(@tail_config) @tail.logger = @logger @path.each { |path| @tail.tail(path) } @tail.subscribe do |path, line| @logger.debug? && @logger.debug("Received line", :path => path, :text => line) @codec.decode(line) do |event| event["[@metadata][path]"] = path event["host"] = @host if !event.include?("host") event["path"] = path if !event.include?("path") decorate(event) queue << event end end finished end |
#teardown ⇒ Object
150 151 152 153 154 155 156 |
# File 'lib/logstash/inputs/file.rb', line 150 def teardown if @tail @tail.sincedb_write @tail.quit @tail = nil end end |