Detalles de Email Delivery

Detalles de registro para logs de Email Delivery.

Recursos

  • emaildomain

Categorías de log

Valor de API (ID): Consola (nombre mostrado) Descripción
emaildelivery.emaildomain.outboundaccepted emaildelivery.emaildomain.outboundaccepted Logs de envíos correctos y con fallos de correos electrónicos de entrada.
emaildelivery.emaildomain.outboundrelayed emaildelivery.emaildomain.outboundrelayed Logs de envíos de correos electrónicos correctos y con fallos para entrega de salida.

Políticas

Se necesita el permiso EMAIL_DOMAIN_UPDATE, junto con las políticas de Logging, para realizar operaciones relacionadas con Logging. Para obtener más información sobre las políticas de Email Delivery, consulte Detalles del servicio Email Delivery.

Contenido de un log de correo electrónico OutboundAccepted

Propiedad Descripción Ejemplo
recipient Dirección de correo electrónico del destinatario. Puede que esto no esté presente en los logs con el tipo de error Fallo de autorización, Restablecer o Desconectado. user@example.com
sender Primera dirección de correo electrónico en la cabecera "De:" del mensaje de correo electrónico. support@example.com
action Proporciona contexto para los datos del log. Valores soportados para los logs de aceptación:
  • Aceptar: el log proporciona información sobre el estado de aceptación de un correo electrónico.

Los procesadores automatizados deben tolerar los logs con valores de acción no reconocidos.

accept
errorType

Proporciona información para la solución de problemas. Se omite para correos electrónicos aceptados correctamente.

Valores soportados para los logs de aceptación:
  • Receptor suprimido: el correo electrónico se ha suprimido y no se ha retransmitido.
  • Authorization failure: el correo electrónico no se ha aceptado debido a fallos de autorización.
  • Destinatario no válido: no se ha aceptado el correo electrónico debido a una dirección de destinatario no válida.
  • Daily Limit reached: no se ha podido aceptar el correo electrónico debido a los límites.
  • Sender Rate Limit reached: no se ha podido aceptar el correo electrónico debido a los límites.
  • Se ha superado el límite de bytes: no se ha podido aceptar el correo electrónico porque se ha superado el límite de tamaño del mensaje.
  • Reset: el cliente ha cancelado la transacción de correo (mediante RSET de SMTP).
  • Disconnected: la conexión del cliente al servicio se ha perdido antes de que se completara la transacción de correo.
  • Message parse error: no se ha podido aceptar el correo electrónico debido a un formato de mensaje no válido. Solo se registran fallos de autorización.

Oracle se reserva el derecho de agregar nuevos valores a este campo según sea necesario, por lo que los analizadores deben ser capaces de tolerar valores no reconocidos.

Daily limit reached
smtpStatus El estado de SMTP en los logs de aceptación contendrá el error de SMTP o el estado devuelto al cliente de envío SMTP para este destinatario. 250 2.1.5 user@example.com and options Ok
messageId MessageId es un identificador único que representa una operación de envío de correo electrónico. Se utiliza para realizar un seguimiento integral de un correo electrónico. El cliente proporciona MessageId o lo generará el MTA durante el procesamiento del correo electrónico. No estará presente en los logs de aceptación que fallan antes de recibir los datos del mensaje. 06a9aa8e-0542-4ddf-8255-ec9c2f5e02a3

@smtpf-ad3-fd1-303-us-phoenix-1.imtaad3.vcndpphx.oraclevcn.com

Consulte https://datatracker.ietf.org/doc/html/rfc5322#section-3.6.4 para obtener más información.

envelopeSender Dirección inicial del remitente del sobre (MAIL FROM) proporcionada cuando se envió el correo electrónico, la cual se utiliza para autorizar el envío del correo electrónico. A diferencia de Body:data.sender (también conocido como la cabecera De), se proporciona para los casos de fallos de aceptación, ya que está disponible para los fallos antes de la transferencia del contenido del mensaje. support@example.com
principalId OCID del usuario que intenta enviar el correo electrónico mediante el protocolo de envío SMTP. Solo se proporciona para logs de fallos de autorización. ocid1.user.oc1.<unique_ID>
senderId

OCID de remitente aprobado. Será el OCID asociado a Body:data.sender si está presente; de lo contrario, será el OCID asociado a Body:data.envelopeSender. Es posible que no esté presente en los fallos de autorización.

ocid1.emailsender.oc1.phx.<unique_ID>
senderCompartmentId

OCID de compartimento del remitente aprobado. Será el OCID de compartimento asociado a Body:data.senderId. Es posible que no esté presente en los fallos de autorización.

