Registros de correo electrónico de Azure Communication Services
Azure Communication Services ofrece funcionalidades de registro que sirven para supervisar y depurar la solución de Communication Services. Estas funcionalidades pueden configurarse mediante Azure Portal.
Requisitos previos
Azure Communications Services proporciona características de supervisión y análisis a través de la introducción a los registros de Azure Monitor y las métricas de Azure Monitor. Cada recurso de Azure necesita su propia configuración de diagnóstico, que establece los siguientes criterios:
- Categorías de los datos de los registros y las métricas que se envían a los destinos definidos en la configuración. Las categorías disponibles varían para los distintos tipos de recursos.
- Uno o más destinos para enviar los registros. Los destinos actuales incluyen el área de trabajo de Log Analytics, Event Hubs y Azure Storage.
- Cada configuración de diagnóstico puede definir un único destino. Si desea enviar datos a más de un tipo de destino determinado (por ejemplo, dos áreas de trabajo de Log Analytics diferentes), cree varias configuraciones. Cada recurso puede tener hasta cinco configuraciones de diagnóstico.
Importante
Debe habilitar una configuración de diagnóstico en Azure Monitor para enviar los datos de registro de las encuestas a un área de trabajo de Log Analytics, Event Hubs o una cuenta de Azure Storage para recibir y analizar los datos de la encuesta. Si no envía datos de automatización de llamadas a una de estas opciones, los datos de la encuesta no se almacenarán y se perderán Las siguientes son instrucciones para configurar el recurso de Azure Monitor para empezar a crear registros y métricas para Communications Services. Para obtener documentación detallada sobre el uso de diagnóstico Configuración en todos los recursos de Azure, consulte: Habilitación del registro en Diagnóstico Configuración
Nota:
En el nombre de la configuración de diagnóstico, seleccione "Registros de actualización del estado de entrega del servicio de correo electrónico", "Registros de interacción de usuario del servicio de correo electrónico" para habilitar los registros de los correos electrónicos.
Categorías del registro de recursos
Communication Services ofrece los siguientes tipos de registros que se pueden habilitar:
- Usage logs (Registros de uso): proporciona datos de uso asociados a cada oferta de servicio facturada.
- Registros operativos de envío de correo electrónico: Proporciona información detallada relacionada con las solicitudes de correo de envío del servicio Correo electrónico.
- Registros operativos de actualización de estado de correo electrónico: Proporciona actualizaciones del estado de entrega a nivel de mensajes y destinatarios, relacionadas con las solicitudes de correo de envío del servicio Correo electrónico.
- Registros operativos de involucración del usuario de correo electrónico: Proporciona información relacionada con las métricas de interacción del usuario de "apertura" y "clic" para los mensajes enviados desde el servicio Correo electrónico.
Esquema de los registros de uso
Propiedad | Descripción |
---|---|
Timestamp |
Marca de tiempo (UTC) de cuando se generó el registro. |
Operation Name |
Operación asociada al registro. |
Operation Version |
api-version asociada con la operación, si operationName se ha realizado mediante una API. Si no hay ninguna API que corresponda a esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas a la operación cambien en el futuro. |
Category |
Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos. |
Correlation ID |
Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas. |
Properties |
Otros datos aplicables a distintos modos de Communication Services. |
Record ID |
Identificador único de un registro de uso determinado. |
Usage Type |
Modo de uso. (Por ejemplo, chat, RTC, NAT, etc.). |
Unit Type |
Tipo de unidad que se emplea para el uso en un modo determinado. (Por ejemplo, minutos, megabytes, mensajes, etc.). |
Quantity |
Número de unidades usadas o consumidas en este registro. |
Registros operativos de envío de correo electrónico
Los registros operativos de envío de correo electrónico proporcionan información valiosa sobre las tendencias de solicitudes de API a lo largo del tiempo. Estos datos le ayudan a detectar análisis de correo electrónico clave, como el número total de correos electrónicos enviados, el tamaño del correo electrónico y el número de correos electrónicos con datos adjuntos. Esta información se puede analizar rápidamente casi en tiempo real y visualizarse de forma fácil de usar para ayudar a impulsar una mejor toma de decisiones.
Propiedad | Descripción |
---|---|
TimeGenerated |
Marca de tiempo (UTC) de cuando se generó el registro. |
Location |
Región donde se procesó la operación. |
OperationName |
Operación asociada al registro. |
OperationVersion |
api-version asociada con la operación, si operationName se realizó mediante una API. Si no hay ninguna API que corresponda a esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas a la operación cambien en el futuro. |
Category |
Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos. |
CorrelationID |
Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas. Para todos los registros operativos de correo electrónico, correlationId se asigna a MessageId, que se devuelve de una solicitud SendMail correcta. |
Size |
Representa el tamaño total del cuerpo del correo electrónico, el asunto, los encabezados y los datos adjuntos en megabytes. |
ToRecipientsCount |
Número total de direcciones de correo electrónico únicas en la línea A. |
CcRecipientsCount |
Número total de direcciones de correo electrónico únicas en la línea Cc. |
BccRecipientsCount |
Número total de direcciones de correo electrónico únicas en la línea Bcc. |
UniqueRecipientsCount |
Este es el recuento total de destinatarios desduplicados para los campos de dirección To, Cc y Bcc. |
AttachmentsCount |
Número total de archivos adjuntos. |
TrafficSource |
Nombre del cliente desde el que se originó la solicitud de correo electrónico. |
Muestras
{
"OperationType":"SendMail",
"OperationCategory":"EmailSendMailOperational",
"Size":0.026019,
"ToRecipientsCount":2,
"CcRecipientsCount":3,
"BccRecipientsCount":1,
"UniqueRecipientsCount":6,
"AttachmentsCount":0,
"TrafficSource":"Email .NET SDK"
}
Registros operativos de actualización de estado de correo electrónico
Los registros operativos de actualización de estado de correo electrónico proporcionan información detallada sobre las actualizaciones de estado de entrega del nivel de mensaje y destinatario en las solicitudes de la API de sendmail. Estos registros ofrecen detalles específicos del mensaje, como el tiempo de entrega, así como los detalles de nivel de destinatario, como las direcciones de correo electrónico y las actualizaciones de estado de entrega. Al realizar un seguimiento de estos registros, puede garantizar una visibilidad completa del proceso de entrega de correo electrónico, identificando rápidamente los problemas que puedan surgir y tomando medidas correctivas según sea necesario.
Propiedad | Descripción |
---|---|
TimeGenerated |
Marca de tiempo (UTC) de cuando se generó el registro. |
Location |
Región donde se procesó la operación. |
OperationName |
Operación asociada al registro. |
OperationVersion |
api-version asociada con la operación, si operationName se realizó mediante una API. Si no hay ninguna API que corresponda a esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas a la operación cambien en el futuro. |
Category |
Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos. |
CorrelationID |
Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas. Para todos los registros operativos de correo electrónico, correlationId se asigna a MessageId, que se devuelve de una solicitud SendMail correcta. |
RecipientId |
Dirección de correo electrónico del destinatario. Si se trata de un evento a nivel de mensaje, la propiedad estará vacía. |
DeliveryStatus |
Estado del terminal del mensaje. |
SmtpStatusCode |
Código de estado SMTP devuelto desde el servidor de correo electrónico del destinatario en respuesta a una solicitud de envío de correo. |
EnhancedSmtpStatusCode |
Código de estado SMTP mejorado devuelto desde el servidor de correo electrónico del destinatario. |
SenderDomain |
La parte del dominio del SenderAddress usado en el envío de correos electrónicos. |
SenderUsername |
La parte de nombre de usuario de SenderAddress usada en el envío de correos electrónicos. |
IsHardBounce |
Indica si un error de entrega se debe a un problema permanente o temporal. IsHardBounce == true significa un problema de buzón permanente que impide que se entreguen correos electrónicos. |
Muestras
{
"OperationType":"DeliveryStatusUpdate",
"OperationCategory":"EmailStatusUpdateOperational",
"RecipientId":"user@email.com",
"DeliveryStatus":"Delivered",
"SenderDomain":"contoso.com",
"SenderUsername":"donotreply",
"IsHardBounce":false
}
Registros operativos de involucración del usuario de correo electrónico
Los registros operativos de involucración de usuarios de correo electrónico proporcionan información sobre las tendencias de compromiso de correo electrónico para su sistema de correo electrónico. Estos datos le ayudan a realizar un seguimiento y analizar las métricas clave de correo electrónico, como las tasas de apertura, las tasas de clic a través y las tarifas de cancelación de la suscripción. Estos registros se pueden almacenar y analizar, lo que le permite obtener información más detallada sobre el rendimiento del sistema de correo electrónico y adaptar su estrategia en consecuencia. En general, los registros operativos de Email User Engagement proporcionan una herramienta eficaz para mejorar el rendimiento del sistema de correo electrónico, medir y optimizar proactivamente las campañas de correo electrónico y mejorar la interacción del usuario con el tiempo.
Propiedad | Descripción |
---|---|
TimeGenerated |
Marca de tiempo (UTC) de cuando se generó el registro. |
Location |
Región donde se procesó la operación. |
OperationName |
Operación asociada al registro. |
OperationVersion |
api-version asociada con la operación, si operationName se realizó mediante una API. Si no hay ninguna API que corresponda a esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas a la operación cambien en el futuro. |
Category |
Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos. |
CorrelationID |
Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas. Para todos los registros operativos de correo electrónico, correlationId se asigna a MessageId, que se devuelve de una solicitud SendMail correcta. |
RecipientId |
Dirección de correo electrónico del destinatario. Si se trata de un evento a nivel de mensaje, la propiedad estará vacía. |
EngagementType |
Tipo de evento que se supervisa. |
EngagementContext |
Contexto representa con lo que el usuario ha interactuado. |
UserAgent |
Cadena de agente de usuario del cliente. |
Muestras
{
"OperationType": "UserEngagementUpdate",
"OperationCategory": "EmailUserEngagementOperational",
"EngagementType": "View",
"UserAgent": "Mozilla/5.0"
}
{
"OperationType":"UserEngagementUpdate",
"OperationCategory":"EmailUserEngagementOperational",
"EngagementType":"Click",
"EngagementContext":"https://www.contoso.com/support?id=12345",
"UserAgent":"Mozilla/5.0"
}