- Logstash 参考文档其他版本
- Logstash 简介
- Logstash 入门
- Logstash 的工作原理
- 设置和运行 Logstash
- 升级 Logstash
- 创建 Logstash 管道
- 保护您的连接
- 高级 Logstash 配置
- Logstash 到 Logstash 通信
- 管理 Logstash
- 将 Logstash 与 Elastic Integrations 一起使用
- 使用 Logstash 模块
- 使用 Filebeat 模块
- 使用 Winlogbeat 模块
- 队列和数据弹性
- 转换数据
- 部署和扩展 Logstash
- 管理 GeoIP 数据库
- 性能调优
- 使用 Elastic Agent 监控 Logstash
- 监控 Logstash(旧版)
- 使用 API 监控 Logstash
- 使用插件
- 集成插件
- 输入插件
- azure_event_hubs
- beats
- cloudwatch
- couchdb_changes
- dead_letter_queue
- elastic_agent
- elastic_serverless_forwarder
- elasticsearch
- exec
- file
- ganglia
- gelf
- generator
- github
- google_cloud_storage
- google_pubsub
- graphite
- heartbeat
- http
- http_poller
- imap
- irc
- java_generator
- java_stdin
- jdbc
- jms
- jmx
- kafka
- kinesis
- logstash
- log4j
- lumberjack
- meetup
- pipe
- puppet_facter
- rabbitmq
- redis
- relp
- rss
- s3
- s3-sns-sqs
- salesforce
- snmp
- snmptrap
- sqlite
- sqs
- stdin
- stomp
- syslog
- tcp
- udp
- unix
- varnishlog
- websocket
- wmi
- xmpp
- 输出插件
- boundary
- circonus
- cloudwatch
- csv
- datadog
- datadog_metrics
- dynatrace
- elastic_app_search
- elastic_workplace_search
- elasticsearch
- exec
- file
- ganglia
- gelf
- google_bigquery
- google_cloud_storage
- google_pubsub
- graphite
- graphtastic
- http
- influxdb
- irc
- java_stdout
- juggernaut
- kafka
- librato
- logstash
- loggly
- lumberjack
- metriccatcher
- mongodb
- nagios
- nagios_nsca
- opentsdb
- pagerduty
- pipe
- rabbitmq
- redis
- redmine
- riak
- riemann
- s3
- sink
- sns
- solr_http
- sqs
- statsd
- stdout
- stomp
- syslog
- tcp
- timber
- udp
- webhdfs
- websocket
- xmpp
- zabbix
- 过滤器插件
- age
- aggregate
- alter
- bytes
- cidr
- cipher
- clone
- csv
- date
- de_dot
- dissect
- dns
- drop
- elapsed
- elastic_integration
- elasticsearch
- environment
- extractnumbers
- fingerprint
- geoip
- grok
- http
- i18n
- java_uuid
- jdbc_static
- jdbc_streaming
- json
- json_encode
- kv
- memcached
- metricize
- metrics
- mutate
- prune
- range
- ruby
- sleep
- split
- syslog_pri
- threats_classifier
- throttle
- tld
- translate
- truncate
- urldecode
- useragent
- uuid
- wurfl_device_detection
- xml
- 编解码器插件
- 技巧和最佳实践
- 故障排除
- 为 Logstash 做贡献
- 贡献 Java 插件
- 重大变更
- 发行说明
- Logstash 8.17.0 发行说明
- Logstash 8.16.1 发行说明
- Logstash 8.16.0 发行说明
- Logstash 8.15.4 发行说明
- Logstash 8.15.3 发行说明
- Logstash 8.15.2 发行说明
- Logstash 8.15.1 发行说明
- Logstash 8.15.0 发行说明
- Logstash 8.14.3 发行说明
- Logstash 8.14.2 发行说明
- Logstash 8.14.1 发行说明
- Logstash 8.14.0 发行说明
- Logstash 8.13.4 发行说明
- Logstash 8.13.3 发行说明
- Logstash 8.13.2 发行说明
- Logstash 8.13.1 发行说明
- Logstash 8.13.0 发行说明
- Logstash 8.12.2 发行说明
- Logstash 8.12.1 发行说明
- Logstash 8.12.0 发行说明
- Logstash 8.11.4 发行说明
- Logstash 8.11.3 发行说明
- Logstash 8.11.2 发行说明
- Logstash 8.11.1 发行说明
- Logstash 8.11.0 发行说明
- Logstash 8.10.4 发行说明
- Logstash 8.10.3 发行说明
- Logstash 8.10.2 发行说明
- Logstash 8.10.1 发行说明
- Logstash 8.10.0 发行说明
- Logstash 8.9.2 发行说明
- Logstash 8.9.1 发行说明
- Logstash 8.9.0 发行说明
- Logstash 8.8.2 发行说明
- Logstash 8.8.1 发行说明
- Logstash 8.8.0 发行说明
- Logstash 8.7.1 发行说明
- Logstash 8.7.0 发行说明
- Logstash 8.6.2 发行说明
- Logstash 8.6.1 发行说明
- Logstash 8.6.0 发行说明
- Logstash 8.5.3 发行说明
- Logstash 8.5.2 发行说明
- Logstash 8.5.1 发行说明
- Logstash 8.5.0 发行说明
- Logstash 8.4.2 发行说明
- Logstash 8.4.1 发行说明
- Logstash 8.4.0 发行说明
- Logstash 8.3.3 发行说明
- Logstash 8.3.2 发行说明
- Logstash 8.3.1 发行说明
- Logstash 8.3.0 发行说明
- Logstash 8.2.3 发行说明
- Logstash 8.2.2 发行说明
- Logstash 8.2.1 发行说明
- Logstash 8.2.0 发行说明
- Logstash 8.1.3 发行说明
- Logstash 8.1.2 发行说明
- Logstash 8.1.1 发行说明
- Logstash 8.1.0 发行说明
- Logstash 8.0.1 发行说明
- Logstash 8.0.0 发行说明
- Logstash 8.0.0-rc2 发行说明
- Logstash 8.0.0-rc1 发行说明
- Logstash 8.0.0-beta1 发行说明
- Logstash 8.0.0-alpha2 发行说明
- Logstash 8.0.0-alpha1 发行说明
Logstash 输出插件
编辑Logstash 输出插件
编辑- Logstash 集成插件的一个组件
- 集成版本:v1.0.3
- 发布于:2024-09-12
- 更新日志
对于其他版本,请参阅版本化插件文档。
获取帮助
编辑有关插件的问题,请在Discuss论坛中发起一个主题。对于错误或功能请求,请在Github中打开一个问题。有关 Elastic 支持的插件列表,请参阅Elastic 支持矩阵。
描述
编辑将事件发送到另一个进程或另一主机上的管道中的Logstash 输入插件。您必须在下游输入绑定的接口上具有到端口(默认为 9800)的 TCP 路由。
不建议也不支持将事件发送到 *任何* 非 logstash-input
插件的目标。我们将保持与任何两个受支持的输出/输入对版本的交叉兼容性,并保留更改协议和编码等细节的权利。
最小配置
编辑启用 SSL | 禁用 SSL |
---|---|
output { logstash { hosts => "10.0.0.123:9801" } } |
output { logstash { hosts => "10.0.0.123:9801" ssl_enabled => false } } |
配置概念
编辑通过指定 hosts
来配置此输出插件以连接到Logstash 输入插件。根据下游插件的配置,您可能还需要配置目标端口、SSL 和/或凭据。
安全:SSL 信任
编辑当通过 SSL 通信时,此插件在传输凭据或事件之前,会建立对其连接的服务器的信任。
它通过确保响应服务器提供当前有效的证书,该证书的身份声明与它连接的主机匹配,由可信签名机构签名,并提供相关的私钥材料的所有权证明来实现这一点。
默认情况下使用系统信任存储。您可以使用 *以下之一* 提供 *备用* 信任源:
- PEM 格式的可信证书颁发机构列表(请参阅
ssl_certificate_authorities
) - PKCS12 或 JKS 格式的信任存储(请参阅
ssl_truststore_path
)
安全:SSL 身份
编辑如果下游输入插件配置为请求或需要客户端身份验证,您可以配置此插件以使用 *以下之一* 提供其身份证明:
- JKS 或 PKCS12 格式的密钥库(请参阅
ssl_keystore_path
) - PKCS8 格式的证书/密钥对(请参阅
ssl_certificate
)
Logstash 输出配置选项
编辑此插件支持以下配置选项,以及稍后描述的通用选项。
另请参阅通用选项,以获取所有输出插件支持的选项列表。
hosts
编辑- 值类型是字符串列表
- 此设置没有默认值。
-
约束
- 使用 IPv6 时,IP 地址必须用方括号括起来。
- 如果未提供端口,则使用默认的
9800
。
要连接到的一个或多个下游 `input` 的地址。
主机可以是 IPv4、IPv6(在方括号中)或主机名,例如
-
"127.0.0.1"
-
"127.0.0.1:9801"
-
"ds.example.com"
-
"ds.example.com:9802"
-
"[::1]"
-
"[::1]:9803"
-
"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
-
"[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:9804"
插件在 hosts
之间平衡传入负载。有关更多信息,请访问Logstash 集成插件的“负载均衡”部分。
连接时,除非另行配置,否则与下游输入 Logstash 的通信将通过 SSL 进行保护。
禁用 SSL 是危险的
此插件的安全性依赖于 SSL 来避免泄露凭据并避免运行非法的摄取管道定义。
当使用 SSL 时,响应的服务器必须提供一个证书,其身份声明与此主机名或 IP 地址匹配。
ssl_enabled
编辑- 值类型为布尔值
- 默认值为
true
Logstash 到 Logstash 的通信默认是安全的。当下游输入插件禁用 SSL 时,此处也必须禁用它。
您可以使用 +ssl_enabled => false+
禁用 SSL。禁用后,设置任何 ssl_*
配置都会导致配置失败。
ssl_certificate
编辑PEM 编码的证书或证书链的路径,用于向连接的下游输入标识此插件。
ssl_certificate_authorities
编辑- 值类型为路径
- 此设置没有默认值。
- 不能与禁用 SSL 的配置组合使用。
- 不能与
+ssl_verification_mode => none+
组合使用。
一个或多个 PEM 编码的文件,用于定义证书颁发机构,用于下游输入身份验证。此设置可用于*覆盖*用于验证下游输入提供的 SSL 证书的系统信任存储。
ssl_key
编辑- 值类型为路径
- 此设置没有默认值。
- 当使用
ssl_certificate
配置连接身份时是必需的。 - 不能与禁用 SSL 的配置组合使用。
PEM 编码的*未加密* PKCS8 SSL 证书密钥的路径。
ssl_keystore_path
编辑- 值类型为路径
- 此设置没有默认值。
- 存在时,还需要
ssl_keystore_password
。 - 不能与禁用 SSL 的配置组合使用。
JKS 或 PKCS12 格式的密钥库的路径,用于向下游输入标识此插件。如果下游输入启用SSL 客户端身份验证,则将使用提供的身份。
ssl_keystore_password
编辑- 值类型为密码
- 此设置没有默认值。
- 当使用
ssl_keystore_path
配置连接身份时是必需的。 - 不能与禁用 SSL 的配置组合使用。
ssl_truststore_path
编辑- 值类型为路径
- 此设置没有默认值。
- 存在时,还需要
ssl_truststore_path
。 - 不能与禁用 SSL 的配置组合使用。
- 不能与
+ssl_verification_mode => none+
组合使用。
JKS 或 PKCS12 格式的信任存储的路径,用于验证下游输入的身份声明。如果下游输入启用SSL 客户端身份验证,则将使用提供的身份。
ssl_truststore_password
编辑- 值类型为密码
- 此设置没有默认值。
- 当使用
ssl_truststore_path
配置连接身份时是必需的。 - 不能与禁用 SSL 的配置组合使用。
On this page