Skip to content

AMQP (RabbitMQ) Source

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy

Consumes messages from an AMQP queue.

Configuration

yaml
source:
  kind: amqp
  connection_string: ${AMQP_CONNECTION_STRING}
  queue: events
FieldDefaultDescription
connection_string(required)AMQP connection URI
queue(required)Queue name
exchangeExchange to bind to
routing_keyRouting key for binding
prefetch_count10Prefetch count
modestreamstream or batch

Namespace: amqp.{queue}

CLI

bash
skippr connect source amqp \
  --connection-string 'amqp://guest:guest@localhost:5672' \
  --queue my-queue \
  --exchange events \
  --routing-key output \
  --prefetch-count 10 \
  --mode stream
FlagDescription
--connection-stringAMQP connection URI
--queueQueue name
--exchangeExchange to bind to
--routing-keyRouting key for the binding
--prefetch-countNumber of unacknowledged messages to prefetch
--modeConsumption mode

Authentication

Authentication is provided through the AMQP connection URI. For security best practices, we strongly advise against storing the connection string in skippr.yaml. Use environment variable interpolation instead: replace the connection_string value with your own ${ENV_VAR} reference.

The relevant part of skippr.yaml looks like this:

yaml
source:
  kind: amqp
  connection_string: ${AMQP_CONNECTION_STRING}

Set the env var before running skippr:

macOS / Linux

bash
export AMQP_CONNECTION_STRING="amqp://guest:guest@localhost:5672"

Windows PowerShell

powershell
$env:AMQP_CONNECTION_STRING = "amqp://guest:guest@localhost:5672"

Windows Command Prompt

cmd
set AMQP_CONNECTION_STRING=amqp://guest:guest@localhost:5672

Permissions or Network Requirements

The AMQP user must be allowed to connect to the broker and consume from the selected queue. If you use exchange and routing_key, make sure the broker binding already exists or is created by your messaging workflow.

Troubleshooting

SymptomFix
authentication or connection failuresVerify the AMQP URI, broker hostname, port, and vhost permissions.
no messages arriveCheck the queue name, exchange and routing key, and whether publishers are sending to the expected path.

Next steps

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy