E-maillogboeken van Azure Communication Services

Azure Communication Services biedt mogelijkheden voor logboekregistratie die u kunt gebruiken om uw Communication Services-oplossing te bewaken en fouten op te sporen. Deze mogelijkheden kunnen worden geconfigureerd via de Azure Portal.

Vereisten

Azure Communications Services biedt bewakings- en analysefuncties via het overzicht van Azure Monitor-logboeken en metrische gegevens van Azure Monitor. Voor elke Azure-resource is een eigen diagnostische instelling vereist, die de volgende criteria definieert:

• Categorieën logboeken en metrische gegevens die worden verzonden naar de bestemmingen die in de instelling zijn gedefinieerd. De beschikbare categorieën variëren voor verschillende resourcetypen.
• Een of meer bestemmingen voor de logboeken. Huidige bestemmingen omvatten Log Analytics-werkruimte, Event Hubs en Azure Storage.
• Eén diagnostische instelling kan niet meer dan één van de bestemmingen definiëren. Als u gegevens wilt verzenden naar meer dan een van een bepaald doeltype (bijvoorbeeld twee verschillende Log Analytics-werkruimten), maakt u meerdere instellingen. Elke resource kan maximaal vijf diagnostische instellingen hebben.

Belangrijk

U moet een diagnostische instelling in Azure Monitor inschakelen om de logboekgegevens van uw enquêtes te verzenden naar een Log Analytics-werkruimte, Event Hubs of een Azure-opslagaccount om uw enquêtegegevens te ontvangen en te analyseren. Als u geen automatiseringsgegevens voor gesprekken naar een van deze opties verzendt, worden uw enquêtegegevens niet opgeslagen en gaan de volgende instructies verloren om uw Azure Monitor-resource te configureren om logboeken en metrische gegevens voor uw Communications Services te maken. Zie voor gedetailleerde documentatie over het gebruik van diagnostische instellingen voor alle Azure-resources: Logboekregistratie in diagnostische instellingen inschakelen

Notitie

Selecteer onder de naam van de diagnostische instelling 'Updatelogboeken voor e-mailservicebezorgingsstatus', 'E-mailservicelogboeken verzenden', 'Logboeken voor gebruikersbetrokkenheid van e-mailservice' om de logboeken voor e-mailberichten in te schakelen

Categorieën van resourcelogboeken

Communication Services biedt de volgende typen logboeken die u kunt inschakelen:

• Gebruikslogboeken - bevat gebruiksgegevens die zijn gekoppeld aan elke gefactureerde serviceaanbieding
• Operationele e-maillogboeken voor e-mail verzenden- biedt gedetailleerde informatie met betrekking tot het verzenden van e-mailaanvragen door de e-mailservice.
• Operationele logboeken voor het bijwerken van e-mailstatussen : biedt statusupdates op bericht- en geadresseerdeniveau met betrekking tot het verzenden van e-mailaanvragen door de e-mailservice.
• Operationele logboeken van Email User Engagement- bevat informatie met betrekking tot metrische gegevens over 'openen' en 'klikken' voor gebruikersbetrokkenheid voor berichten die vanuit de e-mailservice worden verzonden.

Schema voor gebruikslogboeken

Eigenschappen	Beschrijving
Timestamp	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
Operation Name	De bewerking die aan de logboekrecord is gekoppeld.
Operation Version	De api-version gekoppeld aan de bewerking, als operationName is uitgevoerd met behulp van een API. Als er geen API is die overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van die bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
Category	De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een bepaalde resource kunt in- of uitschakelen. De eigenschappen die worden weergegeven in de blob-eigenschappen van een gebeurtenis zijn hetzelfde binnen een bepaalde logboekcategorie en resourcetype.
Correlation ID	De id voor gecorreleerde gebeurtenissen. Kan worden gebruikt om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren.
Properties	Andere gegevens die van toepassing zijn op verschillende modi van Communication Services.
Record ID	De unieke id voor een bepaald gebruiksrecord.
Usage Type	De modus van gebruik. (bijvoorbeeld chat, PSTN, NAT, enz.)
Unit Type	Het type eenheid waarop het gebruik van een bepaalde gebruiksmodus is gebaseerd. (bijvoorbeeld minuten, megabytes, berichten, enz.).
Quantity	Het aantal eenheden dat is gebruikt of verbruikt voor deze record.

Operationele e-maillogboeken verzenden

