:plugin: irc
:type: output
:default_codec: plain

///////////////////////////////////////////
START - GENERATED VARIABLES, DO NOT EDIT!
///////////////////////////////////////////
:version: %VERSION%
:release_date: %RELEASE_DATE%
:changelog_url: %CHANGELOG_URL%
:include_path: ../../../../logstash/docs/include
///////////////////////////////////////////
END - GENERATED VARIABLES, DO NOT EDIT!
///////////////////////////////////////////

[id="plugins-{type}s-{plugin}"]

=== Irc output plugin

include::{include_path}/plugin_header.asciidoc[]

==== Description

Write events to IRC


[id="plugins-{type}s-{plugin}-options"]
==== Irc Output Configuration Options

This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later.

[cols="<,<,<",options="header",]
|=======================================================================
|Setting |Input type|Required
| <<plugins-{type}s-{plugin}-channels>> |<<array,array>>|Yes
| <<plugins-{type}s-{plugin}-format>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-host>> |<<string,string>>|Yes
| <<plugins-{type}s-{plugin}-messages_per_second>> |<<number,number>>|No
| <<plugins-{type}s-{plugin}-nick>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-password>> |<<password,password>>|No
| <<plugins-{type}s-{plugin}-port>> |<<number,number>>|No
| <<plugins-{type}s-{plugin}-post_string>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-pre_string>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-real>> |<<string,string>>|No
| <<plugins-{type}s-{plugin}-secure>> |<<boolean,boolean>>|No
| <<plugins-{type}s-{plugin}-user>> |<<string,string>>|No
|=======================================================================

Also see <<plugins-{type}s-{plugin}-common-options>> for a list of options supported by all
output plugins.

&nbsp;

[id="plugins-{type}s-{plugin}-channels"]
===== `channels` 

  * This is a required setting.
  * Value type is <<array,array>>
  * There is no default value for this setting.

Channels to broadcast to.

These should be full channel names including the '#' symbol, such as
"#logstash".

[id="plugins-{type}s-{plugin}-format"]
===== `format` 

  * Value type is <<string,string>>
  * Default value is `"%{message}"`

Message format to send, event tokens are usable here

[id="plugins-{type}s-{plugin}-host"]
===== `host` 

  * This is a required setting.
  * Value type is <<string,string>>
  * There is no default value for this setting.

Address of the host to connect to

[id="plugins-{type}s-{plugin}-messages_per_second"]
===== `messages_per_second` 

  * Value type is <<number,number>>
  * Default value is `0.5`

Limit the rate of messages sent to IRC in messages per second.

[id="plugins-{type}s-{plugin}-nick"]
===== `nick` 

  * Value type is <<string,string>>
  * Default value is `"logstash"`

IRC Nickname

[id="plugins-{type}s-{plugin}-password"]
===== `password` 

  * Value type is <<password,password>>
  * There is no default value for this setting.

IRC server password

[id="plugins-{type}s-{plugin}-port"]
===== `port` 

  * Value type is <<number,number>>
  * Default value is `6667`

Port on host to connect to.

[id="plugins-{type}s-{plugin}-post_string"]
===== `post_string` 

  * Value type is <<string,string>>
  * There is no default value for this setting.

Static string after event

[id="plugins-{type}s-{plugin}-pre_string"]
===== `pre_string` 

  * Value type is <<string,string>>
  * There is no default value for this setting.

Static string before event

[id="plugins-{type}s-{plugin}-real"]
===== `real` 

  * Value type is <<string,string>>
  * Default value is `"logstash"`

IRC Real name

[id="plugins-{type}s-{plugin}-secure"]
===== `secure` 

  * Value type is <<boolean,boolean>>
  * Default value is `false`

Set this to true to enable SSL.

[id="plugins-{type}s-{plugin}-user"]
===== `user` 

  * Value type is <<string,string>>
  * Default value is `"logstash"`

IRC Username



[id="plugins-{type}s-{plugin}-common-options"]
include::{include_path}/{type}.asciidoc[]

:default_codec!: