Knowledge base

Queues

Queues Display
One line per pair

Shows queues — “receiver and sending address” pairs. Without filtering this is “Top queues”: the ten pairs with the most recipients.

The “View Options” form sets filtering and list length: only queues with open connections, only without them or all; only in normal mode, only in backoff or in any; how many queues to show; order — by name, number of recipients or volume.

A queue paused by an operator and one held back by the node look alike but are treated differently: backoff mode shows with the mode filter, while the form cannot filter pauses — the show queues command with –paused=yes does that.

The same response as a structure — /queues?format=json.

Access is decided by http-access based on the address the browser is opened from — the monitor level is enough for viewing.

The main trap is taking the top for all queues. The default ten lines are the top of the list by number of recipients: a queue of a couple of messages but with an error does not get in until the length is increased or the order changed.
What the Hub does. It does not use the page: the “Queues” tab of the “PMTA monitoring” screen is built from /queues?format=json, and the Hub asks separately about backoff mode and pauses with commands through /command.
Recommended values

Which filter for which question:

Question Filter
which queues are stuck without connections “without connections”
what the node held back “backoff” mode
where small queues have errors a longer list or order by name
what is paused not on the page — show queues with –paused=yes
The top of ten queues, the filter form fields and the order come from the manual (§ 5.4, § 5.4.1, § 3.3.1.58.23–24); filtering by pause belongs to the command (§ 6.3.14). The split of questions is ours.
Example configuration
# the form's filters in the console: all of backoff mode and pauses
pmta show queues --mode=backoff --maxitems=1000 --no-rcpt-eventspmta show queues --paused=yes --no-rcpt-events
The first line equals the “backoff mode” filter with a long list; the second shows pauses, which the page cannot filter.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
How to check on the node
See the same queues as a structure:
curl -s 'http://127.0.0.1:8080/queues?format=json' | head -60
The response has as many lines as the page without the form — http-default-max-items.
In the Hub
Cost of a mistake
safe: a wrong value breaks nothing
Scenarios
Tune the pace for a provider · Untangle a stuck queue