Détails relatifs à Email Delivery
Détails de journalisation pour les journaux Email Delivery.
Ressources
- emaildomain
Catégories de journal
Valeur d'API (ID) : | Console (nom d'affichage) | Description |
---|---|---|
emaildelivery.emaildomain.outboundaccepted | emaildelivery.emaildomain.outboundaccepted | Journaux d'envoi de courriels entrants ayant réussi et échoué. |
emaildelivery.emaildomain.outboundrelayed | emaildelivery.emaildomain.outboundrelayed | Journaux de distribution de courriels sortants ayant réussi et échoué. |
Stratégies
Le droit d'accès EMAIL_DOMAIN_UPDATE est requis, ainsi que les stratégies de journalisation, pour effectuer des opérations liées à la journalisation. Pour plus de détails sur les stratégies Email Delivery, reportez-vous à Détails relatifs au service Email Delivery.
Contenu d'un journal de courriels OutboundAccepted
Propriété | Description | Exemple |
---|---|---|
recipient | Adresse électronique du destinataire. Cette propriété peut ne pas figurer dans les journaux qui comportent une erreur de type Echec de l'autorisation, Réinitialiser ou Déconnecté. | user@example.com |
sender | Première adresse électronique dans l'en-tête "De :" du courriel. | support@example.com |
action | Fournit du contexte pour les données du journal. Valeurs prises en charge pour les journaux d'acceptation :
Les processeurs automatisés doivent tolérer les journaux avec des valeurs d'action non reconnues. |
accept |
errorType |
Fournit des informations pour le dépannage des problèmes. Cette propriété est omise pour les courriels qui ont été acceptés. Valeurs prises en charge pour les journaux d'acceptation :
Oracle se réserve le droit d'ajouter de nouvelles valeurs à ce champ si nécessaire. Les analyseurs peuvent ainsi tolérer des valeurs non reconnues. |
Limite quotidienne atteinte |
smtpStatus | Le statut SMTP dans les journaux d'acceptation contiendra l'erreur SMTP ou le statut renvoyé au client de soumission SMTP pour ce destinataire. | 250 2.1.5 user@example.com and options Ok |
messageId | MessageId est un ID unique qui représente une opération d'envoi de courriel. Suivi d'un courriel de bout en bout. MessageId est fourni par le client ou sera généré par le MTA lors du traitement des courriels. Cela ne figure pas dans les journaux d'acceptation qui échouent avant la réception des données de message. | 06a9aa8e-0542-4ddf-8255-ec9c2f5e02a3 @smtpf-ad3-fd1-303-us-phoenix-1.imtaad3.vcndpphx.oraclevcn.com Pour plus d'informations, reportez-vous à https://datatracker.ietf.org/doc/html/rfc5322#section-3.6.4. |
envelopeSender | Adresse de l'expéditeur de l'enveloppe initiale (MAIL FROM) utilisée pour autoriser l'envoi de courriels et fournie lors de l'envoi. Contrairement à Body:data.sender (à savoir, l'en-tête d'origine), cette valeur est fournie pour les cas d'échec d'acceptation, car elle est disponible pour les échecs avant le transfert du contenu du message. | support@example.com |
principalId | OCID de l'utilisateur qui tente de soumettre des courriels via le protocole de soumission SMTP. Fourni uniquement pour les journaux d'échec d'autorisation. | ocid1.user.oc1.<unique_ID> |
senderId |
OCID de l'expéditeur approuvé. Il s'agit de l'OCID associé à Body:data.sender si celui-ci est présent. Sinon, il s'agit de l'OCID associé à Body:data.envelopeSender. Il risque de ne pas apparaître en cas d'échec d'autorisation. |
ocid1.emailsender.oc1.phx.<unique_ID> |
senderCompartmentId |
OCID de compartiment de l'expéditeur approuvé. Il s'agit de l'OCID de compartiment associé à Body:data.senderId. Il risque de ne pas apparaître en cas d'échec d'autorisation. |
ocid1.compartment.oc1..<unique_ID> |
headers | (Disponible ultérieurement) En-têtes configurables au niveau de l'expéditeur approuvé et paramétrables via une demande d'assistance (quatre en-têtes au maximum). |
|
receivingDomain | Domaine de messagerie du destinataire. Bien que cela soit redondant avec la partie nom de domaine du champ de destinataire, cela peut être utile pour les vues d'agrégation des journaux. | example.com |
messageSizeInKiB | Taille du message en kibioctets (arrondie à un entier avec plafond de mode d'arrondi). | 5 |
authzOpcRequestId | ID de demande OPC pour l'appel d'autorisation passé du service Email Delivery à Identity, afin d'autoriser un expéditeur approuvé. | 6D6E701D166D72B8BCB7881647CDAAAA/ 5590913E23F541ECDFA486FE9C611B12/ 40C21F5CB148AF3C391AC98B21D81412 |
message | Récapitulatif de l'événement de journal. | Accepted email support@example.com → user@example.com |
ingressType |
Fournit la source de la soumission du courriel pour la résolution des problèmes. Cette propriété est omise pour les courriels qui ont été acceptés. Les valeurs prises en charge sont les suivantes :
|
|
Exemples de journal pour les journaux de courriels OutboundAccepted
Acceptation réussie :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com"
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"messageId": "<unique_ID>",
"sender": "support@example.com"
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"messageSizeInKiB": 2,
"receivingDomain": "example.com",
"smtpStatus": "250 2.1.5 user@example.com and options Ok",
"headers": {
"X-Campaign-ID": "campaign1",
"Recipient-Group-ID": "group1",
"Sub-Account-ID": "account1"
},
"message": "Accepted email support@example.com → user@example.com"
}
}
Echec de l'acceptation (supprimée) :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SubmitEmail",
"envelopeSender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"errorType": "Recipient suppressed",
"message": "Suppressed email support@example.com → user@example.com"
}
}
Dépassement de la limite de débit quotidien :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SubmitEmail",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"errorType": "Daily limit reached",
"message": "Rejected email support@example.com → user@example.com: Daily limit 50000 exceeded"
}
}
Dépassement de la limite de débit d'expéditeur :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SMTP",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"errorType": "Sender rate limit reached",
"message": "Rejected email support@example.com → user@example.com: Sender rate limit 18000 exceeded"
}
}
Dépassement de la limite d'octets :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SMTP",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"errorType": "Byte limit exceeded",
"message": "Rejected email support@example.com → user@example.com: Byte limit 2MB exceeded"
}
}
Rejet de l'adresse du destinataire (serveur SMTP entrant) :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SMTP",
"envelopeSender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@test",
"errorType": "Invalid recipient",
"message": "Rejected email support@example.com → user@test.com: Invalid recipient address"
}
}
Echec de l'autorisation :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SubmitEmail",
"envelopeSender": "support@example.com",
"principalId": "ocid1.user.oc1.<unique_ID>",
"errorType": "Authorization failure",
"authzOpcRequestId": "6D6E701D166D72B8BCB7881647CDAAAA/5590913E23F541ECDFA486FE9C611B12/40C21F5CB148AF3C391AC98B21D81412",
"message": "Email approved Body From address: support@example.com is not authorized or not found"
}
}
Réinitialiser :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SubmitEmail",
"envelopeSender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"errorType": "Reset",
"message": "Rejected email from support@example.com: SMTP client reset"
}
}
Déconnecté :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "accept",
"ingressType": "SubmitEmail",
"envelopeSender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"errorType": "Disconnected",
"message": "Rejected email from support@example.com: SMTP client disconnected"
}
}
Contenu d'un journal de courriels OutboundRelayed
Propriété | Description | Exemple |
---|---|---|
recipient | Adresse électronique du destinataire. | user@example.com |
sender | En-tête "De :" dans le courriel. | support@example.com |
action |
Fournit du contexte pour les données du journal. Valeurs prises en charge pour les journaux relayés, de retour et de réclamation :
Les processeurs automatisés doivent tolérer les journaux avec des valeurs d'action non reconnues. |
|
userAgent |
Fournit le client de messagerie, le navigateur et l'appareil du destinataire utilisés pour la demande de désabonnement de liste. |
Mozilla/5.0 (X11 ; Linux x86_64) AppleWebKit/1.0 (KHTML, comme Gecko ; Actions Gmail) |
errorType |
Fournit des informations pour le dépannage des problèmes. Présent uniquement dans les journaux de retour. Les valeurs prises en charge pour les journaux de relais, de retour et de réclamation sont les suivantes :
|
soft |
bounceCategory | Catégorie de retour. Présent uniquement dans les journaux de retour. Valeurs possibles :
|
bad-mailbox |
reportGeneratedTime | Heure à laquelle l'action est générée. Présent uniquement dans certains journaux de retour et de réclamation. | 2021-02-04T17:26:03.120Z |
originalMessageAcceptedTime | Heure à laquelle le message d'origine a été accepté par le service Email Delivery. Fait référence à l'horodatage d'origine pour les messages renvoyés uniquement. Il n'est donc pas présent dans tous les journaux relayés. | 2021-02-04T17:26:03.120Z |
bounceCode | Code de réponse SMTP, tel que 5.5.0 ou 4.7.1. Présent uniquement dans les journaux de retour. Pour plus d'informations, reportez-vous à https://www.ietf.org/rfc/rfc1893.txt. | 5.5.0 |
smtpStatus | Le statut SMTP inclut les informations générées par un serveur SMTP distant sur Internet et n'est pas contrôlé par Email Delivery. |
"250 2.1.5 Recipient ok" "Le destinataire 550 5.1.1 <user@example.com> n'existe pas ici." "550 5.1.1 alias inconnu ou illégal :
b0c-4031-8d85-33d136229fc3-bmta-ad1-fd1-101-us-ashburn-1 @iad1.rp.oracleemaildelivery.com""550 5.7.0 Violation de la politique locale" |
messageId | MessageId est un ID unique qui représente une opération d'envoi de courriel. Suivi d'un courriel de bout en bout. MessageId est fourni par le client ou sera généré par le MTA lors du traitement des courriels. | 06a9aa8e-0542-4ddf-8255-ec9c2f5e02a3 @smtpf-ad3-fd1-303-us-phoenix-1.imtaad3.vcndpphx.oraclevcn.com Pour plus d'informations, reportez-vous à https://datatracker.ietf.org/doc/html/rfc5322#section-3.6.4. |
senderId | OCID de l'expéditeur approuvé. | ocid1.emailsender.oc1.phx.<unique_ID> |
senderCompartmentId | OCID de compartiment de l'expéditeur approuvé. | ocid1.compartment.oc1..<unique_ID> |
sourceAddress | L'adresse IP source est l'adresse IP publique externe utilisée pour la connexion sortante. Cette option n'est présente que dans les journaux de relais et de retour pour les retours permanents internes. | 192.29.103.192 |
dkimSelector | Valeur du sélecteur DKIM défini par l'utilisateur. Présent uniquement dans les journaux de relais. Le terme sélecteur DKIM est défini officiellement dans RFC 6376. | prod-phx-20191217 |
dkimError | Texte d'erreur de signature DKIM. Présent uniquement dans les journaux de relais. | "Operation cannot be started: DKIM 0 no private key for identity '@mail.integration.us-ashburn-1.ocp.oraclecloud.com'" |
messageSizeInKiB | Taille du message en kibioctets (arrondie à un entier avec plafond de mode d'arrondi). | 5 |
headers | (Disponible ultérieurement) En-têtes configurables au niveau de l'expéditeur approuvé et paramétrables via une demande d'assistance (quatre en-têtes au maximum). |
|
recipientMailServer | Nom et adresse IP du serveur de messagerie sur Internet auquel un relais de courriel a été tenté. Cette option n'est présente que dans les journaux de relais et de retour pour les retours permanents internes. Ce champ est également utile pour les vues de journal d'agrégation. |
mail-smtp-in.l.google.com (172.217.197.26) |
internalProcessingDurationInMs | (Journaux de relais uniquement) Délai interne en millisecondes entre le moment où un message est accepté par le service Email Delivery (par exemple, lorsque les données de fin de message sont reçues par notre front-end), et le moment où le service est prêt à essayer une distribution sortante. | 791 |
tlsCipher | (Journaux de relais uniquement) Nom du mécanisme de cryptage TLS. |
TLS_ECDHE_RSA_WITH _AES_128_GCM_SHA256 |
message | Récapitulatif de l'événement de journal. |
|
sendingPoolName | Applicable aux pools d'adresses IP dédiés uniquement. | PHXOCIInternalVMTAs |
chunkingUsed | Fournit des informations booléennes indiquant si le découpage a été pris en charge lors du routage des e-mails. L'absence du paramètre indique une valeur False, ce qui signifie que le découpage par bloc n'était pas pris en charge lors de la communication avec l'agent de transfert de courrier distant. | "chunkingUsed" : "true" |
esmtpUsed | Fournit des informations booléennes indiquant si le protocole SMTP étendu (ESMTP) a été pris en charge lors du routage des e-mails. L'absence du paramètre indique une valeur False, ce qui signifie qu'ESMTP n'a pas été utilisé lors de la communication avec l'agent de transfert de courrier distant. | "esmtpUsed" : "true" |
tlsUsed | Fournit des informations booléennes indiquant si TLS a été pris en charge lors de la communication avec l'agent de transfert de courrier distant. L'absence du paramètre indique une valeur False, ce qui signifie que TLS n'a pas été pris en charge lors de la communication avec l'agent de transfert de courrier distant. | "tlsUsed" : "true" |
Exemples de journal pour les journaux de courriels OutboundRelayed
Relayé :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "relay",
"chunkingUsed": "true",
"esmtpUsed": "true",
"messageId": "<unique_ID>",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"receivingDomain": "example.com",
"sourceAddress": "XXX.XX.XXX.XXX",
"dkimSelector": "selector1",
"messageSizeInKiB": 2,
"smtpStatus": "250 2.1.5 Recipient ok",
"recipientMailServer": "bmta.email.us-phoenix-1.oci.oraclecloud.com (XXX.XX.X.XXX)",
"internalProcessingDurationInMs": 20,
"tlsCipher": "TLS_AES_128_GCM_SHA256",
"tlsUsed": "true",
"sendingPoolName": "<pool_name>",
"headers": {
"X-Campaign-ID": "campaign1",
"Recipient-Group-ID": "group1",
"Sub-Account-ID": "account1"
},
"message": "Relayed email support@example.com → user@example.com"
}
}
Retour permanent :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "bounce",
"messageId": "<unique_ID>",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"receivingDomain": "example.com",
"errorType": "hard",
"bounceCategory": "bad-mailbox",
"bounceCode": "5.1.1",
"reportGeneratedTime": "2021-02-24T22:50:22.123Z",
"originalMessageAcceptedTime": "2021-02-23T22:50:22.123Z",
"smtpStatus": "550 5.1.1 unknown or illegal alias: 974-4710-b440-52e9e1a70cb8-user@example.com",
"message": "Suppressed recipient user@example.com for email from support@example.com: bad-mailbox hard bounce"
}
}
Retour temporaire :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "bounce",
"messageId": "<unique_ID>",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"receivingDomain": "example.com",
"errorType": "soft",
"bounceCategory": "spam-related",
"bounceCode": "5.0.0",
"reportGeneratedTime": "2021-02-24T22:50:22.123Z",
"originalMessageAcceptedTime": "2021-02-23T22:50:22.123Z",
"smtpStatus": "550 5.1.1 <user@example.com> User unknown; rejecting",
"message": "Received spam-related soft bounce for email support@example.com → user@example.com"
}
}
Réclamation :
{
"specversion": "1.0",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
"source": "example.com",
"time": "2021-02-20T09:01:40.000Z",
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"data": {
"action": "complaint",
"messageId": "<unique_ID>",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"recipient": "user@example.com",
"receivingDomain": "example.com",
"message": "Suppressed recipient user@example.com for email from support@example.com: Email complaint"
}
}
Désinscription réussie :
{
"datetime": 1718719068280,
"logContent": {
"data": {
"action": "unsubscribe",
"message": "Email list unsubscribed support@example.com -> user@example.com",
"messageId": "afb866ca-2d7a-11ef-a21e-0242ac11000c@bmta",
"receivingDomain": "example.com",
"recipient": "user@example.com",
"recipientIp": "XXX.XX.XXX.XXX",
"sender": "support@example.com",
"senderCompartmentId": "ocid1.compartment.oc1..<unique_ID>",
"senderId": "ocid1.emailsender.oc1.phx.<unique_ID>",
"userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)"
},
"id": "<unique_ID>",
"oracle": {
"logid": "ocid1.log.oc1.phx.<unique_ID>"
},
"source": "example.com",
"specversion": "1.0",
"time": "2024-06-18T13:57:48.280Z",
"type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed"
}
}