Email输出插件

• 插件版本：v4.1.1
• 发布于：2018-04-06
• 修改日志

其他版本请参阅版本化的插件文档。

获取帮助

有关插件的问题，请在讨论论坛中打开一个主题，对于bug或特性请求，在Github中打开一个issue，关于Elastic支持的插件列表，请考虑Elastic支持矩阵。

描述

当收到输出时发送email，或者，你可以使用条件包含或排除email输出执行。

使用的例子

output {
  if "shouldmail" in [tags] {
    email {
      to => '[email protected]'
      from => '[email protected]'
      subject => 'Alert - %{title}'
      body => "Tags: %{tags}\\n\\Content:\\n%{message}"
      template_file => "/tmp/email_template.mustache"
      domain => 'mail.example.com'
      port => 25
    }
  }
}

Email输出配置选项

此插件支持以下配置选项以及稍后描述的通用选项。

还可以查看所有输出插件支持的通用选项列表。

address

• 值类型为string
• 默认值为“localhost”
• 用于连接到邮件服务器的地址

attachments

• 值类型为array
• 默认值为[]
• 附件 — 指定文件的名称和位置

authentication

• 值类型为string
• 此设置没有默认值
• 与服务器进行标识时使用的身份验证方法

body

• 值类型为string
• 默认值为 ""
• 邮件正文 — 纯文本

cc

• 值类型为string
• 此设置没有默认值
• 完全合格的电子邮件地址包括为cc：地址

该字段还接受以逗号分隔的地址字符串，例如：“[email protected], [email protected]”

bcc

• 值类型为string
• 此设置没有默认值
• 完全合格的电子邮件地址包括为bcc：地址，此字段接受多个地址，如cc

contenttype

• 值类型为string
• 默认值为"text/html; charset=UTF-8"
• contenttype：对于多部分消息，设置HTML部分的content-type和/或字符集，这可能不是功能性的（KH）

debug

• 值类型为boolean
• 默认值是false
• 在debug模式运行email传递

domain

• 值类型为string
• 默认值为“localhost”
• 连接到远程SMTP服务器时，在问候语中使用的HELO/EHLO域名，有些服务器需要这个名称来匹配连接客户端的实际主机名

from

• 值类型为string
• 默认值为“[email protected]”
• From的email中的完全限定电子邮件地址：email中的字段

htmlbody

• 值类型为string
• 默认值为""
• 邮件的HTML主体，可能包含HTML标记

password

• 值类型为string
• 此设置没有默认值
• 与服务器进行身份验证的密码

port

• 值类型为number
• 默认值为25
• 用于与邮件服务器通信的端口

replyto

• 值类型为string
• 此设置没有默认值
• Reply-To的完全限定电子邮件地址：字段

subject

• 值类型为string
• 默认值为""
• Subject：email的主题

to

• 这是必需的设置
• 值类型为string
• 此设置没有默认值
• 发送电子邮件到的完全限定的电子邮件地址，该字段还接受以逗号分隔的地址字符串，例如：“[email protected], [email protected]”，你还可以使用%{fieldname}语法从事件中获取的动态字段

use_tls

• 值类型为boolean
• 默认值为false
• 在与服务器通信时启用TLS

username

• 值类型为string
• 此设置没有默认值
• 使用服务器验证的用户名

via

• 值类型为string
• 默认值为"smtp"
• Logstash应该如何发送邮件，或者通过SMTP，或者通过调用sendmail

template_file

• 值类型为path
• 此设置没有默认值
• 用于电子邮件模板的Mustache模板文件路径，请参阅测试夹具中的示例，可以与body一起发送多部分的电子邮件，优先于htmlbody

通用选项

所有输出插件都支持以下配置选项：

codec

• 值类型为codec
• 默认值为"plain"
• 用于输出数据的编解码器，输出编解码器是一种方便的方法，可以在数据离开输出之前对其进行编码，而不需要在你的Logstash管道中使用单独的过滤器。

enable_metric

• 值类型为boolean
• 默认值为true
• 为这个特定的插件实例禁用或启用指标日志记录，默认情况下，我们记录了所有我们可以记录的指标，但是你可以禁用特定插件的指标集合。

id

• 值类型为string
• 此设置没有默认值

• 在插件配置中添加唯一的id，如果没有指定ID，则Logstash将生成一个，强烈建议在配置中设置此ID，当你有两个或多个相同类型的插件时，这一点特别有用。例如，如果你有两个电子邮件输出，在本例中添加一个命名ID将有助于在使用监控API时监控Logstash。

  output {
    email {
      id => "my_plugin_id"
    }
  }