amqp

Status: beta

Push events to an AMQP exchange.

AMQP is a messaging system. It requires you to run an AMQP server or 'broker' Examples of AMQP servers are RabbitMQ and QPid

Synopsis

This is what it might look like in your config file:

output {
  amqp {
    debug => ... # boolean (optional)
    durable => ... # boolean (optional), default: true
    exchange_type => ... # ["fanout", "direct", "topic"] (required)
    host => ... # string (required)
    key => ... # string (optional), default: "logstash"
    name => ... # string (required)
    password => ... # password (optional), default: "guest"
    persistent => ... # boolean (optional), default: true
    port => ... # number (optional), default: 5672
    ssl => ... # boolean (optional)
    tags => ... # array (optional), default: []
    type => ... # string (optional), default: ""
    user => ... # string (optional), default: "guest"
    verify_ssl => ... # boolean (optional)
    vhost => ... # string (optional), default: "/"
  }
}

Details

debug

• Value type is boolean
• There is no default value for this setting.

Enable or disable debugging

durable

• Value type is boolean
• Default value is true

Is this exchange durable? (aka; Should it survive a broker restart?)

exchange_type (required setting)

• Value can be any of: "fanout", "direct", "topic"
• There is no default value for this setting.

The exchange type (fanout, topic, direct)

host (required setting)

• Value type is string
• There is no default value for this setting.

Your amqp server address

key

• Value type is string
• Default value is "logstash"

Key to route to by default. Defaults to 'logstash'

• Routing keys are ignored on topic exchanges.

name (required setting)

• Value type is string
• There is no default value for this setting.

The name of the exchange

password

• Value type is password
• Default value is "guest"

Your amqp password

persistent

• Value type is boolean
• Default value is true

Should messages persist to disk on the AMQP broker until they are read by a consumer?

port

• Value type is number
• Default value is 5672

The AMQP port to connect on

ssl

• Value type is boolean
• There is no default value for this setting.

Enable or disable SSL

tags

• Value type is array
• Default value is []

Only handle events with all of these tags. Note that if you specify a type, the event must also match that type. Optional.

type

• Value type is string
• Default value is ""

The type to act on. If a type is given, then this output will only act on messages with the same type. See any input plugin's "type" attribute for more. Optional.

user

• Value type is string
• Default value is "guest"

Your amqp username

verify_ssl

• Value type is boolean
• There is no default value for this setting.

Validate SSL certificate

vhost

• Value type is string
• Default value is "/"

The vhost to use

---

This is documentation from lib/logstash/outputs/amqp.rb