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"
  }
}