E-mailové protokoly služby Azure Communication Services

Azure Communication Services nabízí možnosti protokolování, které můžete použít k monitorování a ladění řešení Communication Services. Tyto funkce je možné nakonfigurovat prostřednictvím webu Azure Portal.

Požadavky

Azure Communications Services poskytuje funkce monitorování a analýzy prostřednictvím přehledu protokolů služby Azure Monitor a metrik Azure Monitoru. Každý prostředek Azure vyžaduje vlastní nastavení diagnostiky, které definuje následující kritéria:

• Kategorie protokolů a dat metrik odesílaných do cílů definovaných v nastavení Dostupné kategorie se budou lišit pro různé typy prostředků.
• Jeden nebo více cílů pro odesílání protokolů. Mezi aktuální cíle patří pracovní prostor služby Log Analytics, Event Hubs a Azure Storage.
• Jedno nastavení diagnostiky nemůže definovat více než jedno z jednotlivých cílů. Pokud chcete odesílat data do více než jednoho konkrétního cílového typu (například do dvou různých pracovních prostorů služby Log Analytics), vytvořte několik nastavení. Každý prostředek může mít až pět nastavení diagnostiky.

Důležité

Abyste mohli přijímat a analyzovat data průzkumu, musíte ve službě Azure Monitor povolit nastavení diagnostiky, abyste mohli odesílat data protokolů průzkumů do pracovního prostoru služby Log Analytics, do služby Event Hubs nebo účtu úložiště Azure. Pokud do některé z těchto možností neodešlete data automatizace volání, data průzkumu se neuloží a ztratí se Následující pokyny pro konfiguraci prostředku služby Azure Monitor pro zahájení vytváření protokolů a metrik pro komunikační služby. Podrobnou dokumentaci k používání diagnostických Nastavení napříč všemi prostředky Azure najdete v tématu: Povolení protokolování v diagnostickém Nastavení

Poznámka:

V části Název nastavení diagnostiky vyberte Protokoly aktualizace stavu doručení e-mailové služby, Odeslat e-mailové služby protokoly, Protokoly zapojení uživatelů e-mailu a povolte protokoly pro e-maily.

Kategorie protokolu prostředků

Služba Communication Services nabízí následující typy protokolů, které můžete povolit:

• Protokoly využití – poskytuje data o využití přidružená k jednotlivým fakturovaným nabídkám služeb.
• Provozní protokoly odeslání e-mailu – poskytuje podrobné informace týkající se odesílání e-mailových požadavků e-mailové služby.
• Provozní protokoly aktualizace stavu e-mailu – poskytuje aktualizace stavu doručení na úrovni zpráv a příjemců související s e-mailovou službou, které odesílají e-mailové žádosti.
• Provozní protokoly User Engagementu e-mailu – poskytuje informace týkající se metriky otevření a kliknutí na metriky zapojení uživatelů pro zprávy odeslané z e-mailové služby.

Schéma protokolů využití

Vlastnost	Popis
Timestamp	Časové razítko (UTC) při vygenerování protokolu
Operation Name	Operace přidružená k záznamu protokolu.
Operation Version	Přidružená api-version k operaci, pokud byl operationName proveden pomocí rozhraní API. Pokud neexistuje žádné rozhraní API odpovídající této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category	Kategorie protokolu události. Kategorie je členitost, ve které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti, které se zobrazí v objektu blob vlastností události, jsou stejné v určité kategorii protokolu a typu prostředku.
Correlation ID	ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami.
Properties	Další data použitelná pro různé režimy komunikačních služeb.
Record ID	Jedinečné ID pro daný záznam využití.
Usage Type	Režim použití. (například Chat, PSTN, NAT atd.)
Unit Type	Typ jednotky, která je pro daný režim použití založená na využití. (například minuty, megabajty, zprávy atd.).
Quantity	Počet použitých nebo spotřebovaných jednotek pro tento záznam.

E-mail Send Mail operational logs

Provozní protokoly odesílání e-mailů poskytují cenné přehledy o trendech požadavků rozhraní API v průběhu času. Tato data pomáhají zjišťovat klíčové e-mailové analýzy, jako je celkový počet odeslaných e-mailů, velikost e-mailu a počet e-mailů s přílohami. Tyto informace je možné rychle analyzovat téměř v reálném čase a vizualizovat uživatelsky přívětivým způsobem, aby bylo možné lépe rozhodovat.

