mongodb

 

Synopsis

This plugin supports the following configuration options:

Required configuration options:

mongodb {
    collection => ...
    database => ...
    uri => ...
}

Available configuration options:

Setting Input typeRequiredDefault value

codec

codec

No

"plain"

collection

string

Yes

database

string

Yes

generateId

boolean

No

false

isodate

boolean

No

false

retry_delay

number

No

3

uri

string

Yes

workers

number

No

1

Details

 

codec

  • Value type is codec
  • Default value is "plain"

The codec used for output data. Output codecs are a convenient method for encoding your data before it leaves the output, without needing a separate filter in your Logstash pipeline.

collection

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

The collection to use. This value can use %{foo} values to dynamically select a collection based on data in the event.

database

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

The database to use

exclude_tags (DEPRECATED)

  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • Value type is array
  • Default value is []

Only handle events without any of these tags. Note this check is additional to type and tags.

generateId

  • Value type is boolean
  • Default value is false

If true, an "_id" field will be added to the document before insertion. The "_id" field will use the timestamp of the event and overwrite an existing "_id" field in the event.

isodate

  • Value type is boolean
  • Default value is false

If true, store the @timestamp field in mongodb as an ISODate type instead of an ISO8601 string. For more information about this, see http://www.mongodb.org/display/DOCS/Dates

retry_delay

  • Value type is number
  • Default value is 3

Number of seconds to wait after failure before retrying

tags (DEPRECATED)

  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • 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 (DEPRECATED)

  • DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
  • 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.

uri

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

a MongoDB URI to connect to See http://docs.mongodb.org/manual/reference/connection-string/

workers

  • Value type is number
  • Default value is 1

The number of workers to use for this output. Note that this setting may not be useful for all outputs.