E-posta günlüklerini Azure İletişim Hizmetleri

Azure İletişim Hizmetleri, İletişim Hizmetleri çözümünüzü izlemek ve hatalarını ayıklamak için kullanabileceğiniz günlük özellikleri sunar. Bu özellikler Azure portalı üzerinden yapılandırılabilir.

Önkoşullar

Azure Communications Services, Azure İzleyici Günlüklerine genel bakış ve Azure İzleyici Ölçümleri aracılığıyla izleme ve analiz özellikleri sağlar. Her Azure kaynağı, aşağıdaki ölçütleri tanımlayan kendi tanılama ayarını gerektirir:

  • Ayarda tanımlanan hedeflere gönderilen günlüklerin ve ölçüm verilerinin kategorileri. Kullanılabilir kategoriler farklı kaynak türleri için farklılık gösterir.
  • Günlükleri göndermek için bir veya daha fazla hedef. Geçerli hedefler Log Analytics çalışma alanı, Event Hubs ve Azure Depolama'dır.
  • Tek bir tanılama ayarı, hedeflerden en fazla birini tanımlayabilir. Verileri belirli bir hedef türünden birden fazlasına (örneğin, iki farklı Log Analytics çalışma alanı) göndermek istiyorsanız, birden çok ayar oluşturun. Her kaynağın en fazla beş tanılama ayarı olabilir.

Önemli

Anketlerinizin günlük verilerini bir Log Analytics çalışma alanına, Event Hubs'a veya anket verilerinizi almak ve analiz etmek üzere bir Azure depolama hesabına göndermek için Azure İzleyici'de tanılama ayarını etkinleştirmeniz gerekir. Arama otomasyonu verilerini bu seçeneklerden birine göndermezseniz anket verileriniz depolanmaz ve kaybolur. Aşağıda, İletişim Hizmetleriniz için günlük ve ölçüm oluşturmaya başlamak üzere Azure İzleyici kaynağınızı yapılandırma yönergeleri yer alır. Tanılama Ayarlarını tüm Azure kaynaklarında kullanma hakkında ayrıntılı belgeler için bkz. Tanılama Ayarları'nda günlüğe kaydetmeyi etkinleştirme

Not

Tanılama ayarı adı altında lütfen e-postalar için günlükleri etkinleştirmek üzere "E-posta Hizmeti Teslim Durumu Güncelleştirme Günlükleri", "E-posta Hizmeti Posta Günlükleri Gönder", "E-posta Hizmeti Kullanıcı Görevlendirme Günlükleri"ni seçin

E-posta için tanılama ayarlarının ekran görüntüsü.

Kaynak günlüğü kategorileri

İletişim Hizmetleri, etkinleştirebileceğiniz aşağıdaki günlük türlerini sunar:

  • Kullanım günlükleri - Faturalanan her hizmet teklifiyle ilişkili kullanım verilerini sağlar
  • E-posta Gönder Posta işlem günlükleri - E-posta hizmeti posta istekleri gönderme ile ilgili ayrıntılı bilgiler sağlar.
  • E-posta Durumu Güncelleştirmesi işlem günlükleri - E-posta hizmetinin posta istekleri göndermesi ile ilgili ileti ve alıcı düzeyinde teslim durumu güncelleştirmeleri sağlar.
  • E-posta Kullanıcı Etkileşimi işlem günlükleri - E-posta hizmetinden gönderilen iletiler için 'aç' ve 'tıklayın' kullanıcı etkileşimi ölçümleriyle ilgili bilgiler sağlar.

Kullanım günlükleri şeması

Özellik Açıklama
Timestamp Günlüğün oluşturulduğu zaman damgası (UTC).
Operation Name Günlük kaydıyla ilişkili işlem.
Operation Version api-version operationName bir API kullanılarak gerçekleştirildiyse, işlemle ilişkili. Bu işleme karşılık gelen bir API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm bu işlemin sürümünü temsil eder.
Category Olayın günlük kategorisi. Kategori, belirli bir kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın özellikler blobu içinde görünen özellikler, belirli bir günlük kategorisi ve kaynak türü içinde aynıdır.
Correlation ID bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için kullanılabilir.
Properties Çeşitli İletişim Hizmetleri modları için geçerli olan diğer veriler.
Record ID Belirli bir kullanım kaydının benzersiz kimliği.
Usage Type Kullanım modu. (örneğin, Sohbet, PSTN, NAT vb.)
Unit Type Kullanımın belirli bir kullanım modu için temel alındığı birim türü. (örneğin, dakika, megabayt, ileti vb.).
Quantity Bu kayıt için kullanılan veya kullanılan birim sayısı.