ocid1.compartment.oc1..<unique_ID>
headers (Disponible en el futuro) Cabeceras configurables en el nivel de remitente aprobado. Se configura mediante una solicitud de soporte y tiene un máximo de cuatro cabeceras.
{
 "X-Campaign-ID":"campaign1",
 "Recipient-Group-ID": "group1",
 "Sub-Account-ID": "account1"
}
receivingDomain Dominio de correo electrónico del destinatario. Aunque es redundante con la parte del nombre de dominio del campo de destinatario, puede ser útil para las vistas de agregación de los logs. example.com
messageSizeInKiB Tamaño del mensaje en kibibytes (redondeado a un entero con el techo del modo de redondeo). 5
authzOpcRequestId ID de solicitud de OPC para la llamada de autorización realizada desde el servicio Email Delivery a Identity para autorizar a un remitente aprobado. 6D6E701D166D72B8BCB7881647CDAAAA/

5590913E23F541ECDFA486FE9C611B12/

40C21F5CB148AF3C391AC98B21D81412

message Resumen del evento de log. Accepted email support@example.com → user@example.com
ingressType

Proporciona el origen del envío de correo electrónico para solucionar problemas. Se omite para correos electrónicos aceptados correctamente.

Los valores soportados son:
  • SubmitEmail: correos electrónicos enviados a través de la API de envío HTTPS.
  • SMTP: correos electrónicos enviados a través del punto final de SMTP.

SubmitEmail

SMTP

Ejemplos de logs para logs de correo electrónico de OutboundAccepted

Aceptación correcta:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com"
  "time": "2021-02-20T09:01:40.000Z",
  "id": "dccc219d-6733-4c68-b357-efeee378fb02",
  "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"
  }
}

Aceptación fallida (suprimido):

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "3391f649-909e-4a0d-a07a-ee222a0d2714",
  "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"
  }
}

Se ha excedido el límite de frecuencia diario:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "3391f649-909e-4a0d-a07a-ee222a0d2714",
  "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"
  }
}

Se ha excedido el límite de frecuencia del remitente:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "53bb943a-f04a-402c-8de0-74e387ca2d08",
  "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"
  }
}

Se ha excedido el límite de bytes:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7d674693-b394-499d-9ce5-be2d1cbc796e",
  "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"
  }
}

Dirección de destinatario rechazada (servidor SMTP entrante):

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7d674693-b394-499d-9ce5-be2d1cbc796e",
  "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"
  }
}

Fallo de autorización:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7d674693-b394-499d-9ce5-be2d1cbc796e",
  "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"
  }
}

Restablecido:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7d674693-b394-499d-9ce5-be2d1cbc796e",
  "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"
  }
}

Desconectado:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundaccepted",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7d674693-b394-499d-9ce5-be2d1cbc796e",
  "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"
  }
}

Contenido de un log de correo electrónico OutboundRelayed

Propiedad Descripción Ejemplo
recipient Dirección de correo electrónico del destinatario. user@example.com
sender Cabecera "De:" del mensaje de correo electrónico. support@example.com
action
Proporciona contexto para los datos del log. Valores soportados para los logs retransmitidos, de devolución y de queja:
  • Retransmisión: se ha retransmitido correctamente al servidor de correo de recepción.
  • Devolución: se ha devuelto desde el servidor de correo de recepción.
  • Queja: el destinatario lo ha marcado como correo no deseado y el proveedor del buzón soporta un bucle de comentarios de queja.

    Nota: No todos los dominios de recepción proporcionan comentarios de queja.

Los procesadores automatizados deben tolerar los logs con valores de acción no reconocidos.

  • relay
  • bounce
  • complaint
errorType

Proporciona información para la solución de problemas. Solo está presente en los logs de devolución.

Los valores soportados para los logs retransmitidos, devueltos y de queja son los siguientes:
  • Devolución temporal: error transitorio del servidor de recepción, que provoca que no se entregue el mensaje.
  • Devolución permanente: error permanente del servidor de recepción, lo que provoca que no se entregue el mensaje y que la dirección del destinatario se agregue a la lista de supresión.
soft
bounceCategory Categoría de devolución. Solo está presente en los logs de devolución. Posibles valores:
  • configuración incorrecta
  • conexión errónea
  • dominio erróneo
  • bad-mailbox
  • relacionados con el contenido
  • buzón de correo inactivo
  • remitente no válido
  • mensaje caducado
  • sin respuesta del host
  • otro
  • relacionadas con las políticas
  • errores de protocolo
  • cuotas
  • emisiones de retransmisión
  • enrutamiento-errores
  • relacionados con spam
  • sin clasificar
  • relacionados con virus
