Azure Communication Services: E-Mail-Protokolle

Azure Communication Services bietet Protokollierungsfunktionen, mit denen Sie Ihre Communication Services-Lösung überwachen und debuggen können. Diese Funktionen können über das Azure-Portal konfiguriert werden.

Voraussetzungen

Communications Services bietet Überwachungs- und Analysefunktionen über die Übersicht über Azure Monitor-Protokolle und Azure Monitor-Metriken. Jede Azure-Ressource erfordert eine eigene Diagnoseeinstellung, die folgende Kriterien definiert:

• Kategorien der Protokolle und Metrikdaten, die an die in der Einstellung definierten Ziele gesendet werden. Die verfügbaren Kategorien sind je nach Ressourcentyp verschieden.
• Ein oder mehrere Ziele zum Senden der Protokolle. Zu den aktuellen Zielen gehören der Log Analytics-Arbeitsbereich, Event Hubs und Azure Storage.
• Mit einer einzelnen Diagnoseeinstellung kann maximal eines der Ziele definiert werden. Wenn Sie Daten an mehrere Ziele eines bestimmten Typs senden möchten (z.B. zwei verschiedene Log Analytics-Arbeitsbereiche), dann erstellen Sie mehrere Einstellungen. Jede Ressource kann bis zu fünf Diagnoseeinstellungen haben.

Wichtig

Sie müssen eine Diagnoseeinstellung in Azure Monitor aktivieren, um die Protokolldaten Ihrer Umfragen an einen Log Analytics-Arbeitsbereich, Event Hubs oder ein Azure-Speicherkonto zu senden, um Ihre Umfragedaten zu empfangen und zu analysieren. Wenn Sie keine Anrufautomatisierungsdaten an eine dieser Optionen senden, werden Ihre Umfragedaten nicht gespeichert und gehen verloren. Im Folgenden wird beschrieben, wie Sie Ihre Azure Monitor-Ressource konfigurieren, um mit der Erstellung von Protokollen und Metriken für Ihre Azure Communication Services-Instanz zu beginnen. Eine ausführliche Dokumentation zur Verwendung von Diagnoseeinstellungen für alle Azure-Ressourcen finden Sie unter Aktivieren der Protokollierung in den Diagnoseeinstellungen.

Hinweis

Wählen Sie unter dem Namen der Diagnoseeinstellung die Optionen „Protokolle mit Statusupdates bei der Zustellung durch den E-Mail-Dienst“, „Protokolle zu vom E-Mail-Dienst gesendeten E-Mails“ und „Protokolle zur Benutzerbindung für den E-Mail-Dienst“ aus, um die Protokolle für E-Mails zu aktivieren.

Ressourcenprotokollkategorien

Communication Services bietet die folgenden Protokolltypen, die Sie aktivieren können:

• Nutzungsprotokolle – Stellt Nutzungsdaten bereit, die den einzelnen abgerechneten Dienstangeboten zugeordnet sind.
• E-Mail senden Mail-Betriebsprotokolle - bietet detaillierte Informationen im Zusammenhang mit dem E-Mail-Dienst Senden von E-Mail-Anforderungen.
• Betriebsprotokolle für E-Mail-Statusaktualisierungen - stellt Nachrichten- und Empfängerstatusupdates im Zusammenhang mit dem E-Mail-Dienst Senden von E-Mail-Anforderungen bereit.
• Betriebsprotokolle für E-Mail-Benutzerbindung - stellt Informationen im Zusammenhang mit ‚öffnen‘ und ‚Klicken‘ bei Benutzer-Engagement-Metriken für Nachrichten bereit, die vom E-Mail-Dienst gesendet werden.

Schema für Nutzungsprotokolle

Eigenschaft	Beschreibung
Timestamp	Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Operation Name	Der mit der Protokollaufzeichnung verbundene Vorgang.
Operation Version	Die api-version, die dem Vorgang zugeordnet ist, wenn für „operationName“ eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category	Die Protokollkategorie des Ereignisses. Die category-Eigenschaft gibt die Granularität an, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
Correlation ID	Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
Properties	Andere Daten, die auf verschiedene Communication Services-Modi anwendbar sind.
Record ID	Die eindeutige ID für einen angegebenen Nutzungsdatensatz.
Usage Type	Die Art der Nutzung. (Beispiel: Chat, PSTN, NAT usw.)
Unit Type	Der Typ der Einheit, auf dem die Nutzung für eine bestimmte Nutzungsart basiert. (Beispiel Minuten, Megabyte, Nachrichten usw.)
Quantity	Die Anzahl der für diesen Datensatz verwendeten oder verbrauchten Einheiten.