E-posta Gönder Posta işlem günlükleri

E-posta Gönderme Posta İşlem günlükleri , zaman içindeki API isteği eğilimleri hakkında değerli içgörüler sağlar. Bu veriler, gönderilen toplam e-posta sayısı, e-posta boyutu ve ekleri olan e-postaların sayısı gibi önemli e-posta analizlerini keşfetmenize yardımcı olur. Bu bilgiler neredeyse gerçek zamanlı olarak hızlı bir şekilde analiz edilebilir ve daha iyi karar alma sürecine yardımcı olmak için kullanıcı dostu bir şekilde görselleştirilebilir.

Özellik Açıklama
TimeGenerated Günlüğün oluşturulduğu zaman damgası (UTC).
Location İşlemin işlendiği bölge.
OperationName Günlük kaydıyla ilişkili işlem.
OperationVersion api-version bir API kullanılarak gerçekleştirilip gerçekleştirilmediğinioperationName, işlemle ilişkili. Bu işleme karşılık gelen bir API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm bu işlemin sürümünü temsil eder.
Category Olayın günlük kategorisi. Kategori, belirli bir kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın özellikler blobu içinde görünen özellikler, belirli bir günlük kategorisi ve kaynak türü içinde aynıdır.
CorrelationID bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için kullanılabilir. Tüm E-posta işlem günlükleri için CorrelationId, başarılı bir SendMail isteğinden döndürülen MessageId ile eşlenir.
Size E-posta gövdesinin, konunun, üst bilgilerin ve eklerin megabayt cinsinden toplam boyutunu temsil eder.
ToRecipientsCount Son satırındaki benzersiz e-posta adreslerinin toplam numarası.
CcRecipientsCount Bilgi satırındaki benzersiz e-posta adreslerinin toplam numarası.
BccRecipientsCount Gizli satırındaki benzersiz e-posta adreslerinin toplam numarası.
UniqueRecipientsCount Bu, Kime, Bilgi ve Gizli adres alanları için yinelenenleri kaldırılmış toplam alıcı sayısıdır.
AttachmentsCount Eklerin toplam sayısı.
TrafficSource E-posta isteğinin kaynaklandığı istemcinin adı.

Örnekler

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

E-posta Durumu Güncelleştirmesi işlem günlükleri

