Knowledge base

Sending address

critical

vmta
Half of the queue name

The name of the sending address the message went out through.

It is part of the default set. The field set is defined in the accounting block, and fields are worth adding deliberately: there are as many delivery records as delivered recipients, and every extra column is multiplied by that volume.

Together with the recipient domain it gives the queue — the very pair all limits act on.

The main trap is listing fields without the star. The field is in the default set, but a list in record-fields without * replaces that set: the lines keep only the named fields, and this one disappears silently.
What the Hub does. It reads it — this is one of the fourteen fields the event normalizer parses. So the field must be included in the record, otherwise part of the telemetry will arrive empty.
Recommended values

Where the field exists and whether the star includes it:

Record type In the star
d — delivery yes
b — bounce yes
t — temporary failure yes
tq — queue failure yes
r — reception yes

In a shared file an empty value comes in two kinds: the line has no data — or the field is not selected for its record type.

The record types with this field and the default set markers come from the manual (§ 12.2.1, § 12.2.2, § 12.2.3, § 12.2.4, § 12.2.5); a list without the star replaces the set — § 3.3.11.12. The table is ours.
Example configuration
<acct-file /var/log/pmta/acct.csv>
    record-fields d *, !orcpt</acct-file>
The star with ! removes an unwanted field while vmta stays; a list without the star would keep only what it names.
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
Check whether the column is in the latest accounting file:
head -1 "$(ls -t /var/log/pmta/acct-*.csv | head -1)" | tr -d '\r' | tr ',' '\n' | grep -n '^vmta$'
The line number in the output is the column number in the file; empty means the field is not selected for any record type in this file.
In the Hub
Cost of a mistake
safe: a wrong value breaks nothing
Priority
critical