Vlastnost	Popis
TimeGenerated	Časové razítko (UTC) při vygenerování protokolu
Location	Oblast, ve které byla operace zpracována.
OperationName	Operace přidružená k záznamu protokolu.
OperationVersion	Přidružená api-version k operaci, pokud operationName byla provedena pomocí rozhraní API. Pokud neexistuje žádné rozhraní API odpovídající této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category	Kategorie protokolu události. Kategorie je členitost, ve které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti, které se zobrazí v objektu blob vlastností události, jsou stejné v určité kategorii protokolu a typu prostředku.
CorrelationID	ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami. U všech provozních protokolů e-mailu se ID korelace mapuje na ID zprávy, které se vrátí z úspěšného požadavku SendMail.
Size	Představuje celkovou velikost textu e-mailu, předmětu, záhlaví a příloh v megabajtech.
ToRecipientsCount	Celkový počet jedinečných e-mailových adres na řádku To
CcRecipientsCount	Celkový počet jedinečnýchech
BccRecipientsCount	Celkový počet jedinečných e-mailových adres na řádku Skrytá.
UniqueRecipientsCount	Toto je celkový počet příjemců odstraněných duplicitních dat pro pole Komu, Kopie a Skrytá adresa.
AttachmentsCount	Celkový počet příloh.
TrafficSource	Název klienta, ze kterého pochází e-mailová žádost.

Ukázky

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

Provozní protokoly aktualizace stavu e-mailu

Provozní protokoly aktualizace stavu e-mailu poskytují podrobné přehledy o aktualizacích stavu doručení na úrovni zpráv a příjemců v žádostech rozhraní API pro odesílání e-mailů. Tyto protokoly nabízejí podrobnosti specifické pro zprávy, například čas doručení, a také podrobnosti na úrovni příjemce, jako jsou e-mailové adresy a aktualizace stavu doručení. Sledováním těchtoprotokolůch

Vlastnost	Popis
TimeGenerated	Časové razítko (UTC) při vygenerování protokolu
Location	Oblast, ve které byla operace zpracována.
OperationName	Operace přidružená k záznamu protokolu.
OperationVersion	Přidružená api-version k operaci, pokud operationName byla provedena pomocí rozhraní API. Pokud neexistuje žádné rozhraní API odpovídající této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category	Kategorie protokolu události. Kategorie je členitost, ve které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti, které se zobrazí v objektu blob vlastností události, jsou stejné v určité kategorii protokolu a typu prostředku.
CorrelationID	ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami. U všech provozních protokolů e-mailu se ID korelace mapuje na ID zprávy, které se vrátí z úspěšného požadavku SendMail.
RecipientId	E-mailová adresa cílového příjemce Pokud se jedná o událost na úrovni zprávy, vlastnost bude prázdná.
DeliveryStatus	Stav terminálu zprávy.
SmtpStatusCode	Stavový kód SMTP vrácený z e-mailového serveru příjemce v reakci na žádost o odeslání pošty.
EnhancedSmtpStatusCode	Vylepšený stavový kód SMTP vrácený z e-mailového serveru příjemce
SenderDomain	Doménová část SenderAddress použitá při odesílání e-mailů.
SenderUsername	Uživatelské jméno části SenderAddress použité při odesílání e-mailů.
IsHardBounce	Označuje, jestli došlo k selhání doručení kvůli trvalému nebo dočasnému problému. IsHardBounce == true znamená trvalý problém s poštovní schránkou, který brání doručení e-mailů.

Ukázky

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

Provozní protokoly e-mailu User Engagement

Provozní protokoly zapojení uživatelů e-mailu poskytují přehled o trendech zapojení e-mailů pro váš e-mailový systém. Tato data vám pomůžou sledovat a analyzovat klíčové e-mailové metriky, jako jsou otevřené sazby, míra prokliku a míra odhlášení odběru. Tyto protokoly je možné ukládat a analyzovat, což vám umožní získat hlubší přehled o výkonu e-mailového systému a odpovídajícím způsobem přizpůsobit strategii. Provozní protokoly Email User Engagement poskytují výkonný nástroj pro zlepšení výkonu e-mailového systému, proaktivně měření a optimalizaci e-mailových kampaní a zlepšení zapojení uživatelů v průběhu času.

Vlastnost	Popis
TimeGenerated	Časové razítko (UTC) při vygenerování protokolu
Location	Oblast, ve které byla operace zpracována.
OperationName	Operace přidružená k záznamu protokolu.
OperationVersion	Přidružená api-version k operaci, pokud operationName byla provedena pomocí rozhraní API. Pokud neexistuje žádné rozhraní API odpovídající této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category	Kategorie protokolu události. Kategorie je členitost, ve které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti, které se zobrazí v objektu blob vlastností události, jsou stejné v určité kategorii protokolu a typu prostředku.
CorrelationID	ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami. U všech provozních protokolů e-mailu se ID korelace mapuje na ID zprávy, které se vrátí z úspěšného požadavku SendMail.
RecipientId	E-mailová adresa cílového příjemce Pokud se jedná o událost na úrovni zprávy, vlastnost bude prázdná.
EngagementType	Typ sledování zapojení uživatelů.
EngagementContext	Kontext představuje, s čím uživatel pracoval.
UserAgent	Řetězec uživatelského agenta z klienta.

Ukázky

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