Dzienniki poczty e-mail usług Azure Communication Services

Usługi Azure Communication Services oferują funkcje rejestrowania, których można użyć do monitorowania i debugowania rozwiązania usług Komunikacyjnych. Te możliwości można skonfigurować za pośrednictwem witryny Azure Portal.

Wymagania wstępne

Usługi Azure Communications Services udostępniają funkcje monitorowania i analizy za pośrednictwem przeglądu dzienników usługi Azure Monitor i metryk usługi Azure Monitor. Każdy zasób platformy Azure wymaga własnego ustawienia diagnostycznego, które definiuje następujące kryteria:

• Kategorie dzienników i danych metryk wysyłanych do miejsc docelowych zdefiniowanych w ustawieniu. Dostępne kategorie różnią się w zależności od różnych typów zasobów.
• Co najmniej jedno miejsce docelowe do wysyłania dzienników. Bieżące miejsca docelowe obejmują obszar roboczy usługi Log Analytics, usługę Event Hubs i usługę Azure Storage.
• Jedno ustawienie diagnostyczne może definiować nie więcej niż jedno z miejsc docelowych. Jeśli chcesz wysłać dane do więcej niż jednego z określonego typu docelowego (na przykład dwóch różnych obszarów roboczych usługi Log Analytics), utwórz wiele ustawień. Każdy zasób może mieć maksymalnie pięć ustawień diagnostycznych.

Ważne

Należy włączyć ustawienie diagnostyczne w usłudze Azure Monitor, aby wysyłać dane dziennika ankiet do obszaru roboczego usługi Log Analytics, usługi Event Hubs lub konta usługi Azure Storage w celu odbierania i analizowania danych ankiety. Jeśli nie wyślesz danych automatyzacji wywołań do jednej z tych opcji, dane ankiety nie będą przechowywane i zostaną utracone Następujące instrukcje dotyczące konfigurowania zasobu usługi Azure Monitor w celu rozpoczęcia tworzenia dzienników i metryk dla usług Communications Services. Aby uzyskać szczegółową dokumentację dotyczącą używania ustawień diagnostycznych we wszystkich zasobach platformy Azure, zobacz: Włączanie rejestrowania w ustawieniach diagnostycznych

Uwaga

W obszarze nazwa ustawienia diagnostycznego wybierz pozycję "Dzienniki aktualizacji stanu dostarczania usługi poczty e-mail", "Dzienniki aktywności użytkownika usługi poczty e-mail", aby włączyć dzienniki wiadomości e-mail dla wiadomości e-mail

Kategorie dzienników zasobów

Usługi komunikacyjne oferują następujące typy dzienników, które można włączyć:

• Dzienniki użycia — udostępnia dane użycia skojarzone z każdą ofertą rozliczanej usługi
• Dzienniki operacyjne Wyślij pocztę e-mail — zawiera szczegółowe informacje dotyczące żądań wysyłania wiadomości e-mail przez usługę poczty e-mail.
• Dzienniki operacyjne aktualizacji stanu wiadomości e-mail — udostępnia aktualizacje stanu dostarczania na poziomie wiadomości i adresata związane z żądaniami wysyłania wiadomości e-mail przez usługę poczty e-mail.
• Dzienniki operacyjne zaangażowania użytkowników poczty e-mail — zawiera informacje dotyczące metryk zaangażowania użytkownika "otwórz" i "kliknij" dla wiadomości wysyłanych z usługi poczty e-mail.

Schemat dzienników użycia

Właściwości	opis
Timestamp	Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
Operation Name	Operacja skojarzona z rekordem dziennika.
Operation Version	Skojarzony api-version z operacją, jeśli operacja operationName została wykonana przy użyciu interfejsu API. Jeśli nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli właściwości skojarzone ze zmianą operacji w przyszłości.
Category	Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości wyświetlane we właściwościach obiektu blob zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
Correlation ID	Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami.
Properties	Inne dane dotyczące różnych trybów usług komunikacyjnych.
Record ID	Unikatowy identyfikator dla danego rekordu użycia.
Usage Type	Tryb użycia. (na przykład Czat, PSTN, NAT itp.)
Unit Type	Typ jednostki, która jest oparta na danym trybie użycia. (na przykład minuty, megabajty, komunikaty itp.).
Quantity	Liczba jednostek używanych lub używanych dla tego rekordu.

