Az Azure Communication Services e-mail-naplói

Az Azure Communication Services naplózási képességeket kínál, amelyekkel monitorozhat és hibakeresést végezhet a Communication Services-megoldásban. Ezek a képességek az Azure Portalon konfigurálhatók.

Előfeltételek

Az Azure Communications Services monitorozási és elemzési funkciókat biztosít az Azure Monitor-naplók áttekintésében és az Azure Monitor-metrikákban. Minden Azure-erőforráshoz saját diagnosztikai beállítás szükséges, amely a következő feltételeket határozza meg:

• A naplók és a metrikaadatok kategóriái, amelyeket a beállításban meghatározott célhelyekre küldtek. A rendelkezésre álló kategóriák eltérőek lesznek a különböző erőforrástípusok esetében.
• Egy vagy több célhely a naplók elküldéséhez. Az aktuális célhelyek közé tartozik a Log Analytics-munkaterület, az Event Hubs és az Azure Storage.
• Egyetlen diagnosztikai beállítás legfeljebb egy célhelyet definiálhat. Ha több céltípusba (például két különböző Log Analytics-munkaterületre) szeretne adatokat küldeni, hozzon létre több beállítást. Minden erőforrás legfeljebb öt diagnosztikai beállításokkal rendelkezhet.

Fontos

A felmérés adatainak fogadásához és elemzéséhez engedélyeznie kell egy Diagnosztikai beállítást az Azure Monitorban, hogy a felmérések naplóadatait egy Log Analytics-munkaterületre, eseményközpontba vagy egy Azure Storage-fiókba küldje. Ha nem küld hívásautomatizálási adatokat ezen lehetőségek egyikére, a felmérés adatai nem lesznek tárolva, és elvesznek Az alábbiakban az Azure Monitor-erőforrás konfigurálására vonatkozó utasításokat talál a naplók és metrikák kommunikációs szolgáltatásokhoz való létrehozásához. A diagnosztikai beállítások az összes Azure-erőforráson való használatával kapcsolatos részletes dokumentációt a következő témakörben találja: Naplózás engedélyezése a diagnosztikai beállításokban

Feljegyzés

A diagnosztikai beállítás neve alatt válassza az "E-mail szolgáltatás kézbesítési állapotának frissítési naplói", "E-mail-szolgáltatás e-mail-naplók küldése", "E-mail szolgáltatás felhasználói előjegyzési naplói" lehetőséget az e-mailek naplóinak engedélyezéséhez

Erőforrásnapló-kategóriák

A Communication Services a következő típusú naplókat kínálja, amelyeket engedélyezhet:

• Használati naplók – az egyes számlázott szolgáltatásajánlatokhoz társított használati adatokat biztosítja
• E-mail küldése működési naplók – részletes információkat nyújt az e-mail-szolgáltatás e-mail-kérelmek küldéséhez.
• E-mail állapotfrissítés működési naplói – üzenet- és címzettszintű kézbesítési állapotfrissítéseket biztosít az e-mail-szolgáltatás e-mail-kérelmek küldéséhez.
• E-mail User Engagement működési naplók – a "megnyitás" és a "kattintás" felhasználói előjegyzési metrikákkal kapcsolatos információkat biztosít az e-mail szolgáltatásból küldött üzenetekhez.

Használati naplók sémája

Tulajdonság	Leírás
Timestamp	A napló létrehozásának időbélyege (UTC).
Operation Name	A naplórekordhoz társított művelet.
Operation Version	A api-version művelethez társított művelet, ha a műveletnév API-val lett végrehajtva. Ha nincs a műveletnek megfelelő API, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letilthatja a naplókat egy adott erőforráson. Az esemény tulajdonságok blobjában megjelenő tulajdonságok megegyeznek egy adott naplókategórián és erőforrástípuson belül.
Correlation ID	A korrelált események azonosítója. Több tábla közötti korrelált események azonosítására használható.
Properties	A kommunikációs szolgáltatások különböző módjaira vonatkozó egyéb adatok.
Record ID	Egy adott használati rekord egyedi azonosítója.
Usage Type	A használati mód. (például Csevegés, PSTN, NAT stb.)
Unit Type	Az egység típusa, amelyet a használat egy adott használati módhoz ki van kapcsolva. (például percek, megabájtok, üzenetek stb.).
Quantity	A rekordhoz használt vagy felhasznált egységek száma.