E-Mail senden Betriebsprotokolle

Betriebsprotokolle für E-Mail-Versand bietet wertvolle Einblicke in API-Anforderungstrends im Laufe der Zeit. Diese Daten liefern wichtige E-Mail-Analysen, z. B. die Gesamtanzahl gesendeter E-Mails, die E-Mail-Größe und die Anzahl von E-Mails mit Anlagen. Diese Informationen können schnell in Quasi-Echtzeit analysiert und auf benutzerfreundliche Weise dargestellt werden, um eine bessere Entscheidungsfindung zu ermöglichen.

Eigenschaft	Beschreibung
TimeGenerated	Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Location	Der Bereich, in dem der Vorgang verarbeitet wurde.
OperationName	Der mit der Protokollaufzeichnung verbundene Vorgang
OperationVersion	Die api-version, die dem Vorgang zugeordnet ist, wenn für operationName eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category	Die Protokollkategorie des Ereignisses. Die category-Eigenschaft gibt die Granularität an, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
CorrelationID	Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren. Für alle E-Mail-Betriebsprotokolle wird die CorrelationId der MessageId zugeordnet, die von einer erfolgreichen SendMail-Anforderung zurückgegeben wird.
Size	Stellt die Gesamtgröße in Megabyte des E-Mail-Texts, des Betreffs, der Kopfzeilen und der Anlagen dar.
ToRecipientsCount	Die Gesamtzahl der eindeutigen E-Mail-Adressen in der Zeile An.
CcRecipientsCount	Die Gesamtzahl der eindeutigen E-Mail-Adressen in der Zeile Cc.
BccRecipientsCount	Die Gesamtzahl der eindeutigen E-Mail-Adressen in der Zeile Bcc.
UniqueRecipientsCount	Dies ist die deduplizierte Gesamtempfängeranzahl für die Felder „An“, „Cc“ und „Bcc“.
AttachmentsCount	Die Gesamtzahl der Anlagen.
TrafficSource	Der Name des Clients, von dem die E-Mail-Anforderung stammt.

Beispiele

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

Betriebsprotokolle des E-Mail-Statusupdates

Betriebsprotokolle für E-Mail-Statusaktualisierungen liefern detaillierte Erkenntnisse zu Aktualisierungen des Zustellungsstatus auf Nachrichten- und Empfängerebene für Ihre sendmail-API-Anforderungen.

• Statusaktualisierungen auf Nachrichtenebene stellen den Status eines zeitintensiven E-Mail-Sendevorgangs bereit (ähnlich wie die Statusaktualisierungen, die Sie über den Aufruf der GET-APIs erhalten). Sie zeichnen sich durch das Fehlen der RecipientId-Eigenschaft aus, da diese Aktualisierungen für die gesamte Nachricht gelten und nicht für einen bestimmten Empfänger in der Nachrichtenanforderung. Die DeliveryStatus-Eigenschaft enthält den Zustellungsstatus auf Nachrichtenebene. Mögliche Werte für DeliveryStatus für diesen Ereignistyp sind Dropped, OutForDelivery und Queued.
• Statusaktualisierungen auf Empfängerebene stellen den Status der E-Mail-Zustellung für jeden einzelnen Empfänger bereit, an den die E-Mail in einer einzelnen Nachricht gesendet wurde. Sie enthalten eine RecipientId-Eigenschaft mit der E-Mail-Adresse des Empfängers. Der Zustellungsstatus auf Empfängerebene wird in der DeliveryStatus-Eigenschaft bereitgestellt. Mögliche Werte für DeliveryStatus für diesen Ereignistyp sind Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressed und Bounced. Indem Sie diese Protokolle nachverfolgen, können Sie die vollständige Sichtbarkeit Ihres E-Mail-Zustellungsprozesses gewährleisten, um Probleme schnell zu identifizieren und bei Bedarf Korrekturmaßnahmen zu ergreifen.