Wysyłanie dzienników operacyjnych poczty e-mail

Dzienniki operacyjne wyślij pocztę e-mail zapewniają cenny wgląd w trendy żądań interfejsu API w czasie. Te dane ułatwiają odnajdywanie kluczowych analiz poczty e-mail, takich jak łączna liczba wysłanych wiadomości e-mail, rozmiar wiadomości e-mail i liczba wiadomości e-mail z załącznikami. Te informacje można szybko analizować w czasie niemal rzeczywistym i wizualizować w przyjazny dla użytkownika sposób, aby ułatwić podejmowanie lepszych decyzji.

Właściwości	opis
TimeGenerated	Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
Location	Region, w którym została przetworzona operacja.
OperationName	Operacja skojarzona z rekordem dziennika.
OperationVersion	Skojarzony api-version z operacją, jeśli operationName został wykonany przy użyciu interfejsu API. Jeśli nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli właściwości skojarzone ze zmianą operacji w przyszłości.
Category	Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości wyświetlane we właściwościach obiektu blob zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
CorrelationID	Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami. Dla wszystkich dzienników operacyjnych Poczta e-mail identyfikator CorrelationId jest mapowany na identyfikator MessageId, który jest zwracany z pomyślnego żądania SendMail.
Size	Reprezentuje całkowity rozmiar treści wiadomości e-mail, tematu, nagłówków i załączników w megabajtach.
ToRecipientsCount	Całkowita liczba unikatowych adresów e-mail w wierszu Do.
CcRecipientsCount	Całkowita liczba unikatowych adresów e-mail w wierszu DW.
BccRecipientsCount	Całkowita liczba unikatowych adresów e-mail w wierszu UDW.
UniqueRecipientsCount	Jest to deduplikowana całkowita liczba adresatów dla pól adresów Do, DW i BCC.
AttachmentsCount	Całkowita liczba załączników.
TrafficSource	Nazwa klienta, z którego pochodzi żądanie e-mail.

Samples

{
  "OperationType":"SendMail", 
  "OperationCategory":"EmailSendMailOperational",
  "Size":0.026019,
  "ToRecipientsCount":2,
  "CcRecipientsCount":3, 
  "BccRecipientsCount":1, 
  "UniqueRecipientsCount":6, 
  "AttachmentsCount":0,
  "TrafficSource":"Email .NET SDK"
}

Dzienniki operacyjne aktualizacji stanu poczty e-mail

Dzienniki operacyjne aktualizacji stanu poczty e-mail zapewniają szczegółowe informacje na temat aktualizacji stanu dostarczania na poziomie komunikatów i adresatów w żądaniach interfejsu API wysyłania poczty e-mail.

• Aktualizacje stanu na poziomie komunikatu zapewniają stan długotrwałej operacji wysyłania wiadomości e-mail (podobnie jak aktualizacje stanu otrzymywane za pośrednictwem wywoływania naszych interfejsów API GET). Są one oznaczone brakiem RecipientId właściwości, ponieważ te aktualizacje dotyczą całej wiadomości i nie mają zastosowania do określonego adresata w tym żądaniu wiadomości. DeliveryStatus właściwość zawiera stan dostarczania na poziomie komunikatu. Możliwe wartości dla DeliveryStatus tego typu zdarzenia to Dropped, OutForDeliveryi Queued.
• Aktualizacje stanu adresata zapewniają stan dostarczania wiadomości e-mail dla każdego indywidualnego adresata, do którego wysłano wiadomość e-mail w jednej wiadomości. Zawierają RecipientId one właściwość z adresem e-mail odbiorcy. Stan dostarczania na poziomie odbiorcy jest udostępniany we DeliveryStatus właściwości . Możliwe wartości dla DeliveryStatus tego typu zdarzenia to Delivered, , Expanded, FailedQuarantined, , FilteredSpam, Suppressed, i Bounced. Śledząc te dzienniki, możesz zapewnić pełny wgląd w proces dostarczania poczty e-mail, szybko identyfikując wszelkie problemy, które mogą wystąpić i podejmując odpowiednie działania naprawcze.