E-posta durum güncelleştirmesi işlem günlükleri , gönderme posta API'si isteklerinizdeki ileti düzeyi ve alıcı düzeyinde teslim durumu güncelleştirmeleri hakkında ayrıntılı içgörüler sağlar.

  • İleti düzeyi durum güncelleştirmeleri, uzun süre çalışan e-posta gönderme işleminin durumunu sağlar (GET API'lerimizi çağırarak aldığınız durum güncelleştirmelerine benzer). Bu güncelleştirmeler iletinin RecipientId tamamı için olduğundan ve bu ileti isteğindeki belirli bir alıcı için geçerli olmadığından, bunlar özellik yokluğuyla işaretlenir. DeliveryStatus özelliği ileti düzeyi teslim durumunu içerir. Bu olay türü için DeliveryStatus olası değerler , OutForDeliveryve QueuedşeklindedirDropped.
  • Alıcı düzeyinde durum güncelleştirmeleri, e-postanın tek bir iletide gönderildiği her alıcı için e-posta teslim durumunu sağlar. Bunlar, alıcının e-posta adresini içeren bir RecipientId özellik içerir. Alıcı düzeyinde teslim durumu özelliğinde DeliveryStatus sağlanır. Bu olay türü için DeliveryStatus olası değerler , , Expanded, Failed, Quarantined, FilteredSpam, Suppressedve BounceddeğerleridirDelivered. Bu günlükleri izleyerek, e-posta teslim sürecinize tam görünürlük sağlayabilir, ortaya çıkabilecek sorunları hızla belirleyebilir ve gerektiğinde düzeltici eylemler gerçekleştirebilirsiniz.
Özellik Açıklama
TimeGenerated Günlüğün oluşturulduğu zaman damgası (UTC).
Location İşlemin işlendiği bölge.
OperationName Günlük kaydıyla ilişkili işlem.
OperationVersion api-version bir API kullanılarak gerçekleştirilip gerçekleştirilmediğinioperationName, işlemle ilişkili. Bu işleme karşılık gelen bir API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm bu işlemin sürümünü temsil eder.
Category Olayın günlük kategorisi. Kategori, belirli bir kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın özellikler blobu içinde görünen özellikler, belirli bir günlük kategorisi ve kaynak türü içinde aynıdır.
CorrelationID bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için kullanılabilir. Tüm E-posta işlem günlükleri için CorrelationId, başarılı bir SendMail isteğinden döndürülen MessageId ile eşlenir.
RecipientId Hedeflenen alıcının e-posta adresi. Yalnızca alıcı düzeyindeki olaylar için bulunur. Bu bir ileti düzeyi olayıysa, özelliği boş olur.
DeliveryStatus İletinin terminal durumu. İleti düzeyi olay için olası değer şunlardır: Dropped, OutForDelivery, Queued. Alıcı düzeyinde bir olay için olası değer şunlardır: , , , , , FilteredSpam, Suppressed. BouncedQuarantinedFailedExpandedDelivered
SmtpStatusCode Posta gönderme isteğine yanıt olarak alıcı e-posta sunucusundan döndürülen SMTP durum kodu.
EnhancedSmtpStatusCode Alıcı e-posta sunucusundan döndürülen gelişmiş SMTP durum kodu.
SenderDomain E-posta gönderirken kullanılan SenderAddress öğesinin etki alanı bölümü.
SenderUsername E-posta gönderirken kullanılan SenderAddress kullanıcı adı bölümü.
IsHardBounce Teslim hatasının kalıcı veya geçici bir sorundan kaynaklanıp kaynaklanmadığını belirtir. IsHardBounce == true, e-postaların teslim edilmesini engelleyen kalıcı bir posta kutusu sorunu anlamına gelir.

Örnekler

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

E-posta Kullanıcı Etkileşimi işlem günlükleri

E-posta kullanıcı etkileşimi işlem günlükleri , e-posta sisteminiz için e-posta etkileşimi eğilimleri hakkında içgörüler sağlar. Bu veriler açık fiyatlar, tıklama oranları ve abonelikten çıkma oranları gibi önemli e-posta ölçümlerini izlemenize ve analiz etmenize yardımcı olur. Bu günlükler depolanabilir ve analiz edilebilir, böylece e-posta sisteminizin performansı hakkında daha derin içgörüler elde edebilir ve stratejinizi buna göre uyarlayabilirsiniz. Genel olarak, E-posta Kullanıcı Etkileşimi işlem günlükleri e-posta sisteminizin performansını iyileştirmeye, e-posta kampanyalarınızı proaktif olarak ölçmeye ve iyileştirmeye ve zaman içinde kullanıcı katılımını geliştirmeye yönelik güçlü bir araç sağlar.

Özellik Açıklama
TimeGenerated Günlüğün oluşturulduğu zaman damgası (UTC).
Location İşlemin işlendiği bölge.
OperationName Günlük kaydıyla ilişkili işlem.
OperationVersion api-version bir API kullanılarak gerçekleştirilip gerçekleştirilmediğinioperationName, işlemle ilişkili. Bu işleme karşılık gelen bir API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm bu işlemin sürümünü temsil eder.
Category Olayın günlük kategorisi. Kategori, belirli bir kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın özellikler blobu içinde görünen özellikler, belirli bir günlük kategorisi ve kaynak türü içinde aynıdır.
CorrelationID bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için kullanılabilir. Tüm E-posta işlem günlükleri için CorrelationId, başarılı bir SendMail isteğinden döndürülen MessageId ile eşlenir.
RecipientId Hedeflenen alıcının e-posta adresi. Bu bir ileti düzeyi olayıysa, özelliği boş olur.
EngagementType İzlenen kullanıcı etkileşiminin türü.
EngagementContext Bağlam, kullanıcının etkileşimde olduğu şeyi temsil eder.
UserAgent İstemciden kullanıcı aracısı dizesi.

Örnekler

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