E-posta günlükleri

Azure İletişim Hizmetleri, İletişim Hizmetleri çözümünüzü izlemek ve sorunlarını gidermek için kullanabileceğiniz kayıt tutma özellikleri sunar. Bu özellikleri Azure portalı aracılığıyla yapılandırın.

Ö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 logların ve ölçüm verilerinin kategorileri. Kullanılabilir kategoriler farklı kaynak türleri için farklılık gösterir.
• Bir veya daha fazla hedefe günlükleri göndermek. 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.

İletişim Hizmetleriniz için günlükler ve ölçümler oluşturmaya başlamak üzere Azure İzleyici kaynağınızı yapılandırmak üzere aşağıdaki yönergeleri tamamlayın. Tüm Azure kaynakları için Tanılama Ayarları'nı kullanma hakkında daha fazla bilgi için bkz. Tanılama Ayarları'nda günlüğü etkinleştirme

Not

Tanı ayarı adında E-posta Servisi Teslim Durumu Güncelleme Günlükleri, E-posta Servisi Posta Gönderme Günlükleri ve E-posta Servisi Kullanıcı Etkileşim Günlükleri'ni seçerek e-posta günlüklerini etkinleştirin.

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ı

Mülk	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 kayıt 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	ilişkili olaylar için kimlik numarası. 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 tüketilen birim sayısı.

E-posta Gönderme ve Posta İş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.

Mülk	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 kayıt 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	ilişkili olaylar için kimlik numarası. 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 toplam boyutunu megabayt cinsinden temsil eder.
ToRecipientsCount	To satırındaki benzersiz e-posta adreslerinin toplam sayısı.
CcRecipientsCount	Cc satırındaki benzersiz e-posta adreslerinin sayısı.
BccRecipientsCount	Gizli satırındaki benzersiz e-posta adreslerinin toplam numarası.
UniqueRecipientsCount	Kime, Bilgi ve Gizli adres alanları için yinelenenleri kaldırılmış toplam alıcı sayısı.
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üncellemeler, iletinin tamamı için olup, belirli bir alıcıya yönelik olmadıkları için, RecipientId özelliği eksikliği ile işaretlenir. DeliveryStatus özelliği ileti düzeyi teslim durumunu içerir. Bu olay türü için DeliveryStatus olası değerler , Droppedve OutForDeliveryşeklindedirQueued.
• 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. Özellik DeliveryStatus içinde alıcı düzeyinde teslim durumu sağlanır. Bu olay türü için DeliveryStatus olası değerler , , Delivered, Expanded, Failed, Quarantined, FilteredSpamve SuppresseddeğerleridirBounced. 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.

Mülk	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 kayıt 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	ilişkili olaylar için kimlik numarası. 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ı seviyesindeki etkinlikler için geçerlidir. Bu bir mesaj düzeyi olay olduğunda, özellik boştur.
DeliveryStatus	İletinin terminal durumu. İleti düzeyi olayı için olası değerler şunlardır: Dropped, OutForDelivery, Queued. Alıcı düzeyindeki bir olayın olası değerleri şunlardır: , , , , , Delivered, Expanded. FailedQuarantinedFilteredSpamSuppressedBounced
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.

Mülk	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 kayıt 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	ilişkili olaylar için kimlik numarası. 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 mesaj düzeyi olay olduğunda, özellik boştur.
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"
}