Właściwości	opis
TimeGenerated	Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
Location	Region, w którym została przetworzona operacja.
OperationName	Operacja skojarzona z rekordem dziennika.
OperationVersion	Skojarzony api-version z operacją, jeśli operationName został wykonany przy użyciu interfejsu API. Jeśli nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli właściwości skojarzone ze zmianą operacji w przyszłości.
Category	Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości wyświetlane we właściwościach obiektu blob zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
CorrelationID	Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami. Dla wszystkich dzienników operacyjnych Poczta e-mail identyfikator CorrelationId jest mapowany na identyfikator MessageId, który jest zwracany z pomyślnego żądania SendMail.
RecipientId	Adres e-mail docelowego adresata. Jest on obecny tylko w przypadku zdarzeń na poziomie adresata. Jeśli jest to zdarzenie na poziomie komunikatu, właściwość będzie pusta.
DeliveryStatus	Stan terminalu komunikatu. Możliwe wartości dla zdarzenia na poziomie komunikatów to: Dropped, OutForDelivery, Queued. Możliwe wartości dla zdarzenia na poziomie odbiorcy to: Delivered, , Expanded, FailedQuarantined, FilteredSpam, , . SuppressedBounced
SmtpStatusCode	Kod stanu SMTP zwrócony z serwera poczty e-mail adresata w odpowiedzi na żądanie wysyłania wiadomości e-mail.
EnhancedSmtpStatusCode	Rozszerzony kod stanu SMTP zwrócony z serwera poczty e-mail adresata.
SenderDomain	Część domeny SenderAddress używana podczas wysyłania wiadomości e-mail.
SenderUsername	Część nazwy użytkownika elementu SenderAddress używana podczas wysyłania wiadomości e-mail.
IsHardBounce	Określa, czy niepowodzenie dostarczania było spowodowane trwałym lub tymczasowym problemem. IsHardBounce == true oznacza stały problem ze skrzynką pocztową uniemożliwiający dostarczanie wiadomości e-mail.

Samples

{
  "OperationType":"DeliveryStatusUpdate", 
  "OperationCategory":"EmailStatusUpdateOperational", 
  "RecipientId":"user@email.com", 
  "DeliveryStatus":"Delivered", 
  "SenderDomain":"contoso.com", 
  "SenderUsername":"donotreply", 
  "IsHardBounce":false
}

Dzienniki operacyjne zaangażowania użytkowników poczty e-mail

Dzienniki operacyjne zaangażowania użytkowników e-mail zapewniają wgląd w trendy zaangażowania w wiadomości e-mail dla systemu poczty e-mail. Te dane ułatwiają śledzenie i analizowanie kluczowych metryk poczty e-mail, takich jak stawki otwarcia, stawki kliknięć i stawki anulowania subskrypcji. Te dzienniki można przechowywać i analizować, co pozwala uzyskać bardziej szczegółowy wgląd w wydajność systemu poczty e-mail i odpowiednio dostosować strategię. Ogólnie rzecz biorąc, dzienniki operacyjne usługi Email User Engagement zapewniają zaawansowane narzędzie do poprawy wydajności systemu poczty e-mail, proaktywnego mierzenia i optymalizowania kampanii e-mail oraz poprawy zaangażowania użytkowników w czasie.

Właściwości	opis
TimeGenerated	Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
Location	Region, w którym została przetworzona operacja.
OperationName	Operacja skojarzona z rekordem dziennika.
OperationVersion	Skojarzony api-version z operacją, jeśli operationName został wykonany przy użyciu interfejsu API. Jeśli nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli właściwości skojarzone ze zmianą operacji w przyszłości.
Category	Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości wyświetlane we właściwościach obiektu blob zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
CorrelationID	Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami. Dla wszystkich dzienników operacyjnych Poczta e-mail identyfikator CorrelationId jest mapowany na identyfikator MessageId, który jest zwracany z pomyślnego żądania SendMail.
RecipientId	Adres e-mail docelowego adresata. Jeśli jest to zdarzenie na poziomie komunikatu, właściwość będzie pusta.
EngagementType	Typ śledzonego zaangażowania użytkowników.
EngagementContext	Kontekst reprezentuje, z czym użytkownik wchodził w interakcję.
UserAgent	Ciąg agenta użytkownika z klienta.

Samples

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