Operationele e-maillogboeken voor e-mail verzenden bieden waardevolle inzichten in api-aanvraagtrends in de loop van de tijd. Met deze gegevens kunt u belangrijke e-mailanalyses ontdekken, zoals het totale aantal verzonden e-mailberichten, de grootte van e-mailberichten en het aantal e-mailberichten met bijlagen. Deze informatie kan snel worden geanalyseerd in bijna realtime en gevisualiseerd op een gebruiksvriendelijke manier om betere besluitvorming te stimuleren.

Eigenschappen	Beschrijving
TimeGenerated	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
Location	De regio waar de bewerking is verwerkt.
OperationName	De bewerking die is gekoppeld aan de logboekrecord.
OperationVersion	De api-version gekoppeld aan de bewerking, als de operationName is uitgevoerd met behulp van een API. Als er geen API is die overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van die bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
Category	De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een bepaalde resource kunt in- of uitschakelen. De eigenschappen die worden weergegeven in de blob-eigenschappen van een gebeurtenis zijn hetzelfde binnen een bepaalde logboekcategorie en resourcetype.
CorrelationID	De id voor gecorreleerde gebeurtenissen. Kan worden gebruikt om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren. Voor alle operationele e-maillogboeken wordt de CorrelationId toegewezen aan de MessageId, die wordt geretourneerd vanuit een geslaagde SendMail-aanvraag.
Size	Vertegenwoordigt de totale grootte van de hoofdtekst van de e-mail, het onderwerp, de kopteksten en bijlagen in megabytes.
ToRecipientsCount	Het totale aantal unieke e-mailadressen op de regel Aan.
CcRecipientsCount	Het totale aantal unieke e-mailadressen op de CC-regel.
BccRecipientsCount	Het totale aantal unieke e-mailadressen op de BCC-regel.
UniqueRecipientsCount	Dit is het ontdubbelde totale aantal geadresseerden voor de adresvelden Aan, CC en BCC.
AttachmentsCount	Het totale aantal bijlagen.
TrafficSource	De naam van de client waaruit de e-mailaanvraag afkomstig is.

Voorbeelden

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

Operationele logboeken voor het bijwerken van e-mailstatus

Operationele logboeken voor het bijwerken van e-mailstatussen bieden uitgebreide inzichten in statusupdates op berichtniveau en leveringsstatusupdates op ontvangerniveau voor uw sendmail-API-aanvragen.

