› ›

Sns 输出插件

编辑

Sns 输出插件

编辑

aws 集成插件的一个组件
集成版本：v7.1.8
发布日期：2024-07-26
更新日志

有关其他版本，请参阅版本化插件文档。

获取帮助

编辑

有关插件的问题，请在Discuss论坛中开一个主题。对于错误或功能请求，请在Github中开一个问题。有关 Elastic 支持的插件列表，请参阅Elastic 支持矩阵。

描述

编辑

SNS 输出。

将事件发送到亚马逊的简单通知服务，这是一个托管的发布/订阅框架。它支持各种订阅类型，包括电子邮件、HTTP/S、SMS 和 SQS。

有关该服务的更多文档，请参阅

http://docs.amazonwebservices.com/sns/latest/api/

此插件在接收到的事件中查找以下字段

sns - 如果在配置文件中找不到 ARN，则此字段将用作发布的 ARN。
sns_subject - 应使用的主题行。可选。如果不存在sns_subject，则将使用“%{host}”。主题将被截断为 100 个字符。如果sns_subject设置为非字符串值，则将保存该值的 JSON 版本。
sns_message - 要发送的消息的可选字符串。如果此值设置为非字符串值，则将使用指定的codec对其进行编码。如果未设置此值，则将使用编解码器对整个事件进行编码。@message 将被截断，以便 JSON 的长度适合32768 字节。

升级到 2.0.0

编辑

此插件过去有一个format选项，用于控制消息在发送到 SNS 之前的编码。此插件现在使用 logstash 标准的codec选项进行编码。如果您想要与 v0/1 编解码器相同的plain格式（format => "plain"），请使用codec => "s3_plain"。

Sns 输出配置选项

编辑

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

设置	输入类型	必需
`access_key_id`	字符串	否
`arn`	字符串	否
`aws_credentials_file`	字符串	否
`proxy_uri`	字符串	否
`publish_boot_message_arn`	字符串	否
`region`	字符串，以下值之一：`["us-east-1", "us-east-2", "us-west-1", "us-west-2", "eu-central-1", "eu-west-1", "eu-west-2", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "ap-northeast-2", "sa-east-1", "us-gov-west-1", "cn-north-1", "ap-south-1", "ca-central-1"]`	否
`secret_access_key`	字符串	否
`session_token`	字符串	否
`use_aws_bundled_ca`	布尔值	否

另请参阅通用选项，了解所有输出插件支持的选项列表。

`access_key_id`

编辑

值类型为字符串
此设置没有默认值。

此插件使用 AWS SDK 并支持多种获取凭据的方式，这些方式将按以下顺序尝试

静态配置，使用 logstash 插件配置中的access_key_id和secret_access_key参数
由aws_credentials_file指定的外部凭据文件
环境变量AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY
环境变量AMAZON_ACCESS_KEY_ID和AMAZON_SECRET_ACCESS_KEY
IAM 实例配置文件（在 EC2 中运行时可用）

`arn`

编辑

值类型为字符串
此设置没有默认值。

要发送消息的可选 ARN。如果您未设置此项，则必须在您的事件中包含sns字段，以设置每个消息的 ARN！

`aws_credentials_file`

编辑

值类型为字符串
此设置没有默认值。

包含 AWS 凭据哈希值的 YAML 文件的路径。仅当未设置access_key_id和secret_access_key时才会加载此文件。文件的内容应如下所示

    :access_key_id: "12345"
    :secret_access_key: "54321"

`proxy_uri`

编辑

值类型为字符串
此设置没有默认值。

如果需要，代理服务器的 URI

`publish_boot_message_arn`

编辑

值类型为字符串
此设置没有默认值。

当在此处指定 SNS 主题的 ARN 时，当此插件注册时，消息“Logstash successfully booted”将被发送到它。

示例：arn:aws:sns:us-east-1:770975001275:logstash-testing

`region`

编辑

值可以是以下任何一个：us-east-1、us-east-2、us-west-1、us-west-2、eu-central-1、eu-west-1、eu-west-2、ap-southeast-1、ap-southeast-2、ap-northeast-1、ap-northeast-2、sa-east-1、us-gov-west-1、cn-north-1、ap-south-1、ca-central-1
默认值为"us-east-1"

AWS 区域

`secret_access_key`

编辑

值类型为字符串
此设置没有默认值。

AWS 私有访问密钥

`session_token`

编辑

值类型为字符串
此设置没有默认值。

临时凭据的 AWS 会话令牌

`use_aws_bundled_ca`

编辑

值类型为布尔值
默认值为false

使用 AWS SDK 附带的捆绑 CA 证书来验证 SSL 对等证书。对于默认证书不可用的情况（例如 Windows），您可以将其设置为true。

通用选项

编辑

所有输出插件都支持这些配置选项

设置	输入类型	必需
`codec`	codec	否
`enable_metric`	布尔值	否
`id`	字符串	否

`codec`

编辑

值类型为编解码器
默认值为"plain"

用于输出数据的编解码器。输出编解码器是一种方便的方法，用于在数据离开输出之前对其进行编码，而无需在 Logstash 管道中单独进行过滤。

`enable_metric`

编辑

值类型为布尔值
默认值为true

禁用或启用此特定插件实例的指标记录。默认情况下，我们会记录所有可以记录的指标，但是您可以禁用特定插件的指标收集。

`id`

编辑

值类型为字符串
此设置没有默认值。

向插件配置添加唯一的ID。如果未指定 ID，Logstash 将生成一个。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有 2 个 sns 输出。在这种情况下添加一个命名的 ID 将有助于在使用监控 API 时监控 Logstash。

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

id字段中的变量替换仅支持环境变量，不支持使用密钥存储中的值。

« Sink 输出插件 Solr_http 输出插件 »