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
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çinDeliveryStatus
olası değerler ,OutForDelivery
veQueued
ş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ğindeDeliveryStatus
sağlanır. Bu olay türü içinDeliveryStatus
olası değerler , ,Expanded
,Failed
,Quarantined
,FilteredSpam
,Suppressed
veBounced
değ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 . Bounced Quarantined Failed Expanded Delivered |
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"
}