bad-mailbox
reportGeneratedTime Hora a la que se genera la acción. Solo está presente en algunos logs de devolución y queja. 2021-02-04T17:26:03.120Z
originalMessageAcceptedTime Hora a la que el servicio Email Delivery acepta el mensaje original. Hace referencia al registro de hora original solo para mensajes devueltos, por lo que no está presente en todos los logs retransmitidos. 2021-02-04T17:26:03.120Z
bounceCode Código de respuesta SMTP, como 5.5.0, 4.7.1. Solo está presente en los logs de devolución. Consulte https://www.ietf.org/rfc/rfc1893.txt para obtener más información. 5.5.0
smtpStatus El estado de SMTP incluye la información generada por un servidor SMTP remoto en internet y, por lo general, no está controlada por Email Delivery.

"250 2.1.5 Recipient ok"

"550 5.1.1 <user@example.com> recipient does not exist here."

"550 5.1.1 Alias desconocido o no válido:

b0c-4031-8d85-33d136229fc3-bmta-ad1-fd1-101-us-ashburn-1

@iad1.rp.oracleemaildelivery.com""550 5.7.0 Violación de Política Local"

messageId MessageId es un identificador único que representa una operación de envío de correo electrónico. Se utiliza para realizar un seguimiento integral de un correo electrónico. El cliente proporciona MessageId o lo generará el MTA durante el procesamiento del correo electrónico. 06a9aa8e-0542-4ddf-8255-ec9c2f5e02a3

@smtpf-ad3-fd1-303-us-phoenix-1.imtaad3.vcndpphx.oraclevcn.com

Consulte https://datatracker.ietf.org/doc/html/rfc5322#section-3.6.4 para obtener más información.

senderId OCID de remitente aprobado. ocid1.emailsender.oc1.phx.<unique_ID>
senderCompartmentId OCID de compartimento del remitente aprobado. ocid1.compartment.oc1..<unique_ID>
sourceAddress La IP de origen es la dirección IP pública externa utilizada para la conexión saliente. Solo está presente en los logs de retransmisión correctos y los logs de devolución para las devoluciones permanentes internas. 192.29.103.192
dkimSelector Valor de selector de DKIM definido por el usuario. Solo está presente en los logs de retransmisión. El selector de DKIM es un término técnico definido formalmente en el RFC 6376. prod-phx-20191217
dkimError Texto de error de firma de DKIM. Solo está presente en los logs de retransmisión. "Operation cannot be started: DKIM 0 no private key for identity '@mail.integration.us-ashburn-1.ocp.oraclecloud.com'"
messageSizeInKiB Tamaño del mensaje en kibibytes (redondeado a un entero con el techo del modo de redondeo). 5
headers (Disponible en el futuro) Cabeceras configurables en el nivel de remitente aprobado. Se configura mediante una solicitud de soporte y tiene un máximo de cuatro cabeceras.
{
  "X-Campaign-ID":"campaign1",
  "Recipient-Group-ID": "group1",
  "Sub-Account-ID": "account1"
}
recipientMailServer Nombre y dirección IP del servidor de correo de internet al que se ha intentado realizar una retransmisión de correo electrónico. Solo está presente en los logs de retransmisión correctos y los logs de devolución para las devoluciones permanentes internas. Este campo también es útil para las vistas de log de agregación.

mail-smtp-in.l.google.com

(172.217.197.26)

internalProcessingDurationInMs (Solo logs de retransmisión) Retraso interno en milisegundos desde el momento en que el servicio Email Delivery acepta un mensaje (por ejemplo, cuando nuestros front-end reciben datos de fin de mensaje), hasta el momento en que el servicio está listo para intentar la entrega de salida. 791
tlsCipher (Solo logs de retransmisión) Nombre del conjunto de cifrado TLS.

TLS_ECDHE_RSA_WITH

_AES_128_GCM_SHA256

message Resumen del evento de log.

Relayed email support@example.com

-> user@example.com

sendingPoolName Aplicable solo a pools de IP dedicada. PHXOCIInternalVMTAs

Ejemplos de logs para logs de correo electrónico de OutboundRelayed

Retransmisión correcta:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "2eefd817-0a53-4be0-990c-224708aff337",
  "oracle": {
    "logid": "ocid1.log.oc1.phx.<unique_ID>"
  },
  "data": {
    "action": "relay",
    "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",
    "sendingPoolName": "PHXOCIVMTAs",
    "headers": {
      "X-Campaign-ID": "campaign1",
      "Recipient-Group-ID": "group1",
      "Sub-Account-ID": "account1"
    },
    "message": "Relayed email support@example.com → user@example.com"
  }
}

Devolución permanente:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7f7fa34c-8361-4013-9dda-d43631c95a3c",
  "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"
  }
}

Devolución temporal:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "7f7fa34c-8361-4013-9dda-d43631c95a3c",
  "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"
  }
}

Queja:

{
  "specversion": "1.0",
  "type": "com.oraclecloud.emaildelivery.emaildomain.outboundrelayed",
  "source": "example.com",
  "time": "2021-02-20T09:01:40.000Z",
  "id": "936f5f8c-0724-4321-b0d9-4c7f6cf8d043",
  "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"
  }
}