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

Azure Communications Services bietet Überwachungs- und Analysefeatures über Azure Monitor-Protokolle – Übersicht 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 finden Sie Anweisungen zum Konfigurieren Ihrer Azure Monitor-Ressource zum Erstellen von Protokollen und Metriken für Ihre Kommunikationsdienste. Ausführliche Dokumentation zur Verwendung von Diagnose-Einstellungen in allen Azure-Ressourcen finden Sie unter: Aktivieren der Protokollierung in Diagnostic Einstellungen

Hinweis

Wählen Sie unter dem Namen der Diagnoseeinstellung "E-Mail-Übermittlungsstatusaktualisierungsprotokolle", "E-Mail-Dienst senden E-Mail-Protokolle", "E-Mail-Benutzerbindungsprotokolle" 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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category	Die Protokollkategorie des Ereignisses. Die Kategorie ist die Granularität, 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

E-Mail-Sende-E-Mail-Betriebsprotokolle liefern wertvolle Einblicke in API-Anforderungstrends im Laufe der Zeit. Mit diesen Daten können Sie wichtige E-Mail-Analysen ermitteln, z. B. die Gesamtzahl der gesendeten E-Mails, die E-Mail-Größe und die Anzahl der E-Mails mit Anlagen. Diese Informationen können schnell in Nahezu-Echtzeit analysiert und auf benutzerfreundliche Weise dargestellt werden, um eine bessere Entscheidungsfindung zu erzielen.

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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category	Die Protokollkategorie des Ereignisses. Die Kategorie ist die Granularität, 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 des E-Mail-Textkörpers, betreffs, Kopfzeilen und Anlagen in Megabyte 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 Gesamtzahl der Empfänger 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

E-Mail-Statusaktualisierungs-Betriebsprotokolle bieten detaillierte Einblicke in Statusaktualisierungen auf Nachrichten- und Empfängerebene für Ihre Sendmail-API-Anforderungen. Diese Protokolle bieten nachrichtenspezifische Details, z. B. die Übermittlungszeit, sowie Details auf Empfängerebene, z. B. E-Mail-Adressen und Aktualisierungen des Zustellungsstatus. Indem Sie diese Protokolle nachverfolgen, können Sie einen vollständigen Einblick in Ihren E-Mail-Zustellungsprozess gewährleisten, um probleme schnell zu identifizieren, die bei Bedarf auftreten und Korrekturmaßnahmen ergreifen können.

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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category	Die Protokollkategorie des Ereignisses. Die Kategorie ist die Granularität, 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.
DeliveryStatus	Der Terminalstatus der Nachricht.
SmtpStatusCode	SMTP-Statuscode, der vom E-Mail-Server des Empfängers als Reaktion auf eine E-Mail-Anforderung zurückgegeben wird.
EnhancedSmtpStatusCode	Erweiterter SMTP-Statuscode, der vom E-Mail-Server des Empfängers zurückgegeben wird.
SenderDomain	Der Do Standard Teil der SenderAddress, der beim Senden von E-Mails verwendet wird.
SenderUsername	Der Benutzernamenteil der SenderAddress, der beim Senden von E-Mails verwendet wird.
IsHardBounce	Gibt an, ob ein Zustellungsfehler auf ein dauerhaftes oder temporäres Problem zurückzuführen war. IsHardBounce == true bedeutet ein dauerhaftes Postfachproblem, das verhindert, dass E-Mails zugestellt werden.

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 die E-Mail-Benutzerbindung bieten Einblicke in E-Mail-Engagement-Trends für Ihr E-Mail-System. Diese Daten helfen Ihnen, wichtige E-Mail-Metriken wie Öffnungsraten, Klickraten und Abonnementraten nachzuverfolgen und zu analysieren. Diese Protokolle können gespeichert und analysiert werden, sodass Sie tiefere Einblicke in die Leistung Ihres E-Mail-Systems erhalten und Ihre Strategie entsprechend anpassen können. Insgesamt bieten E-Mail User Engagement-Betriebsprotokolle ein leistungsfähiges Tool zur Verbesserung der Leistung Ihres E-Mail-Systems, proaktives Messen und Optimieren Ihrer E-Mail-Kampagnen und zur Verbesserung des Benutzereinsatzes 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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
Category	Die Protokollkategorie des Ereignisses. Die Kategorie ist die Granularität, 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"
}