E-postloggar för Azure Communication Services

Azure Communication Services erbjuder loggningsfunktioner som du kan använda för att övervaka och felsöka din Communication Services-lösning. Dessa funktioner kan konfigureras via Azure Portal.

Förutsättningar

Azure Communications Services tillhandahåller övervaknings- och analysfunktioner via Översikt över Azure Monitor-loggar och Azure Monitor-mått. Varje Azure-resurs kräver en egen diagnostikinställning, som definierar följande villkor:

• Kategorier av loggar och måttdata som skickas till de mål som definieras i inställningen. De tillgängliga kategorierna varierar för olika resurstyper.
• Ett eller flera mål för att skicka loggarna. Aktuella mål är Log Analytics-arbetsytan, Event Hubs och Azure Storage.
• En enda diagnostikinställning kan inte definiera fler än ett av vart och ett av målen. Om du vill skicka data till mer än en av en viss måltyp (till exempel två olika Log Analytics-arbetsytor) skapar du flera inställningar. Varje resurs kan ha upp till fem diagnostikinställningar.

Resursloggkategorier

Communication Services erbjuder följande typer av loggar som du kan aktivera:

• Användningsloggar – tillhandahåller användningsdata som är associerade med varje faktureringstjänsterbjudande
• Driftloggar för skicka e-post – innehåller detaljerad information som rör e-posttjänstens skicka e-postbegäranden.
• Driftloggar för e-poststatusuppdatering – tillhandahåller uppdateringar av leveransstatus på meddelande- och mottagarnivå relaterade till e-posttjänstens skicka e-postbegäranden.
• Driftloggar för e-postanvändarengagemang – innehåller information som rör "öppna" och "klicka" mått för användarengagemang för meddelanden som skickas från e-posttjänsten.

Schema för användningsloggar

Driftloggar för Skicka e-post via e-post

E-post skicka e-post Driftloggar ger värdefulla insikter om API-begärandenstrender över tid. Dessa data hjälper dig att identifiera viktiga e-postanalyser, till exempel det totala antalet e-postmeddelanden som skickas, e-poststorlek och antalet e-postmeddelanden med bifogade filer. Den här informationen kan snabbt analyseras nästan i realtid och visualiseras på ett användarvänligt sätt för att bidra till bättre beslutsfattande.

Exempel

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

Driftloggar för e-poststatusuppdatering

Driftloggar för e-poststatusuppdatering ger djupgående insikter om uppdateringar på meddelandenivå och leveransstatus på mottagarnivå på dina API-begäranden för sendmail.

• Statusuppdateringar på meddelandenivå ger status för den långvariga e-postsändningsåtgärden (ungefär som de statusuppdateringar du får genom att anropa våra GET-API:er). Dessa markeras av avsaknaden av RecipientId egenskapen eftersom dessa uppdateringar gäller för hela meddelandet och inte gäller för en specifik mottagare i den meddelandebegäran. DeliveryStatus -egenskapen innehåller leveransstatus på meddelandenivå. Möjliga värden för DeliveryStatus den här typen av händelse är Dropped, OutForDeliveryoch Queued.
• Statusuppdateringar på mottagarnivå ger status för e-postleverans för varje enskild mottagare som e-postmeddelandet skickades till i ett enda meddelande. Dessa innehåller en RecipientId egenskap med mottagarens e-postadress. Leveransstatus på mottagarnivå anges i egenskapen DeliveryStatus . Möjliga värden för DeliveryStatus den här typen av händelse är Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressedoch Bounced. Genom att spåra dessa loggar kan du säkerställa fullständig insyn i e-postleveransprocessen, snabbt identifiera eventuella problem som kan uppstå och vidta korrigerande åtgärder efter behov.

Exempel

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

Driftloggar för e-postanvändarengagemang

Driftloggar för e-postanvändarengagemang ger insikter om trender för e-postengagemang för ditt e-postsystem. Dessa data hjälper dig att spåra och analysera viktiga e-postmått, till exempel öppna priser, klickfrekvenser och priser för avprenumerering. Dessa loggar kan lagras och analyseras, så att du kan få djupare insikter om e-postsystemets prestanda och anpassa din strategi i enlighet med detta. Överlag är driftsloggar för e-postanvändarengagemang ett kraftfullt verktyg för att förbättra e-postsystemets prestanda, proaktivt mäta och optimera dina e-postkampanjer och förbättra användarnas engagemang över tid.

Exempel

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