Eigenschaft	Beschreibung
TimeGenerated	Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Location	Der Bereich, in dem der Vorgang verarbeitet wurde.
OperationName	Der mit der Protokollaufzeichnung verbundene Vorgang
OperationVersion	Die api-version, die dem Vorgang zugeordnet ist, wenn für operationName eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category	Die Protokollkategorie des Ereignisses. Die category-Eigenschaft gibt die Granularität an, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
CorrelationID	Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren. Für alle E-Mail-Betriebsprotokolle wird die CorrelationId der MessageId zugeordnet, die von einer erfolgreichen SendMail-Anforderung zurückgegeben wird.
RecipientId	Die E-Mail-Adresse für den Zielempfänger. Sie ist nur für Ereignisse auf Empfängerebene vorhanden. Wenn dies ein Ereignis auf Nachrichtenebene ist, ist die Eigenschaft leer.
DeliveryStatus	Der Terminalstatus der Nachricht. Mögliche Werte für Ereignisse auf Nachrichtenebene sind Dropped, OutForDelivery und Queued. Mögliche Werte für Ereignisse auf Empfängerebene sind Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressed und Bounced.
SmtpStatusCode	Der SMTP-Statuscode (Simple Mail Transfer Protocol), der vom E-Mail-Server des Empfängers als Antwort auf eine E-Mail-Anforderung zurückgegeben wird.
EnhancedSmtpStatusCode	Ein erweiterter SMTP-Statuscode, der vom E-Mail-Server des Empfängers zurückgegeben wird.
SenderDomain	Der Domänenteil der E-Mail-Adresse des Absenders (SenderAddress), der beim Senden von E-Mails verwendet wird.
SenderUsername	Der Benutzernamenteil der E-Mail-Adresse des Absenders (SenderAddress), der beim Senden von E-Mails verwendet wird.
IsHardBounce	Gibt an, ob ein Zustellungsfehler auf ein dauerhaftes oder ein temporäres Problem zurückzuführen war. „IsHardBounce == true“ bedeutet, dass ein dauerhaftes Postfachproblem vorliegt, aufgrund dessen E-Mails nicht zugestellt werden können.

Beispiele

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

Betriebsprotokolle für E-Mail-Benutzerbindung

Betriebsprotokolle für E-Mail-Benutzerbindung liefern Erkenntnisse zu Trends bei der E-Mail-Nachverfolgung für Ihr E-Mail-System. Mithilfe dieser Daten können Sie wichtige E-Mail-Metriken wie Öffnungsraten, Durchklickraten und Abonnementkündigungsraten nachverfolgen und analysieren. Diese Protokolle können gespeichert und analysiert werden, sodass Sie tiefere Erkenntnisse zur Leistung Ihres E-Mail-Systems erhalten und Ihre Strategie entsprechend anpassen können. Insgesamt sind Betriebsprotokolle für die E-Mail-Benutzerbindung ein leistungsfähiges Tool zum Verbessern der Leistung Ihres E-Mail-Systems, Durchführen proaktiver Messungen, Optimieren Ihrer E-Mail-Kampagnen und Verbessern der Bindung im Laufe der Zeit.

Eigenschaft	Beschreibung
TimeGenerated	Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Location	Der Bereich, in dem der Vorgang verarbeitet wurde.
OperationName	Der mit der Protokollaufzeichnung verbundene Vorgang
OperationVersion	Die api-version, die dem Vorgang zugeordnet ist, wenn für operationName eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category	Die Protokollkategorie des Ereignisses. Die category-Eigenschaft gibt die Granularität an, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
CorrelationID	Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren. Für alle E-Mail-Betriebsprotokolle wird die CorrelationId der MessageId zugeordnet, die von einer erfolgreichen SendMail-Anforderung zurückgegeben wird.
RecipientId	Die E-Mail-Adresse für den Zielempfänger. Wenn dies ein Ereignis auf Nachrichtenebene ist, ist die Eigenschaft leer.
EngagementType	Der Typ der Kundenbindung, der nachverfolgt wird.
EngagementContext	Der Kontext stellt dar, mit wem der Benutzer interagiert hat.
UserAgent	Die Benutzer-Agent-Zeichenfolge vom Client.

Beispiele

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