Detalhes do Serviço Email Delivery
Detalhes de log para logs do serviço Email Delivery.
Recursos
- emaildomain
Categoria de Log
Valor da API (ID): | Console (Nome para Exibição) | Descrição |
---|---|---|
emaildelivery.emaildomain.outboundaccepted | emaildelivery.emaildomain.outboundaccepted | Logs de envio de e-mails de entrada bem-sucedidos e com falha. |
emaildelivery.emaildomain.outboundrelayed | emaildelivery.emaildomain.outboundrelayed | Logs para submissões de e-mail com êxito e com falha para entrega de saída. |
Políticas
A permissão EMAIL_DOMAIN_UPDATE é necessária, juntamente com Políticas de registro em log, para executar operações relacionadas a Registro em Log. Para obter detalhes sobre políticas do serviço Email Delivery, consulte Detalhes para o Serviço Email Delivery.
Conteúdo de um Log de E-mail OutboundAccepted
Propriedade | Descrição | Exemplo |
---|---|---|
recipient | Endereço de e-mail do destinatário. Pode não estar presente em logs com tipo de erro Autorização, falha, Redefinição ou Desconectado. | user@example.com |
sender | O primeiro endereço de e-mail no cabeçalho "De:" na mensagem de e-mail. | support@example.com |
action | Fornece contexto para os dados no log. Valores suportados para Logs de Aceitação:
Os processadores automatizados devem tolerar logs com valores de ação não reconhecidos. |
accept |
errorType |
Fornece informações para solucionar problemas. Essa propriedade é omitida para e-mails aceitos com êxito. Valores suportados para logs de aceitação:
A Oracle se reserva o direito de adicionar novos valores a esse campo conforme necessário; portanto, os parsers podem tolerar valores não reconhecidos. |
Daily limit reached |
smtpStatus | O status SMTP nos logs de aceitação conterá o erro SMTP ou o status retornado ao cliente de envio SMTP deste destinatário. | 250 2.1.5 user@example.com e opções Ok |
messageId | MessageId é um ID exclusivo que representa uma operação de envio de e-mail. Rastreia um e-mail de ponta a ponta. O messageId é fornecido pelo cliente ou será gerado pelo MTA durante o processamento de e-mail. Essa propriedade não estará presente nos logs de aceitação que falharem antes de receber dados da mensagem. | 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 obter mais informações. |
envelopeSender | O endereço do remetente do envelope inicial (MAIL FROM) fornecido quando o e-mail foi submetido, que é usado para autorizar o envio de e-mail. Ao contrário de Body: data.sender (também conhecido como cabeçalho De), isso é fornecido para casos de falha de aceitação, pois está disponível para falhas antes da transferência do conteúdo da mensagem. | support@example.com |
principalId | OCID do usuário que está tentando enviar o e-mail por meio do protocolo de envio SMTP. Apenas fornecido para logs de falha de autorização. | ocid1.user.oc1.<unique_ID> |
senderId |
OCID do remetente aprovado. Este será o OCID associado a Body:data.sender se ele estiver presente; caso contrário, será o OCID associado a Body:data.envelopeSender. Isso pode não estar presente em falhas de autorização. |
ocid1.emailsender.oc1.phx.<unique_ID> |
senderCompartmentId |
OCID do compartimento do remetente aprovado. Este será o OCID do compartimento associado a Body:data.senderId. Isso pode não estar presente em falhas de autorização. |
ocid1.compartment.oc1..<unique_ID> |
headers | (Disponível no futuro) Cabeçalhos configuráveis no nível do remetente aprovado. Configurado por meio de uma solicitação de suporte e tem no máximo quatro cabeçalhos. |
|
receivingDomain | Domínio de e-mail do destinatário. Embora isso seja redundante com a parte do nome de domínio do campo de destinatário, isso pode ser útil para views de agregação dos logs. | example.com |
messageSizeInKiB | Tamanho da mensagem em kibibytes (arredondado para um número inteiro com teto do modo de arredondamento). | 5 |
authzOpcRequestId | ID de solicitação de OPC para a chamada de autorização feita do Serviço Email Delivery para o Identity, para autorizar um remetente aprovado. | 6D6E701D166D72B8BCB7881647CDAAAA/ 5590913E23F541ECDFA486FE9C611B12/ 40C21F5CB148AF3C391AC98B21D81412 |
message | Um resumo do evento de log. | Accepted email support@example.com → user@example.com |
ingressType |
Fornece a origem do envio de e-mail para solucionar problemas. Essa propriedade é omitida para e-mails aceitos com êxito. Os valores suportados são:
|
|
Amostras de Log para Logs de E-mail OutboundAccepted
Aceitação bem-sucedida:
{
"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"
}
}
Falha na aceitação (suprimido):
{
"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"
}
}
Limite de taxa diária excedido:
{
"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"
}
}
Limite de taxa do remetente excedido:
{
"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"
}
}
Limite de bytes excedido:
{
"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"
}
}
Endereço do destinatário rejeitado (Servidor SMTP de entrada):
{
"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"
}
}
Authorization failure:
{
"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"
}
}
Reset:
{
"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"
}
}
Disconnected:
{
"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"
}
}
Conteúdo de um Log de E-mail OutboundRelayed
Propriedade | Descrição | Exemplo |
---|---|---|
recipient | Endereço de e-mail do destinatário. | user@example.com |
sender | "De:" Cabeçalho na mensagem de e-mail. | support@example.com |
action |
Fornece contexto para os dados no log. Valores suportados para logs relay, bounce e complaint:
Os processadores automatizados devem tolerar logs com valores de ação não reconhecidos. |
|
userAgent |
Fornece o cliente de e-mail, o navegador e o dispositivo do destinatário usados para a solicitação de Cancelamento de Assinatura da Lista. |
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, como Gecko; Ações do Gmail) |
errorType |
Fornece informações para solucionar problemas. Presente apenas nos logs "Bounce". Os valores suportados para logs relay, bounce e complaint são os seguintes:
|
temporária |
bounceCategory | Categoria de devolução. Presente apenas nos logs "Bounce". Os valores possíveis são:
|
Caixa postal |
reportGeneratedTime | Hora em que a ação é gerada. Presente somente em alguns logs "Bounce" e "Complaint". | 2021-02-04T17:26:03.120Z |
originalMessageAcceptedTime | Hora em que a mensagem original é aceita pelo serviço Email Delivery. Refere-se somente ao timestamp original para mensagens devolvidas; portanto, não está presente em todos os logs retayed. | 2021-02-04T17:26:03.120Z |
bounceCode | Um código de resposta SMTP, como 5.5.0, 4.7.1. Presente apenas nos logs "Bounce". Consulte https://www.ietf.org/rfc/rfc1893.txt para obter mais informações. | 5.5.0 |
smtpStatus | O status do SMTP inclui as informações geradas por um servidor SMTP remoto na internet e não é controlado pelo serviço Email Delivery. |
"250 2.1.5 Recipient ok" "550 5.1.1 <user@example.com> o destinatário não existe aqui." "550 5.1.1 apelido desconhecido ou ilegal:
b0c-4031-8d85-33d136229fc3-bmta-ad1-fd1-101-us-ashburn-1 @iad1.rp.oracleemaildelivery.com"550 5.7.0 Violação de Política Local" |
messageId | MessageId é um ID exclusivo que representa uma operação de envio de e-mail. Rastreia um e-mail de ponta a ponta. O messageId é fornecido pelo cliente ou será gerado pelo MTA durante o processamento de e-mail. | 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 obter mais informações. |
senderId | OCID do remetente aprovado. | ocid1.emailsender.oc1.phx.<unique_ID> |
senderCompartmentId | OCID do compartimento do remetente aprovado. | ocid1.compartment.oc1..<unique_ID> |
sourceAddress | O IP de origem é o endereço IP público externo usado para a conexão de saída. Só está presente em logs de "Relay" bem-sucedidos e em logs "bounce" em devoluções definitivas internas. | 192.29.103.192 |
dkimSelector | O valor do seletor DKIM definido pelo "Usuário". Somente presente nos logs de "Relay". O seletor DKIM é um termo técnico definido formalmente na RFC 6376. | prod-phx-20191217 |
dkimError | Texto de erro de assinatura do DKIM. Presente apenas nos logs de "Relay". | "A operação não pode ser iniciada: DKIM 0 sem chave privada para a identidade '@mail.integration.us-ashburn-1.ocp.oraclecloud.com'" |
messageSizeInKiB | Tamanho da mensagem em kibibytes (arredondado para um número inteiro com teto do modo de arredondamento). | 5 |
headers | (Disponível no futuro) Cabeçalhos configuráveis no nível do remetente aprovado. Configurado por meio de uma solicitação de suporte e tem no máximo quatro cabeçalhos. |
|
recipientMailServer | Nome e endereço IP do servidor de e-mail na internet para o qual foi tentada uma retransmissão de e-mail. Só está presente em logs de "Relay" bem-sucedidos e em logs "bounce" em devoluções definitivas internas. Esse campo também é útil para views de log de agregação. |
mail-smtp-in.l.google.com (172.217.197.26) |
internalProcessingDurationInMs | (somente logs de "Relay") Atraso interno em milissegundos desde quando uma mensagem é aceita pelo serviço Email Delivery (por exemplo, quando os dados de fim de mensagem são recebidos pelo front-end), até quando o serviço está pronto para tentar a entrega de saída. | 791 |
tlsCipher | (Somente logs de "Relay") Nome da suíte de cifragem TLS. |
TLS_ECDHE_RSA_WITH _AES_128_GCM_SHA256 |
message | Um resumo do evento de log. |
|
sendingPoolName | Aplicável somente a pools de IP dedicados. | PHXOCIInternalVMTAs |
chunkingUsed | Fornece informações boolianas indicando se o chunking foi suportado durante o roteamento de e-mails. A ausência do parâmetro indica um valor falso, o que significa que o chunking não era suportado durante a comunicação com o agente de transferência de e-mail remoto. | "chunkingUsed": "verdadeiro" |
esmtpUsed | Fornece informações boolianas indicando se o SMTP Estendido (ESMTP) era suportado durante o roteamento de e-mails. A ausência do parâmetro indica um valor falso, o que significa que o ESMTP não foi usado durante a comunicação com o agente de transferência remota de e-mail. | "esmtpUsed": "verdadeiro" |
tlsUsed | Fornece informações boolianas indicando se o TLS era suportado durante a comunicação com o agente de transferência de e-mail remoto. A ausência do parâmetro indica um valor falso, o que significa que o TLS não era suportado durante a comunicação com o agente de transferência remota de e-mail. | "tlsUsed": "verdadeiro" |
Amostras de Log para Logs de E-mail OutboundRelayed
Retransmissão bem-sucedida:
{
"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"
}
}
Hard bounce:
{
"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"
}
}
Soft bounce:
{
"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"
}
}
Complaint:
{
"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"
}
}
Cancelamento de inscrição bem-sucedido:
{
"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"
}
}