docs/index.asciidoc in logstash-output-email-4.0.4 vs docs/index.asciidoc in logstash-output-email-4.0.6

- old
+ new

@@ -10,37 +10,37 @@ :include_path: ../../../../logstash/docs/include /////////////////////////////////////////// END - GENERATED VARIABLES, DO NOT EDIT! /////////////////////////////////////////// -[id="plugins-{type}-{plugin}"] +[id="plugins-{type}s-{plugin}"] === Email output plugin include::{include_path}/plugin_header.asciidoc[] ==== Description +Sends email when an output is received. Alternatively, you may include or +exclude the email output execution using conditionals. ==== Usage Example [source,ruby] ---------------------------------- output { if "shouldmail" in [tags] { email { - to => 'technical@logstash.net' - from => 'monitor@logstash.net' + to => 'technical@example.com' + from => 'monitor@example.com' subject => 'Alert - %{title}' body => "Tags: %{tags}\\n\\Content:\\n%{message}" - domain => 'mail.logstash.net' + domain => 'mail.example.com' port => 25 } } } ---------------------------------- -Send email when an output is received. Alternatively, you may include or -exclude the email output execution using conditionals. [id="plugins-{type}s-{plugin}-options"] ==== Email Output Configuration Options This plugin supports the following configuration options plus the <<plugins-{type}s-{plugin}-common-options>> described later. @@ -112,11 +112,11 @@ * There is no default value for this setting. The fully-qualified email address(es) to include as cc: address(es). This field also accepts a comma-separated string of addresses, for example: -`"me@host.com, you@host.com"` +`"me@example.com, you@example.com"` [id="plugins-{type}s-{plugin}-contenttype"] ===== `contenttype` * Value type is <<string,string>> @@ -137,17 +137,19 @@ ===== `domain` * Value type is <<string,string>> * Default value is `"localhost"` -Domain used to send the email messages +The HELO/EHLO domain name used in the greeting message when connecting +to a remote SMTP server. Some servers require this name to match the +actual hostname of the connecting client. [id="plugins-{type}s-{plugin}-from"] ===== `from` * Value type is <<string,string>> - * Default value is `"logstash.alert@nowhere.com"` + * Default value is `"logstash.alert@example.com"` The fully-qualified email address for the From: field in the email. [id="plugins-{type}s-{plugin}-htmlbody"] ===== `htmlbody` @@ -197,11 +199,11 @@ * There is no default value for this setting. The fully-qualified email address to send the email to. This field also accepts a comma-separated string of addresses, for example: -`"me@host.com, you@host.com"` +`"me@example.com, you@example.com"` You can also use dynamic fields from the event with the `%{fieldname}` syntax. [id="plugins-{type}s-{plugin}-use_tls"] ===== `use_tls` @@ -228,6 +230,6 @@ How Logstash should send the email, either via SMTP or by invoking sendmail. [id="plugins-{type}s-{plugin}-common-options"] -include::{include_path}/{type}.asciidoc[] \ No newline at end of file +include::{include_path}/{type}.asciidoc[]