Class: Fluent::GELFOutput

Inherits:
BufferedOutput
  • Object
show all
Includes:
GelfUtil
Defined in:
lib/fluent/plugin/out_gelf.rb

Instance Method Summary collapse

Methods included from GelfUtil

#make_gelfentry, #make_json

Constructor Details

#initializeGELFOutput

Returns a new instance of GELFOutput.



19
20
21
# File 'lib/fluent/plugin/out_gelf.rb', line 19

def initialize
  super
end

Instance Method Details

#configure(conf) ⇒ Object

Raises:

  • (ConfigError)


23
24
25
26
27
28
29
30
31
32
33
34
35
# File 'lib/fluent/plugin/out_gelf.rb', line 23

def configure(conf)
  super(conf)

  # a destination hostname or IP address must be provided
  raise ConfigError, "'host' parameter (hostname or address of Graylog2 server) is required" unless conf.has_key?('host')

  # choose protocol to pass to gelf-rb Notifier constructor
  # (@protocol is used instead of conf['protocol'] to leverage config_param default)
  if @protocol == 'udp' then @proto = GELF::Protocol::UDP
  elsif @protocol == 'tcp' then @proto = GELF::Protocol::TCP
  else raise ConfigError, "'protocol' parameter should be either 'udp' (default) or 'tcp'"
  end
end

#format(tag, time, record) ⇒ Object



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# File 'lib/fluent/plugin/out_gelf.rb', line 60

def format(tag, time, record)
  if defined? Fluent::EventTime and time.is_a? Fluent::EventTime then
    timestamp = time.sec + (time.nsec.to_f/1000000000).round(3)
  else
    timestamp = time
  end

  make_gelfentry(
    tag,time,record,
    {
      :use_record_host => @use_record_host,
      :add_msec_time => @add_msec_time
    }
  ).to_msgpack

end

#formatted_to_msgpack_binaryObject



83
84
85
# File 'lib/fluent/plugin/out_gelf.rb', line 83

def formatted_to_msgpack_binary
  true
end

#shutdownObject



56
57
58
# File 'lib/fluent/plugin/out_gelf.rb', line 56

def shutdown
  super
end

#startObject



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# File 'lib/fluent/plugin/out_gelf.rb', line 37

def start
  super

  options = {:facility => 'fluentd', :protocol => @proto}

  # add tls key (tls_options) only when tls = True
  # see https://github.com/graylog-labs/gelf-rb/blob/72916932b789f7a6768c3cdd6ab69a3c942dbcef/lib/gelf/notifier.rb#L133-L140
  if @tls then
    options[:tls] = @tls_options
  end

  @conn = GELF::Notifier.new(@host, @port, 'WAN', options)

  # Errors are not coming from Ruby so we use direct mapping
  @conn.level_mapping = 'direct'
  # file and line from Ruby are in this class, not relevant
  @conn.collect_file_and_line = false
end

#write(chunk) ⇒ Object



77
78
79
80
81
# File 'lib/fluent/plugin/out_gelf.rb', line 77

def write(chunk)
  chunk.msgpack_each do |data|
    @conn.notify(data)
  end
end