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-portalen.

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.

Viktigt!

Du måste aktivera en diagnostikinställning i Azure Monitor för att skicka loggdata för dina undersökningar till en Log Analytics-arbetsyta, Event Hubs eller ett Azure Storage-konto för att ta emot och analysera dina undersökningsdata. Om du inte skickar samtalsautomatiseringsdata till något av dessa alternativ kommer dina undersökningsdata inte att lagras och kommer att gå förlorade Följande är instruktioner för hur du konfigurerar Azure Monitor-resursen för att börja skapa loggar och mått för dina kommunikationstjänster. Detaljerad dokumentation om hur du använder diagnostik Inställningar för alla Azure-resurser finns i: Aktivera loggning i Diagnostik Inställningar

Kommentar

Under namn på diagnostikinställning väljer du "Uppdateringsloggar för e-posttjänstleveransstatus", "Skicka e-postloggar för e-posttjänst", "E-posttjänstanvändarengagemangsloggar" för att aktivera loggarna för e-postmeddelanden

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

Property	beskrivning
Timestamp	Tidsstämpeln (UTC) för när loggen genererades.
Operation Name	Åtgärden som är associerad med loggposten.
Operation Version	Associerad api-version med åtgärden, om operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category	Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
Correlation ID	ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller.
Properties	Andra data som gäller för olika kommunikationstjänster.
Record ID	Det unika ID:t för en viss användningspost.
Usage Type	Användningsläget. (till exempel Chat, PSTN, NAT osv.)
Unit Type	Den typ av enhet som användningen baseras på för ett angivet användningsläge. (till exempel minuter, megabyte, meddelanden osv.).
Quantity	Antalet enheter som används eller förbrukas för den här posten.

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.

Property	beskrivning
TimeGenerated	Tidsstämpeln (UTC) för när loggen genererades.
Location	Den region där åtgärden bearbetades.
OperationName	Åtgärden som är associerad med loggposten.
OperationVersion	Associerad api-version med åtgärden, om den operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category	Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
CorrelationID	ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller. För alla e-postdriftsloggar mappas CorrelationId till MessageId, som returneras från en lyckad SendMail-begäran.
Size	Representerar den totala storleken på e-postmeddelandets brödtext, ämne, rubriker och bifogade filer i megabyte.
ToRecipientsCount	Totalt antal unika e-postadresser på raden Till.
CcRecipientsCount	Totalt antal unika e-postadresser på raden Kopia.
BccRecipientsCount	Totalt antal unika e-postadresser på hemlig kopiaraden.
UniqueRecipientsCount	Det här är det deduplicerade totala antalet mottagare för adressfälten Till, Kopia och Hemlig kopia.
AttachmentsCount	Totalt antal bifogade filer.
TrafficSource	Namnet på klienten där e-postbegäran kom från.

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 av leveransstatus på meddelande- och mottagarnivå på dina API-begäranden för sendmail. Dessa loggar erbjuder meddelandespecifik information, till exempel leveranstid, samt information på mottagarnivå, till exempel e-postadresser och uppdateringar av leveransstatus. 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.

Property	beskrivning
TimeGenerated	Tidsstämpeln (UTC) för när loggen genererades.
Location	Den region där åtgärden bearbetades.
OperationName	Åtgärden som är associerad med loggposten.
OperationVersion	Associerad api-version med åtgärden, om den operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category	Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
CorrelationID	ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller. För alla e-postdriftsloggar mappas CorrelationId till MessageId, som returneras från en lyckad SendMail-begäran.
RecipientId	E-postadressen för målmottagaren. Om det här är en händelse på meddelandenivå är egenskapen tom.
DeliveryStatus	Meddelandets terminalstatus.
SmtpStatusCode	SMTP-statuskod som returneras från mottagarens e-postserver som svar på en skicka e-postbegäran.
EnhancedSmtpStatusCode	Förbättrad SMTP-statuskod som returneras från mottagarens e-postserver.
SenderDomain	Domändelen av SenderAddress som används för att skicka e-postmeddelanden.
SenderUsername	Användarnamnsdelen av SenderAddress som används för att skicka e-postmeddelanden.
IsHardBounce	Anger om ett leveransfel berodde på ett permanent eller tillfälligt problem. IsHardBounce == true innebär ett permanent postlådeproblem som förhindrar att e-postmeddelanden levereras.

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.

Property	beskrivning
TimeGenerated	Tidsstämpeln (UTC) för när loggen genererades.
Location	Den region där åtgärden bearbetades.
OperationName	Åtgärden som är associerad med loggposten.
OperationVersion	Associerad api-version med åtgärden, om den operationName utfördes med hjälp av ett API. Om det inte finns något API som motsvarar den här åtgärden representerar versionen av åtgärden om egenskaperna som är associerade med åtgärden ändras i framtiden.
Category	Loggkategorin för händelsen. Kategorin är den kornighet där du kan aktivera eller inaktivera loggar på en viss resurs. Egenskaperna som visas i egenskapsbloben för en händelse är desamma inom en viss loggkategori och resurstyp.
CorrelationID	ID:t för korrelerade händelser. Kan användas för att identifiera korrelerade händelser mellan flera tabeller. För alla e-postdriftsloggar mappas CorrelationId till MessageId, som returneras från en lyckad SendMail-begäran.
RecipientId	E-postadressen för målmottagaren. Om det här är en händelse på meddelandenivå är egenskapen tom.
EngagementType	Vilken typ av användarengagemang som spåras.
EngagementContext	Kontexten representerar vad användaren interagerade med.
UserAgent	Användaragentsträngen från klienten.

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