Levelezési műveleti naplók küldése e-mailben

Az e-mail küldési operatív naplók értékes betekintést nyújtanak az API-kérések trendjeibe az idő múlásával. Ezek az adatok segítenek felderíteni a legfontosabb e-mail-elemzéseket, például az elküldött e-mailek teljes számát, az e-mailek méretét és a mellékleteket tartalmazó e-mailek számát. Ezek az információk gyorsan elemezhetők közel valós időben, és felhasználóbarát módon jeleníthetők meg a jobb döntéshozatal érdekében.

Tulajdonság	Leírás
TimeGenerated	A napló létrehozásának időbélyege (UTC).
Location	Az a régió, ahol a műveletet feldolgozták.
OperationName	A naplórekordhoz társított művelet.
OperationVersion	A api-version művelethez társított, ha az operationName API-val történt. Ha nincs a műveletnek megfelelő API, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letilthatja a naplókat egy adott erőforráson. Az esemény tulajdonságok blobjában megjelenő tulajdonságok megegyeznek egy adott naplókategórián és erőforrástípuson belül.
CorrelationID	A korrelált események azonosítója. Több tábla közötti korrelált események azonosítására használható. Minden e-mail működési napló esetében a Korrelációs azonosító a MessageId-hez van leképezve, amelyet egy sikeres SendMail-kérés ad vissza.
Size	Az e-mail törzsének, tárgyának, fejléceinek és mellékleteinek teljes méretét jelöli megabájtban.
ToRecipientsCount	Az egyedi e-mail-címek teljes száma a Címzett sorban.
CcRecipientsCount	Az egyedi e-mail-címek teljes száma a Másolatot kap sorban.
BccRecipientsCount	Az egyedi e-mail-címek teljes száma a Titkos másolat sorban.
UniqueRecipientsCount	Ez a Címzett, Másolatot kap és Titkos másolat cím mező deduplikált címzettszáma.
AttachmentsCount	A mellékletek teljes száma.
TrafficSource	Annak az ügyfélnek a neve, ahonnan az e-mail-kérés származik.

Példák

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

E-mail állapotfrissítésének működési naplói

Az e-mail állapotfrissítési működési naplói részletes betekintést nyújtanak a sendmail API-kérések üzenetszintű és címzettszintű kézbesítési állapotfrissítéseibe.

• Az üzenetszintű állapotfrissítések biztosítják a hosszú ideig futó e-mail-küldési művelet állapotát (hasonlóan a GET API-k meghívásával kapott állapotfrissítésekhez). Ezeket a tulajdonság hiánya RecipientId jelöli, mert ezek a frissítések a teljes üzenetre vonatkoznak, és nem alkalmazhatók az adott címzettre az üzenetkérelemben. DeliveryStatus tulajdonság az üzenetszintű kézbesítés állapotát tartalmazza. Az ilyen típusú események lehetséges értékei a következőkDropped: és OutForDeliveryQueued.DeliveryStatus
• A címzettszintű állapotfrissítések biztosítják az e-mail kézbesítésének állapotát minden egyes címzett számára, akinek az e-mailt egyetlen üzenetben küldték el. Ezek a RecipientId címzett e-mail-címével rendelkező tulajdonságot tartalmaznak. A címzettszintű kézbesítés állapota a DeliveryStatus tulajdonságban van megadva. Az ilyen típusú események lehetséges értékei DeliveryStatus a következők Delivered: , Expanded, Failed, Quarantined, FilteredSpam, Suppressedés Bounced. A naplók nyomon követésével teljes körű betekintést biztosíthat az e-mail-kézbesítési folyamatba, gyorsan azonosíthatja az esetlegesen felmerülő problémákat, és szükség esetén korrekciós műveleteket hajthat végre.

