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>
},… ]
}
