diff --git a/app.yml.sample b/app.yml.sample index a4bcb3b3..f2dd6851 100644 --- a/app.yml.sample +++ b/app.yml.sample @@ -93,6 +93,10 @@ ## this value is used as the timeout argument to the producer.publish function. #amqp_publish_timeout: 2.0 +# AMQP heartbeat interval (see: https://www.rabbitmq.com/docs/heartbeats). Set +# to false or 0 to disable heartbeats. +#amqp_heartbeat: 580 + # AMQP does not guarantee that a published message is received by the AMQP # server, so Pulsar can request that the consumer acknowledge messages and will # resend them if acknowledgement is not received after a configurable timeout diff --git a/docs/configure.rst b/docs/configure.rst index fb1dc748..41b40c5f 100644 --- a/docs/configure.rst +++ b/docs/configure.rst @@ -222,6 +222,10 @@ In the event that the connection to the AMQP server is lost during message publish, the Pulsar server can retry the connection, governed by the ``amqp_publish*`` options documented in `app.yml.sample`_. +By default, `AMQP heartbeats`_ are enabled at an interval of 580 seconds. This +can be adjusted by setting ``amqp_heartbeat`` or disabled by setting it to +``false`` or ``0``. + Caching (Experimental) ---------------------- @@ -241,3 +245,4 @@ and future plans and progress can be tracked on `this Trello card