mirror of
https://github.com/mailscope/kumomta.git
synced 2026-09-13 05:52:13 +00:00
Wez Furlong
7703b9fcf2
Since we have deprecated the `build_client` approach, we should be showing how to use the preferred function!
65 lines
2.3 KiB
Markdown
65 lines
2.3 KiB
Markdown
# Routing Messages via AMQP
|
|
|
|
In addition to local logging and Webhooks, KumoMTA can relay log events (or other queued messages) via AMQP.
|
|
|
|
KumoMTA supports publishing via AMQP, using Lua.
|
|
|
|
The process to queue log events and make them available for sending via `custom_lua` as a protocol is covered in the [Publishing Log Events Via Webhooks](../operation/webhooks.md) section of the Operations chapter of the User Guide.
|
|
|
|
## Configuring A Queue Handler for AMQP
|
|
|
|
When a message is ready to be queued, the `get_queue_config` event is fired, at which point we can specify the protocol of the queue, in this case `custom_lua`. In the example below, we check whether the message is queued to the `amqp` queue and act accordingly:
|
|
|
|
```lua
|
|
kumo.on('get_queue_config', function(domain, tenant, campaign, routing_domain)
|
|
if domain == 'amqp' then
|
|
-- Use the `make.webhook` event to handle delivery
|
|
-- of webhook log records
|
|
return kumo.make_queue_config {
|
|
protocol = {
|
|
custom_lua = {
|
|
-- this will cause an event called `make.webhook` to trigger.
|
|
-- You can pick any name for this event, so long as it doesn't
|
|
-- collide with a pre-defined event, and so long as you bind
|
|
-- to it with a kumo.on call
|
|
constructor = 'make.amqp',
|
|
},
|
|
},
|
|
}
|
|
end
|
|
return kumo.make_queue_config {}
|
|
end)
|
|
```
|
|
|
|
## Sending Messages via AMQP
|
|
|
|
With the custom_lua protocol defined and a custom event trigger declared, the next step is to catch the `make.amqp` event with code that sends the message contents over HTTP.
|
|
|
|
The following example sends the content of the log message via AMQP:
|
|
|
|
```lua
|
|
-- This is a user-defined event that matches up to the custom_lua
|
|
-- constructor used in `get_queue_config` below.
|
|
-- It returns a lua connection object that can be used to "send"
|
|
-- messages to their destination.
|
|
kumo.on('make.amqp', function(domain, tenant, campaign)
|
|
local sender = {}
|
|
function sender:send(message)
|
|
kumo.amqp.basic_publish {
|
|
routing_key = 'logging',
|
|
payload = message:get_data(),
|
|
connection = {
|
|
host = 'localhost',
|
|
},
|
|
}
|
|
return '250 ok'
|
|
end
|
|
|
|
function sender:close() end
|
|
|
|
return sender
|
|
end)
|
|
```
|
|
|
|
See the [AMQP](../../reference/kumo.amqp/index.md) section of the Reference Manual for more information.
|