- 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 发行说明
Rabbitmq 输入插件
编辑Rabbitmq 输入插件
编辑- rabbitmq 集成插件 的一个组件
- 集成版本:v7.4.0
- 发布日期:2024-09-16
- 更新日志
有关其他版本,请参阅版本化插件文档。
获取帮助
编辑如有关于插件的问题,请在Discuss论坛中开启一个主题。如有错误报告或功能请求,请在Github中开启一个 issue。有关 Elastic 支持的插件列表,请参阅Elastic 支持矩阵。
描述
编辑从 RabbitMQ 队列中拉取事件。
默认设置将创建一个完全瞬态的队列,并默认监听所有消息。如果您需要持久性或任何其他高级设置,请设置适当的选项
此插件使用 March Hare 库与 RabbitMQ 服务器进行交互。大多数配置选项直接映射到标准的 RabbitMQ 和 AMQP 概念。AMQP 0-9-1 参考指南和 RabbitMQ 文档的其他部分有助于更深入的理解。
如果启用了 @metadata_enabled
设置,则收到的消息的属性将存储在 [@metadata][rabbitmq_properties]
字段中。请注意,存储元数据可能会降低性能。以下属性可能会可用(在大多数情况下取决于发送者是否设置):
- app-id
- cluster-id
- consumer-tag
- content-encoding
- content-type
- correlation-id
- delivery-mode
- exchange
- expiration
- message-id
- priority
- redeliver
- reply-to
- routing-key
- timestamp
- type
- user-id
例如,要将 RabbitMQ 消息的时间戳属性放入 Logstash 事件的 @timestamp
字段,请使用 date 过滤器解析 [@metadata][rabbitmq_properties][timestamp]
字段
filter { if [@metadata][rabbitmq_properties][timestamp] { date { match => ["[@metadata][rabbitmq_properties][timestamp]", "UNIX"] } } }
此外,任何消息头都将保存在 [@metadata][rabbitmq_headers]
字段中。
Rabbitmq 输入配置选项
编辑此插件支持以下配置选项以及稍后描述的通用选项。
设置 | 输入类型 | 必需 |
---|---|---|
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
是 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
有效的文件系统路径 |
否 |
|
否 |
||
是 |
||
否 |
||
否 |
||
否 |
另请参阅通用选项,了解所有输入插件支持的选项列表。
ack
编辑- 值类型为布尔值
- 默认值为
true
启用消息确认。通过确认,Logstash 获取但尚未发送到 Logstash 管道的消息将在 Logstash 关闭时由服务器重新排队。但是,确认会影响消息吞吐量。
这将仅每 prefetch_count
条消息发送一次确认。批量工作可在此处提高性能。
auto_delete
编辑- 值类型为布尔值
- 默认值为
false
当最后一个消费者断开连接时,是否应在代理上删除队列?如果要使队列保留在代理上,排队消息直到有消费者来消费它们,请将此选项设置为 false
。
durable
编辑- 值类型为布尔值
- 默认值为
false
此队列是否持久?(又名;它是否应在代理重新启动后保留?)如果直接从队列中消费,则必须将此值设置为与现有队列设置匹配,否则连接将因不相等的 arg 错误而失败。
host
编辑- 这是一个必需设置。
- 值类型为字符串
- 此设置没有默认值。
rabbitmq 输入/输出 RabbitMQ 服务器地址的常用功能,主机可以是单个主机,也可以是主机列表,例如 host ⇒ "localhost" 或 host ⇒ ["host01", "host02"]
如果初始连接上提供了多个主机,并且任何后续恢复尝试的主机都是随机选择并连接的。请注意,一次只有一个主机连接处于活动状态。
key
编辑- 值类型为字符串
- 默认值为
"logstash"
将队列绑定到交换机时使用的路由密钥。这仅与 direct 或 topic 交换机相关。
- 路由密钥在 fanout 交换机上被忽略。
- 通配符在 direct 交换机上无效。
metadata_enabled
编辑- 值类型为字符串
-
接受的值为
-
none
:不添加元数据 -
basic
:添加标头和属性 -
extended
:添加标头、属性和原始有效负载 -
false
:none
的已弃用别名 -
true
:basic
的已弃用别名
-
- 默认值为
none
启用关于 RabbitMQ 主题的元数据,以添加到事件的 @metadata
字段,以便在管道处理期间可用。一般来说,大多数输出插件和编解码器不包括 @metadata
字段。这可能会影响内存使用和性能。
元数据映射
编辑类别 | 位置 | type |
---|---|---|
标头 |
|
键/值映射 |
属性 |
|
键/值映射 |
原始有效负载 |
|
字节序列 |
passive
编辑- 值类型为布尔值
- 默认值为
false
如果为 true,则将被动声明队列,这意味着它必须已存在于服务器上。要让 Logstash 在必要时创建队列,请将此选项保留为 false。如果主动声明已存在的队列,则此插件的队列选项(durable 等)必须与现有队列的选项匹配。
queue
编辑- 值类型为字符串
- 默认值为
""
要从每条消息中提取并存储在 @metadata 字段中的属性。
从技术上讲,交换机、重新传递和路由密钥属性属于信封而不是消息,但我们在此忽略了这种区别。但是,我们通过 get_headers 单独提取标头,即使标头表在技术上是消息属性。
冻结所有字符串,以便修改事件 @metadata 字段的代码无法触及它们。
如果更新此列表,请记住也更新上面的文档。此插件的默认编解码器是 JSON。您可以根据您的特定需求覆盖此设置。Logstash 将从中消费事件的队列的名称。如果留空,将创建一个具有随机选择名称的瞬态队列。
ssl
编辑- 值类型为布尔值
- 此设置没有默认值。
启用或禁用 SSL。请注意,默认情况下,远程证书验证是关闭的。如果需要证书验证,请指定 ssl_certificate_path 和 ssl_certificate_password。
On this page
- 获取帮助
- 描述
- Rabbitmq 输入配置选项
ack
arguments
auto_delete
automatic_recovery
connect_retry_interval
connection_timeout
durable
exchange
exchange_type
exclusive
heartbeat
host
key
metadata_enabled
- 元数据映射
passive
password
port
prefetch_count
queue
ssl
ssl_certificate_password
ssl_certificate_path
ssl_version
subscription_retry_interval_seconds
threads
user
vhost
- 通用选项
add_field
codec
enable_metric
id
tags
type