• Statusupdates op berichtniveau bieden de status van de langdurige verzendbewerking voor e-mail (vergelijkbaar met de statusupdates die u ontvangt via het aanroepen van onze GET-API's). Deze worden gemarkeerd door de afwezigheid van RecipientId de eigenschap omdat deze updates voor het hele bericht zijn en niet van toepassing zijn op een specifieke geadresseerde in die berichtaanvraag. DeliveryStatus de eigenschap bevat de bezorgingsstatus op berichtniveau. Mogelijke waarden voor DeliveryStatus dit type gebeurtenis zijn Dropped, OutForDeliveryen Queued.
• Statusupdates op adresniveau bieden de status van e-mailbezorging voor elke afzonderlijke geadresseerde aan wie het e-mailbericht is verzonden in één bericht. Deze bevatten een RecipientId eigenschap met het e-mailadres van de geadresseerde. De bezorgingsstatus op ontvangerniveau wordt opgegeven in de DeliveryStatus eigenschap. Mogelijke waarden voor DeliveryStatus dit type gebeurtenis zijn Delivered, Expanded, Failed, , Quarantined, , FilteredSpam, en SuppressedBounced. Door deze logboeken bij te houden, kunt u volledige zichtbaarheid van uw e-mailbezorgingsproces garanderen, snel eventuele problemen identificeren en zo nodig corrigerende maatregelen nemen.

Eigenschappen	Beschrijving
TimeGenerated	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
Location	De regio waar de bewerking is verwerkt.
OperationName	De bewerking die is gekoppeld aan de logboekrecord.
OperationVersion	De api-version gekoppeld aan de bewerking, als de operationName is uitgevoerd met behulp van een API. Als er geen API is die overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van die bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
Category	De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een bepaalde resource kunt in- of uitschakelen. De eigenschappen die worden weergegeven in de blob-eigenschappen van een gebeurtenis zijn hetzelfde binnen een bepaalde logboekcategorie en resourcetype.
CorrelationID	De id voor gecorreleerde gebeurtenissen. Kan worden gebruikt om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren. Voor alle operationele e-maillogboeken wordt de CorrelationId toegewezen aan de MessageId, die wordt geretourneerd vanuit een geslaagde SendMail-aanvraag.
RecipientId	Het e-mailadres voor de beoogde geadresseerde. Deze is alleen aanwezig voor gebeurtenissen op ontvangerniveau. Als dit een gebeurtenis op berichtniveau is, is de eigenschap leeg.
DeliveryStatus	De terminalstatus van het bericht. Mogelijke waarden voor gebeurtenis op berichtniveau zijn: Dropped, OutForDelivery, Queued. Mogelijke waarden voor een gebeurtenis op ontvangerniveau zijn: Delivered, Expanded, Failed, Quarantined, , FilteredSpam, . SuppressedBounced
SmtpStatusCode	SMTP-statuscode die wordt geretourneerd door de e-mailserver van de geadresseerde in reactie op een e-mailaanvraag verzenden.
EnhancedSmtpStatusCode	Verbeterde SMTP-statuscode die wordt geretourneerd door de e-mailserver van de geadresseerde.
SenderDomain	Het domeingedeelte van het SenderAddress dat wordt gebruikt bij het verzenden van e-mailberichten.
SenderUsername	Het gebruikersnaamgedeelte van het SenderAddress dat wordt gebruikt bij het verzenden van e-mailberichten.
IsHardBounce	Hiermee wordt aangegeven of een leveringsfout is veroorzaakt door een permanent of tijdelijk probleem. IsHardBounce == true betekent dat een permanent postvakprobleem voorkomt dat e-mailberichten worden bezorgd.

Voorbeelden

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

Operationele logboeken voor Gebruikersbetrokkenheid per e-mail verzenden

Operationele logboeken voor e-mailgebruikersbetrokkenheid bieden inzicht in trends in e-mailbetrokkenheid voor uw e-mailsysteem. Met deze gegevens kunt u belangrijke metrische gegevens voor e-mail bijhouden en analyseren, zoals open tarieven, klikfrequenties en afmeldingstarieven. Deze logboeken kunnen worden opgeslagen en geanalyseerd, zodat u meer inzicht krijgt in de prestaties van uw e-mailsysteem en uw strategie dienovereenkomstig kunt aanpassen. Over het algemeen bieden operationele logboeken van Email User Engagement een krachtig hulpmiddel voor het verbeteren van de prestaties van uw e-mailsysteem, het proactief meten en optimaliseren van uw e-mailcampagnes en het verbeteren van de betrokkenheid van gebruikers in de loop van de tijd.

Eigenschappen	Beschrijving
TimeGenerated	De timestamp (UTC) van het moment waarop het logboek werd gegenereerd.
Location	De regio waar de bewerking is verwerkt.
OperationName	De bewerking die is gekoppeld aan de logboekrecord.
OperationVersion	De api-version gekoppeld aan de bewerking, als de operationName is uitgevoerd met behulp van een API. Als er geen API is die overeenkomt met deze bewerking, vertegenwoordigt de versie de versie van die bewerking als de eigenschappen die zijn gekoppeld aan de bewerking in de toekomst veranderen.
Category	De logboekcategorie van de gebeurtenis. De categorie is de granulariteit waarmee u logboeken voor een bepaalde resource kunt in- of uitschakelen. De eigenschappen die worden weergegeven in de blob-eigenschappen van een gebeurtenis zijn hetzelfde binnen een bepaalde logboekcategorie en resourcetype.
CorrelationID	De id voor gecorreleerde gebeurtenissen. Kan worden gebruikt om gecorreleerde gebeurtenissen tussen meerdere tabellen te identificeren. Voor alle operationele e-maillogboeken wordt de CorrelationId toegewezen aan de MessageId, die wordt geretourneerd vanuit een geslaagde SendMail-aanvraag.
RecipientId	Het e-mailadres voor de beoogde geadresseerde. Als dit een gebeurtenis op berichtniveau is, is de eigenschap leeg.
EngagementType	Het type gebruikersbetrokkenheid dat wordt bijgehouden.
EngagementContext	De context vertegenwoordigt waarmee de gebruiker heeft gecommuniceerd.
UserAgent	De tekenreeks van de gebruikersagent van de client.

Voorbeelden

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