top of page
RafaleMTA - FR

6. LOGS

​

The system generates detailed log files of 3 types: routing, tracking, and messages received, as well as statistical aggregates broken down by route and time, archived once a day.

​​

6.1. Routing logs (MTA)

GET api/logs/<YYMMDD>/rfmta?fmt=<csv/htm/xml/json_output_file_format> HTTP/1.1
Authorization: <apikey>

-----------------------------------------------------------------------------------------------HTTP/1.1 200 OK
Content-Type: application/json
Content-Lenght: <JSON data size below>

​

{
"rfmta" : [ {
    "rfsenddate"     : <sending date (YYMMDDHHMMSS)>,
    "ref"            : <message/campaign reference>,
    "email"          : <recipient email address>,
    "rfevt"          : <event code (see below)>,
    "rfstr"          : <event description>,
    "rfpattern"      : <name of detected pattern>,
    "rfmailno"       : <message/campaign system reference>,
    "rfrecno"        : <list recipient number>,
    "rfpoolno"       : <sending IP pool number>,
    "rfipno"         : <sending IP internal number>,
    "rfipstr"        : <sending IP address>,
    "rfsdno"         : <sender internal number>,
    "rfsdstr"        : <sender domain>,
    "rfdmno"         : <domain group internal number>,
    "rfdmstr"        : <domain group name>,
    "rfmxno"         : <MX record number>,
    "rfmxstr"        : <MX IP address>,
    "rfmxname"       : <MX name>,
    "rfmxdx"         : <MX record list number>,
    "rfmxnb"         : <number of MX>,
    "rfmxdm"         : <domain group internal number linked to MX>,
    "rfmxds"         : <domain group name linked to MX>,
    "rfipflowno"     : <IP flow control profile number>,
    "rfipflowstr"    : <IP flow control profile name>,
    "rfsdflowno"     : <SENDER flow control profile number>,
    "rfsdflowstr"    : <SENDER flow control profile name>,
    "rfdnssrv"       : <DNS server IP address used for MX resolution>,
    "rfipport"       : <SMTP connection IP port>,
    "rfssno"         : <message number in the SMTP session>,
    "rftryno"        : <transmission attempt number>,
    "rfenvelopefrom" : <sender address type used>,
    "rfssl"          : <version of the SSL/TLS protocol negotiated in the session>,
    "rfsslc"         : <SSL/TLS Cipher>,
    "rfsslh"         : <SSL/TLS Hash>,
    "rfssle"         : <SSL/TLS Exch>,
    "rfsize"         : <message size (bytes)>,
    "rfval"          : <last XXX code received>,
    "rfapp"          : <last application error code>,
    "rferr"          : <number of the last recorded error>,
    "rfdwe"          : <number of the last recorded system error>,
    "rfstp"          : <last step of the protocol performed>,
    "rfduration"     : <total duration of the session (ms)>,
    "rfdjob"         : <total processing time (ms)>,
    "rfdlookup"      : <destination domain DNS resolution time (ms)>,
    "rfdcnt"         : <connection establishment time (ms)>,
    "rfdforge"       : <message merge/personalization duration (ms)>,
    "rfdsign"        : <DKIM signature duration (ms>,
    "rfbanner"       : <destination server greeting message>,
    "rfqueued"       : <email confirmation message>,
    "rfsnt"          : <last SMTP command sent>,
    "rfrcv"          : <last SMTP response received>,
    "rfpath"         : <path to original message>,
    "rftrcref"       : <trace reference>,
    "rftrcoff"       : <trace offset>,
    "rftrclen"       : <trace size>
    },… ]
}

Intitulé

rfsts

Description

Soft Bounce – (see rfstr)

Email successfully delivered

Hard Bounce – (see rfstr)

IP/MX/banner filtered

System error

Change of parameter sets following SMTP match pattern

Delivered

Soft

Hard

Flow

Discarded

System

21

22

23

24

25

26

6.2. Tracking logs

GET api/logs/<YYMMDD>/rftrack?fmt=<csv/htm/xml/json_output_file_format> HTTP/1.1
Authorization: <apikey>

-----------------------------------------------------------------------------------------------HTTP/1.1 200 OK
Content-Type: application/<content type>
Content-Lenght: <JSON data size below>

{
"rftrack" : [ {
    "rfhitdate"      : <HTTP hit date (YYMMDDHHMMSS)>,
    "ref"            : <message/campaign reference>,

    "email"          : <recipient email address>,
    "rfevt"          : <event code (see below)>,
    "rfstr"          : <event description>,
    "rfprm"          : <event parameters>,
    "rfsrc"          : <event source (0=body txt,1=htm,2=amp,3=miroir)>,
    "rfmailno"       : <message/campaign system reference>,
    "rfrecno"        : <list recipient number>,
    "rfipno"         : <sending IP internal number>,
    "rfipstr"        : <sending IP address>,
    "rfsdno"         : <sender internal number>,
    "rfsdstr"        : <sender domain>,
    "rfdmno"         : <domain group internal number>,
    "rfdmstr"        : <domain group name>,
    "rfmxno"         : <MX record number>,
    "rfmxstr"        : <MX IP address>,
    "rfserverip"     : <server listening IP address>,
    "rfipport"       : <server listening IP port>,
    "rfclientip"     : <HTTP client IP address>,
    "rfhttphost"     : <HTTP header ‘Host:’>,
    "rfssno"         : <number of transaction in HTTP session>,
    "rfduration"     : <communication duration (ms)>,
    "rfdevice"       : <client OS>,
    "rfbrowser"      : <client web browser>,
    "rfurl"          : <original URL http request>,
    "rfreferer"      : <HTTP header ‘Referer:’>,
    "rfuseragent"    : <HTTP header ‘User-Agent:’>,
    "rftrcref"       : <trace reference>,

    "rftrcoff"       : <trace offset>,

    "rftrclen"       : <trace size>   

    },… ]
}

Intitulé

rfsts

Description

Click on mirror page link

Message opening

List-Unsuscribe receveided (smtp/http)

Click on confirmation unsubscribe link

Click on unsubscribe link

Open

Mirror

Unlst

Unsub

Uncfm

61

62

63

64

65

66

Bot

Click on invisible link

Click on tracked link

Clic

101-399

6.3. Inbound message logs

GET api/logs<YYMMDD>/rfrelay?fmt=<csv/htm/xml/json_output_file_format> HTTP/1.1
Authorization: <apikey>

​

-----------------------------------------------------------------------------------------------HTTP/1.1 200 OK
Content-Type: application/<content type>
Content-Lenght: <JSON data size below>

​

{
"rfrelay" : [ {
    "rfrelaydate"    : <message reception date (YYMMDDHHMMSS)>,

    "ref"            : <message/campaign reference>,

    "email"          : <recipient email address>,
    "rfevt"          : <event code (see below)>,
    "rfstr"          : <event description>,
    "rfprm"          : <event parameters>,
    "rfmailno"       : <message/campaign system reference>,
    "rfrecno"        : <list recipient number>,
    "rfipno"         : <sending IP internal number>,
    "rfipstr"        : <sending IP address>,
    "rfsdno"         : <sender internal number>,
    "rfsdstr"        : <sender domain>,
    "rfdmno"         : <domain group internal number>,
    "rfdmstr"        : <domain group name>,
    "rfmxno"         : <MX record number>,
    "rfmxstr"        : <MX IP address>,
    "rfserverip"     : <server listening IP address>,

    "rfportip"       : <server listening IP port>,
    "rfclientip"     : <SMTP client IP address>,
    "rfssno"         : <number of transaction in SMTP session>,
    "rfssl"          : <version of the SSL/TLS protocol negotiated in the session>,
    "rfduration"     : <total duration of the session (ms)>,
    "rfsize"         : <received message size (bytes)>,
    "rfehlo"         : <SMTP client EHLO>,
    "rfmailfrom"     : <SMTP client MAIL FROM>,
    "rfrcptto"       : <SMTP client  RCPT TO>,
    "rfrcptno"       : <recipient's number>,
    "rfrcptnb"       : <total number of recipients>,
    "rfpath"         : <path to received raw message (relative to \REPLY)>,

    "rftrcref"       : <trace reference>,

    "rftrcoff"       : <trace offset>,

    "rftrclen"       : <trace size>   

    },… ]
}

rfsts

Intitulé

Description

Message received on feedbackloop registered address

Message received on List-Unsubscribe address

« challenge response » message received

Soft Bounce message received

Hard Bounce message received

Unlst

FBL

Challenge

Hard

Soft

41

42

43

44

45

46

Complain

Complain message received

47

Verp

Message received on MAIL FROM original address

48

Reply

Message received on 'From:' header address

49

DMARC

Message received on the email address of the DMARC DNS record

6.4. Hourly aggregates

GET api/logs/<YYMMDD>/rfagg?fmt=<csv/htm/xml/json_output_file_format> HTTP/1.1
Authorization: <apikey>

​

-----------------------------------------------------------------------------------------------HTTP/1.1 200 OK
Content-Type: application/<content type>
Content-Lenght: <JSON data size below>

​

{
"rfagg" : [ {
    "rfdate"         : <tranche horaire (0 = 0h00-0h59)>,

    "rfipno"         : <internal number of sending IP>,

    "rfipstr"        : <sending IP address>,

    "rfsdno"         : <internal number of sender domain>,

    "rfsdstr"        : <sender domain name>,

    "rfdmno"         : <internal number of domain group>,

    "rfdmstr"        : <domain group name>,

    "rfmxno"         : <internal number of MX>,

    "rfmxstr"        : <MX IP address>,

    "rfmxdm"         : <internal number of domain group linked to MX>,

    "rfmxds"         : <domain group name linked to MX>,

    "rflistsize"     : <number of recipient per domain group

                        (precomputed at campaign submission, according to known aliases)>,

    "rfdelivered"    : <number of delivered emails>,

    "rfsoft"         : <number of soft bounces>,

    "rfhard"         : <number of hard bounces>,

    "rfflow"         : <number of flow change during sending>,

    "rffallback"     : <number of sending on secondary MX>,

    "rfopen"         : <number of openings>,

    "rfopener"       : <number of openers>,

    "rfclick"        : <number of clicks>,

    "rfclicker"      : <number of clickers>,

    "rfmirror"       : <total number of clicks on mirror link>,

    "rfunsub"        : <total number of clicks on unsubscribe link>,

    "rfuncfm"        : <total number of clicks on confirmation unsubscribe link>,

    "rfunlst"        : <total number of clicks on List-Unsubscribe (http/smtp)>,

    "rfbot"          : <total number of clicks on invisible link>,

    "rffbl"          : <number of FeedBackLoop messages received>,

    "rfreply"        : <number of incoming email received>
    },… ]
}

bottom of page