top of page
RafaleMTA - EN

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

bottom of page