# encoding: utf-8 require "logstash/outputs/base" require "logstash/namespace" require "march_hare" require "java" # Common functionality for the rabbitmq input/output module LogStash module PluginMixins module RabbitMQConnection EXCHANGE_TYPES = ["fanout", "direct", "topic", "x-consistent-hash", "x-modulus-hash"] HareInfo = Struct.new(:connection, :channel, :exchange, :queue) def self.included(base) base.extend(self) base.setup_rabbitmq_connection_config end def setup_rabbitmq_connection_config # RabbitMQ server address(es) # host can either be a single host, or a list of hosts # i.e. # host => "localhost" # or # host => ["host01", "host02] # # if multiple hosts are provided on the initial connection and any subsequent # recovery attempts of the hosts is chosen at random and connected to. # Note that only one host connection is active at a time. config :host, :validate => :string, :required => true , :list => true # RabbitMQ port to connect on config :port, :validate => :number, :default => 5672 # RabbitMQ username config :user, :validate => :string, :default => "guest" # RabbitMQ password config :password, :validate => :password, :default => "guest" # The vhost (virtual host) to use. If you don't know what this # is, leave the default. With the exception of the default # vhost ("/"), names of vhosts should not begin with a forward # slash. config :vhost, :validate => :string, :default => "/" # Enable or disable SSL. # Note that by default remote certificate verification is off. # Specify ssl_certificate_path and ssl_certificate_password if you need # certificate verification config :ssl, :validate => :boolean # Version of the SSL protocol to use. config :ssl_version, :validate => :string, :default => "TLSv1.2" config :verify_ssl, :validate => :boolean, :default => false, :obsolete => "This function did not actually function correctly and was removed." + "If you wish to validate SSL certs use the ssl_certificate_path and ssl_certificate_password options." # Path to an SSL certificate in PKCS12 (.p12) format used for verifying the remote host config :ssl_certificate_path, :validate => :path # Password for the encrypted PKCS12 (.p12) certificate file specified in ssl_certificate_path config :ssl_certificate_password, :validate => :password config :debug, :validate => :boolean, :obsolete => "Use the logstash --debug flag for this instead." # Set this to automatically recover from a broken connection. You almost certainly don't want to override this!!! config :automatic_recovery, :validate => :boolean, :default => true # Time in seconds to wait before retrying a connection config :connect_retry_interval, :validate => :number, :default => 1 # The default connection timeout in milliseconds. If not specified the timeout is infinite. config :connection_timeout, :validate => :number # Heartbeat delay in seconds. If unspecified no heartbeats will be sent config :heartbeat, :validate => :number # Passive queue creation? Useful for checking queue existance without modifying server state config :passive, :validate => :boolean, :default => false # TLS certifcate path config :tls_certificate_path, :validate => :path, :obsolete => "This setting is obsolete. Use ssl_certificate_path instead" # TLS certificate password config :tls_certificate_password, :validate => :string, :obsolete => "This setting is obsolete. Use ssl_certificate_password instead" # Extra queue arguments as an array. # To make a RabbitMQ queue mirrored, use: `{"x-ha-policy" => "all"}` config :arguments, :validate => :array, :default => {} end def conn_str "amqp://#{@user}@#{@host}:#{@port}#{@vhost}" end def close_connection @rabbitmq_connection_stopping = true @hare_info.channel.close if channel_open? @hare_info.connection.close if connection_open? end def rabbitmq_settings return @rabbitmq_settings if @rabbitmq_settings s = { :vhost => @vhost, :hosts => @host, :port => @port, :user => @user, :automatic_recovery => @automatic_recovery, :pass => @password ? @password.value : "guest", } s[:timeout] = @connection_timeout || 0 s[:heartbeat] = @heartbeat || 0 if @ssl s[:tls] = @ssl_version cert_path = @ssl_certificate_path cert_pass = @ssl_certificate_password.value if @ssl_certificate_password if !!cert_path ^ !!cert_pass raise LogStash::ConfigurationError, "RabbitMQ requires both ssl_certificate_path AND ssl_certificate_password to be set!" end s[:tls_certificate_path] = cert_path s[:tls_certificate_password] = cert_pass end @rabbitmq_settings = s end def connect! @hare_info = connect() unless @hare_info # Don't duplicate the conn! rescue MarchHare::Exception, java.io.IOException => e error_message = if e.message.empty? && e.is_a?(java.io.IOException) # IOException with an empty message is probably an instance of # these problems: # https://github.com/logstash-plugins/logstash-output-rabbitmq/issues/52 # https://github.com/rabbitmq/rabbitmq-java-client/issues/100 # # Best guess is to help the user understand that there is probably # some kind of configuration problem causing the error, but we # can't really offer any more detailed hints :\ "An unknown error occurred. RabbitMQ gave no hints as to the cause. Maybe this is a configuration error (invalid vhost, for example). I recommend checking the RabbitMQ server logs for clues about this failure." else e.message end if @logger.debug? @logger.error("RabbitMQ connection error, will retry.", :error_message => error_message, :exception => e.class.name, :backtrace => e.backtrace) else @logger.error("RabbitMQ connection error, will retry.", :error_message => error_message, :exception => e.class.name) end sleep_for_retry retry end def channel_open? @hare_info && @hare_info.channel && @hare_info.channel.open? end def connection_open? @hare_info && @hare_info.connection && @hare_info.connection.open? end def connected? return nil unless @hare_info && @hare_info.connection @hare_info.connection.connected? end private def declare_exchange!(channel, exchange, exchange_type, durable) @logger.debug? && @logger.debug("Declaring an exchange", :name => exchange, :type => exchange_type, :durable => durable) exchange = channel.exchange(exchange, :type => exchange_type.to_sym, :durable => durable) @logger.debug? && @logger.debug("Exchange declared") exchange rescue StandardError => e @logger.error("Could not declare exchange!", :exchange => exchange, :type => exchange_type, :durable => durable, :error_class => e.class.name, :error_message => e.message, :backtrace => e.backtrace) raise e end def connect @logger.debug? && @logger.debug("Connecting to RabbitMQ. Settings: #{rabbitmq_settings.inspect}") connection = MarchHare.connect(rabbitmq_settings) connection.on_shutdown do |conn, cause| @logger.warn("RabbitMQ connection was closed!", :url => connection_url(conn), :automatic_recovery => @automatic_recovery, :cause => cause) end connection.on_blocked do @logger.warn("RabbitMQ connection blocked! Check your RabbitMQ instance!", :url => connection_url(connection)) end connection.on_unblocked do @logger.warn("RabbitMQ connection unblocked!", :url => connection_url(connection)) end channel = connection.create_channel @logger.info("Connected to RabbitMQ at #{rabbitmq_settings[:host]}") HareInfo.new(connection, channel) end # Mostly used for printing debug logs def connection_url(connection) user_pass = connection.user ? "#{connection.user}:XXXXXX@" : "" protocol = params["ssl"] ? "amqps" : "amqp" "#{protocol}://#{user_pass}#{connection.host}:#{connection.port}#{connection.vhost}" end def sleep_for_retry Stud.stoppable_sleep(@connect_retry_interval) { @rabbitmq_connection_stopping } end end end end