Tulajdonság	Leírás
TimeGenerated	A napló létrehozásának időbélyege (UTC).
Location	Az a régió, ahol a műveletet feldolgozták.
OperationName	A naplórekordhoz társított művelet.
OperationVersion	A api-version művelethez társított, ha az operationName API-val történt. Ha nincs a műveletnek megfelelő API, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letilthatja a naplókat egy adott erőforráson. Az esemény tulajdonságok blobjában megjelenő tulajdonságok megegyeznek egy adott naplókategórián és erőforrástípuson belül.
CorrelationID	A korrelált események azonosítója. Több tábla közötti korrelált események azonosítására használható. Minden e-mail működési napló esetében a Korrelációs azonosító a MessageId-hez van leképezve, amelyet egy sikeres SendMail-kérés ad vissza.
RecipientId	A megcélzott címzett e-mail-címe. Csak címzettszintű események esetén van jelen. Ha üzenetszintű eseményről van szó, a tulajdonság üres lesz.
DeliveryStatus	Az üzenet terminálállapota. Az üzenetszintű esemény lehetséges vitézségi szintje a következő: Dropped, OutForDelivery, Queued. Egy címzettszintű esemény lehetséges értékének mértéke a következő: Delivered, , Expanded, QuarantinedFailed, , FilteredSpam, BouncedSuppressed.
SmtpStatusCode	A címzett e-mail-kiszolgálótól kapott SMTP-állapotkód egy e-mail-kérésre adott válaszként.
EnhancedSmtpStatusCode	Továbbfejlesztett SMTP-állapotkód, amelyet a címzett e-mail-kiszolgálótól ad vissza.
SenderDomain	Az e-mailek küldéséhez használt SenderAddress tartományrésze.
SenderUsername	Az e-mailek küldéséhez használt SenderAddress felhasználónév része.
IsHardBounce	Jelzi, hogy a kézbesítési hiba állandó vagy ideiglenes probléma miatt történt-e. Az IsHardBounce == igaz azt jelenti, hogy az e-mailek kézbesítését megakadályozó állandó postaláda-probléma.

Példák

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

A User Engagement működési naplóinak e-mail-küldése

Az e-mail-felhasználók előjegyzési működési naplói betekintést nyújtanak az e-mail-előjegyzési trendekbe az e-mail-rendszerben. Ezek az adatok segítenek nyomon követni és elemezni a főbb e-mail-metrikákat, például a nyitott sebességet, az átkattintási arányokat és a leiratkozási arányokat. Ezek a naplók tárolhatók és elemezhetők, így mélyebb betekintést nyerhet az levelezőrendszer teljesítményébe, és ennek megfelelően módosíthatja a stratégiát. Általánosságban elmondható, hogy az E-mail User Engagement működési naplói hatékony eszközt biztosítanak az e-mail-rendszer teljesítményének javításához, az e-mail kampányok proaktív méréséhez és optimalizálásához, valamint a felhasználói előjegyzés javításához.

Tulajdonság	Leírás
TimeGenerated	A napló létrehozásának időbélyege (UTC).
Location	Az a régió, ahol a műveletet feldolgozták.
OperationName	A naplórekordhoz társított művelet.
OperationVersion	A api-version művelethez társított, ha az operationName API-val történt. Ha nincs a műveletnek megfelelő API, a verzió a művelet verzióját jelöli, ha a művelethez társított tulajdonságok a jövőben megváltoznak.
Category	Az esemény naplókategóriája. A kategória az a részletesség, amely lehetővé teszi vagy letilthatja a naplókat egy adott erőforráson. Az esemény tulajdonságok blobjában megjelenő tulajdonságok megegyeznek egy adott naplókategórián és erőforrástípuson belül.
CorrelationID	A korrelált események azonosítója. Több tábla közötti korrelált események azonosítására használható. Minden e-mail működési napló esetében a Korrelációs azonosító a MessageId-hez van leképezve, amelyet egy sikeres SendMail-kérés ad vissza.
RecipientId	A megcélzott címzett e-mail-címe. Ha üzenetszintű eseményről van szó, a tulajdonság üres lesz.
EngagementType	A nyomon követett felhasználói előjegyzés típusa.
EngagementContext	A környezet azt jelöli, amellyel a felhasználó kommunikált.
UserAgent	A felhasználói ügynök sztringje az ügyféltől.

Példák

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