Skip to content

Momentum#1472 document the %OC custom_logger macro #865

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
balupillai merged 1 commit into from
Aug 6, 2026
Merged

Momentum#1472 document the %OC custom_logger macro #865

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions content/momentum/4/log-formats-mainlog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ The following is a description of the fields:
| 0 | 1064868656 | Date of reception in Unix timestamp format (seconds since 00:00:00 Jan 1, 1970) |
| 1 | 00/00-25004-31B987F3 | Message's unique message-id |
| 2 | 00/00-03736-F4101B54 | Batch ID |
| 3 | 00/00-04532-A3456B54 | Connection ID |
| 3 | 00/00-04532-A3456B54 | Connection ID: the inbound connection the message was received over |
| 4 | R | `R` indicating a reception |
| 5 | bob | Localpart of the recipient |
| 6 | example.fict | Domain of the recipient |
Expand Down Expand Up @@ -63,7 +63,7 @@ The following is a description of the fields:
| 0 | 1064871280 | Date of delivery in Unix timestamp format (seconds since 00:00:00 Jan 1, 1970) |
| 1 | 20/00-25593-945A87F3 | Message's unique message-id |
| 2 | 00/00-03736-F4101B54 | Batch ID |
| 3 | 00/00-04532-A3456B54 | Connection ID |
| 3 | 00/00-04532-A3456B54 | Connection ID: the outbound connection delivery was attempted over. Each attempt uses a new connection, so retries log different values. |
| 4 | D | `D` indicating a successful delivery or `X` indicating a transfer between nodes, in a cluster configuration.<br> `X` entries appear in the delivery log on the transferring node indicating that the message left for another cluster node, while `R` entries appear in the reception log on the node receiving the message with `xfer` in its protocol field. |
| 5 | postalengine.com | Destination domain |
| 6 | 266 | Size in bytes of the delivered message |
Expand Down Expand Up @@ -92,7 +92,7 @@ The following is a description of the fields:
| 0 | 1064869327 | Date of transient failure in Unix timestamp format (seconds since 00:00:00 Jan 1, 1970) |
| 1 | 00/00-25004-31B987F3 | Message's unique message-id |
| 2 | 00/00-03736-F4101B54 | Batch ID |
| 3 | 00/00-04532-A3456B54 | Connection ID |
| 3 | 00/00-04532-A3456B54 | Connection ID: the outbound connection delivery was attempted over. Each attempt uses a new connection, so retries log different values. |
| 4 | T | `T` indicating a transient failure |
| 5 | example.fict | Destination domain |
| 6 | 0 | Number of bytes of data transferred before the failure occurred. A value of 0 indicates no connection could be made. |
Expand Down Expand Up @@ -123,7 +123,7 @@ The following is a description of the fields:
| 0 | 1064870847 | Date of permanent failure in Unix timestamp format (seconds since 00:00:00 Jan 1, 1970) |
| 1 | 10/00-25593-393A87F3 | Message's unique message-id |
| 2 | 00/00-03736-F4101B54 | Batch ID |
| 3 | 00/00-04532-A3456B54 | Connection ID |
| 3 | 00/00-04532-A3456B54 | Connection ID: the outbound connection delivery was attempted over. Each attempt uses a new connection, so retries log different values. |
| 4 | P | `P` indicating a permanent failure, such as an in-band bounce |
| 5 | postalengine.com | Destination domain |
| 6 | 31 | Number of bytes of data transferred before the failure occurred. In this example, 31 bytes were transferred before the remote server returned its error. |
Expand Down
10 changes: 9 additions & 1 deletion content/momentum/4/modules/custom-logger.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -572,7 +572,7 @@ Number of the heuristic classification of the message from the DSN received from

<dd>

Connection ID
Inbound connection ID: the connection over which the message was received. This is what the mainlog carries in its connection field on reception records; for the connection a delivery was attempted over, see `%OC`.

</dd>

Expand Down Expand Up @@ -658,6 +658,14 @@ Number of times the message has been tried

</dd>

<dt>%OC</dt>

<dd>

Outbound connection ID: the connection over which delivery was attempted. Each attempt uses a new connection, so retries of the same message log different values. This is the value the mainlog carries in its connection field on delivery, transient failure and permanent failure records. Expands empty on receptions, which have no outbound connection.

</dd>

<dt>%P</dt>

<dd>
Expand Down
Loading