6. LOGS
​
Le système génère des fichiers de logs détaillés, de 3 types : routage, tracking, et messages reçus, ainsi que des agrégats statistiques ventilés par route et heure, archivés une fois par jour.
​
​​
6.1. Logs de routage (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: <taille en octet des données JSON ci-dessous>
{
"rfmta" : [ {
"rfsenddate" : <date de l’envoi {YYMMDDHHMMSS}>,
"ref" : <référence du message ou de la campagne>,
"email" : <adresse email du destinataire>,
"rfevt" : <code de statut (voir ci-dessous)>,
"rfstr" : <détail du code de statut>,
"rfpattern" : <nom du pattern détecté>,
"rfmailno" : <référence système du message ou de la campagne>,
"rfrecno" : <numéro du destinataire dans la liste>,
"rfpoolno" : <numéro du pool d’IP d’émission>,
"rfipno" : <numéro de l’IP d’émission>,
"rfipstr" : <adresse IP d’émission>,
"rfsdno" : <numéro du sender>,
"rfsdstr" : <domaine de sender>,
"rfdmno" : <numéro du groupe de domaines>,
"rfdmstr" : <nom du groupe de domaines>,
"rfmxno" : <numéro du MX>,
"rfmxstr" : <adresse IP du MX>,
"rfmxname" : <nom d’hôte du MX>,
"rfmxdx" : <numéro du MX dans la liste>,
"rfmxnb" : <nombre de MX>,
"rfmxdm" : <numéro du groupe de domaines rattaché au MX>,
"rfmxds" : <nom du groupe de domaines rattaché au MX>,
"rfipflowno" : <numéro du profil de contrôle de flux IP lors de l’envoi>,
"rfipflowstr" : <nom du profil de contrôle de flux IP lors de l’envoi>,
"rfsdflowno" : <numéro du profil de contrôle de flux SENDER>,
"rfsdflowstr" : <nom du profil de contrôle de flux SENDER>,
"rfdnssrv" : <adresse IP du serveur DNS utilisé pour la résolution MX>,
"rfipport" : <port IP de connexion SMTP>,
"rfssno" : <numéro du message dans la session SMTP>,
"rftryno" : <numéro de l’essai>,
"rfenvelopefrom" : <type d’adresse de sender utilisé>,
"rfssl" : <version du protocole SSL/TLS négocié dans la session>,
"rfsslc" : <SSL/TLS Cipher>,
"rfsslh" : <SSL/TLS Hash>,
"rfssle" : <SSL/TLS Exch>,
"rfsize" : <taille en octet du message>,
"rfval" : <dernier code XXX reçu>,
"rfapp" : <dernier code d’erreur applicatif>,
"rferr" : <numéro de la dernière erreur enregistrée>,
"rfdwe" : <numéro de la dernière erreur système enregistrée>,
"rfstp" : <dernière étape du protocole effectuée>,
"rfduration" : <durée totale de la session (ms)>,
"rfdjob" : <durée totale de traitement du message ou de la campagne (ms)>,
"rfdlookup" : <durée de résolution DNS du domaine de destination (ms)>,
"rfdcnt" : <durée d’établissement de la connexion (ms)>,
"rfdforge" : <durée de fusion/personnalisation du message (ms)>,
"rfdsign" : <durée de signature DKIM (ms)>,
"rfbanner" : <message d’accueil du serveur de destination>,
"rfqueued" : <message de confirmation de réception de l’email>,
"rfsnt" : <dernière commande SMTP envoyée>,
"rfrcv" : <dernière réponse SMTP reçue>,
"rfpath" : <chemin d’accès au message original>,
"rftrcref" : <référence de la trace>,
"rftrcoff" : <offset de la trace>,
"rftrclen" : <taille de la trace>
},… ]
}
Intitulé
rfsts
Description
Soft Bounce – voir rfstr pour le détail
Email remis avec succès
Hard Bounce – voir rfstr pour le détail
IP/MX/banner filtré
Erreur système
Changement de sets de paramètres suite à match pattern SMTP
Delivered
Soft
Hard
Flow
Discarded
System
21
22
23
24
25
26
6.2. Logs de tracking
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: <taille en octet des données ci-dessous>
{
"rftrack" : [ {
"rfhitdate" : <date du hit HTTP {YYMMDDHHMMSS}>,
"ref" : <référence l’opération>,
"email" : <adresse email du destinataire>,
"rfevt" : <code de l’évènement (voir ci-dessous)>,
"rfstr" : <intitulé de l’évènement>,
"rfprm" : <paramètres complémentaire de l’évènement>,
"rfsrc" : <source de l’évènement (0=body txt,1=htm,2=amp,3=miroir)>,
"rfmailno" : <référence système du message ou de la campagne>,
"rfrecno" : <numéro du destinataire dans la liste>,
"rfipno" : <numéro de l’IP d’émission>,
"rfipstr" : <adresse IP d’émission>,
"rfsdno" : <numéro du sender>,
"rfsdstr" : <domaine de sender>,
"rfdmno" : <numéro du groupe de domaines>,
"rfdmstr" : <nom du groupe de domaines>,
"rfmxno" : <numéro du MX>,
"rfmxstr" : <adresse IP du MX>,
"rfserverip" : <adresse IP de réception du hit http (ou https)>,
"rfipport" : <port IP de réception du hit http (ou https)>,
"rfclientip" : <adresse IP du client http>,
"rfhttphost" : <entête HTTP ‘Host:’>,
"rfssno" : <numéro de la transaction dans la session http>,
"rfduration" : <durée de la communication (ms)>,
"rfdevice" : <terminal de consultation du client>,
"rfbrowser" : <navigateur web du client>,
"rfurl" : <URL originale de la requête http>,
"rfreferer" : <entête HTTP ‘Referer:’>,
"rfuseragent" : <entête HTTP ‘User-Agent:’>,
"rftrcref" : <référence de la trace>,
"rftrcoff" : <offset de la trace>,
"rftrclen" : <taille de la trace>
},… ]
}
Intitulé
rfsts
Description
Consultation page miroir
Ouverture du message
Hit URL List-Unsuscribe
Hit lien de confirmation de désinscription
Hit lien de désinscription
Open
Mirror
Unlst
Unsub
Uncfm
61
62
63
64
65
66
Bot
Hit lien invisible
Hit lien de tracking
Clic
101-399
6.3. Logs de messages reçus
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: <taille en octet des données ci-dessous>
{
"rfrelay" : [ {
"rfrelaydate" : <date de la réception du message {YYMMDDHHMMSS}>,
"ref" : <référence l’opération>,
"email" : <adresse email du destinataire>,
"rfevt" : <code de l’évènement (voir ci-dessous)>,
"rfstr" : <intitulé de l’évènement>,
"rfprm" : <paramètres complémentaire de l’évènement>,
"rfmailno" : <référence système du message ou de la campagne>,
"rfrecno" : <numéro du destinataire dans la liste>,
"rfipno" : <numéro de l’IP d’émission>,
"rfipstr" : <adresse IP d’émission>,
"rfsdno" : <numéro du sender>,
"rfsdstr" : <domaine de sender>,
"rfdmno" : <numéro du groupe de domaines>,
"rfdmstr" : <nom du groupe de domaines>,
"rfmxno" : <numéro du MX>,
"rfmxstr" : <adresse IP du MX>,
"rfserverip" : <adresse IP de réception du message SMTP>,
"rfportip" : <port IP de réception de la sessions SMTP (ou STMPS)>,
"rfclientip" : <adresse IP du client SMTP>,
"rfssno" : <numéro de la transaction dans la session SMTP>,
"rfssl" : <version de SSL/TLS négociée dans la session>,
"rfduration" : <durée de la communication (ms)>,
"rfsize" : <taille de l’email reçu, en octets>,
"rfehlo" : <message de présentation du client SMTP>,
"rfmailfrom" : <adresse de sender de la session SMTP>,
"rfrcptto" : <adresse de destinataire de la session SMTP>,
"rfrcptno" : <numéro du destinataire>,
"rfrcptnb" : <nombre de destinataires>,
"rfpath" : <chemin d’accès au fichier email reçu (relatif à \REPLY)>,
"rftrcref" : <référence de la trace>,
"rftrcoff" : <offset de la trace>,
"rftrclen" : <taille de la trace>
},… ]
}
rfsts
Intitulé
Description
Message de retour de FeedBackLoop
Message de retour sur adresse List-Unsubscribe
Message de « challenge response »
Message de retour de soft bounce
Message de retour de hard bounce
Unlst
FBL
Challenge
Hard
Soft
41
42
43
44
45
46
Complain
Message de retour de plainte
47
Verp
Message de retour sur mailfrom verp
48
Reply
Message de réponse au fromaddr
49
DMARC
Message de retour sur l’adresse dmarc@sender
6.4. Agrégats horaires
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: <taille en octet des données ci-dessous>
{
"rfagg" : [ {
"rfdate" : <tranche horaire (0 = 0h00-0h59)>,
"rfipno" : <numéro interne de l’IP d’émission>,
"rfipstr" : <adresse IP d’émission>,
"rfsdno" : <numéro interne du sender>,
"rfsdstr" : <domaine de sender>,
"rfdmno" : <numéro interne du groupe de domaines>,
"rfdmstr" : <nom du groupe de domaines>,
"rfmxno" : <numéro interne du MX>,
"rfmxstr" : <adresse IP du MX>,
"rfmxdm" : <numéro interne du groupe de domaines rattaché au MX>,
"rfmxds" : <nom du groupe de domaines rattaché au MX>,
"rflistsize" : <nombre de destinataires par groupe de domaines
(pré calculé à l’injection selon les alias connus)>,
"rfdelivered" : <nombre d’emails délivrés>,
"rfsoft" : <nombre de destinataires en erreur temporaire>,
"rfhard" : <nombre de NPAI>,
"rfflow" : <nombre total de changement de flow au cours du routage>,
"rffallback" : <nombre total de transmission sur MX secondaire>,
"rfopen" : <nombre total d’ouvertures>,
"rfopener" : <nombre total d’ouvreurs>,
"rfclick" : <nombre total de clics>,
"rfclicker" : <nombre total de cliqueurs>,
"rfmirror" : <nombre total de clics sur page mirroir>,
"rfunsub" : <nombre total de clics sur lien de désabonnement>,
"rfuncfm" : <nombre total de clics sur le lien de confirmation>,
"rfunlst" : <nombre désabonnements à l’aide du TAG List-Unsubscribe>,
"rfbot" : <nombre total de clics sur lien invisible>,
"rffbl" : <nombre de FeedBackLoop reçues>,
"rfreply" : <nombre de réponse par email reçues>
},… ]
}
