Log email Azure Communication Services
Azure Communication Services menawarkan kemampuan pengelogan yang dapat Anda gunakan untuk memantau dan men-debug solusi Communication Services Anda. Kemampuan ini dapat dikonfigurasi melalui portal Microsoft Azure.
Prasyarat
Azure Communications Services menyediakan fitur pemantauan dan analitik melalui gambaran umum Log Azure Monitor dan Metrik Azure Monitor. Setiap sumber daya Azure memerlukan pengaturan diagnostiknya sendiri, yang menentukan kriteria berikut:
- Kategori log dan data metrik yang dikirim ke tujuan yang ditentukan dalam pengaturan. Kategori yang tersedia akan bervariasi untuk jenis sumber daya yang berbeda.
- Satu atau beberapa tujuan untuk mengirim log. Tujuan saat ini mencakup ruang kerja Analitik Log, Azure Event Hubs, dan Azure Storage.
- Satu pengaturan diagnostik dapat menentukan tidak lebih dari satu dari masing-masing tujuan. Jika Anda ingin mengirim data ke lebih dari satu jenis tujuan tertentu (misalnya, dua ruang kerja Analitik Log yang berbeda), buat beberapa pengaturan. Setiap sumber daya dapat memiliki hingga 5 pengaturan diagnostik.
Penting
Anda harus mengaktifkan Pengaturan Diagnostik di Azure Monitor untuk mengirim data log survei Anda ke ruang kerja Analitik Log, Azure Event Hubs, atau akun penyimpanan Azure untuk menerima dan menganalisis data survei Anda. Jika Anda tidak mengirim data otomatisasi panggilan ke salah satu opsi ini, data survei Anda tidak akan disimpan dan akan hilang Berikut ini adalah instruksi untuk mengonfigurasi sumber daya Azure Monitor Anda untuk mulai membuat log dan metrik untuk Communications Services Anda. Untuk dokumentasi terperinci tentang menggunakan Pengaturan Diagnostik di semua sumber daya Azure, lihat: Mengaktifkan pengelogan di Diagnostik Pengaturan
Catatan
Di bawah nama pengaturan diagnostik, pilih "Log Pembaruan Status Pengiriman Layanan Email", "Log Email Kirim Email Layanan Email", "Log Keterlibatan Pengguna Layanan Email" untuk mengaktifkan log untuk email
Kategori log sumber daya
Communication Services menawarkan jenis log berikut yang dapat Anda aktifkan:
- Log penggunaan - menyediakan data penggunaan yang terkait dengan setiap penawaran layanan yang ditagih
- Log operasional Email Kirim Email - menyediakan informasi terperinci yang terkait dengan layanan Email yang mengirim permintaan email.
- Log operasional Pembaruan Status Email - menyediakan pembaruan status pengiriman tingkat pesan dan penerima yang terkait dengan layanan Email mengirim permintaan email.
- Log operasional Keterlibatan Pengguna Email - menyediakan informasi terkait metrik keterlibatan pengguna 'terbuka' dan 'klik' untuk pesan yang dikirim dari layanan Email.
Skema log penggunaan
| Properti | Deskripsi |
|---|---|
Timestamp |
Tanda waktu (UTC) saat log dihasilkan. |
Operation Name |
Operasi yang terkait dengan rekaman log. |
Operation Version |
Yang api-version terkait dengan operasi, jika operationName dilakukan menggunakan API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi tersebut jika properti yang terkait dengan perubahan operasi di masa mendatang. |
Category |
Kategori log kejadian. Kategori ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya tertentu. Properti yang muncul dalam blob properti dari suatu kejadian sama dalam kategori log dan jenis sumber daya tertentu. |
Correlation ID |
ID untuk kejadian berkorelasi. Dapat digunakan untuk mengidentifikasi kejadian yang berkorelasi di antara beberapa tabel. |
Properties |
Data lain yang berlaku untuk berbagai mode Azure Communication Services. |
Record ID |
ID unik untuk rekaman penggunaan tertentu. |
Usage Type |
Mode penggunaan. (misalnya, Obrolan, PSTN, NAT, dll.) |
Unit Type |
Jenis unit yang penggunaannya didasarkan untuk mode penggunaan tertentu. (misalnya, menit, megabyte, pesan, dll.). |
Quantity |
Jumlah unit yang digunakan atau dikonsumsi untuk rekaman ini. |
Log operasional Email Kirim Email
Log Operasional Email Kirim Email memberikan wawasan berharga tentang tren permintaan API dari waktu ke waktu. Data ini membantu Anda menemukan analitik email utama, seperti jumlah total email yang dikirim, ukuran email, dan jumlah email dengan lampiran. Informasi ini dapat dianalisis dengan cepat secara hampir real-time dan divisualisasikan dengan cara yang mudah digunakan untuk membantu mendorong pengambilan keputusan yang lebih baik.
| Properti | Deskripsi |
|---|---|
TimeGenerated |
Tanda waktu (UTC) saat log dihasilkan. |
Location |
Wilayah tempat operasi diproses. |
OperationName |
Operasi yang dikaitkan dengan catatan log. |
OperationVersion |
Yang api-version terkait dengan operasi, jika dilakukan menggunakan operationName API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi tersebut jika properti yang terkait dengan perubahan operasi di masa mendatang. |
Category |
Kategori log kejadian. Kategori ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya tertentu. Properti yang muncul dalam blob properti dari suatu kejadian sama dalam kategori log dan jenis sumber daya tertentu. |
CorrelationID |
ID untuk kejadian berkorelasi. Dapat digunakan untuk mengidentifikasi kejadian yang berkorelasi di antara beberapa tabel. Untuk semua log operasional Email, CorrelationId dipetakan ke MessageId, yang dikembalikan dari permintaan SendMail yang berhasil. |
Size |
Mewakili ukuran total isi email, subjek, header, dan lampiran dalam megabyte. |
ToRecipientsCount |
Total # alamat email unik di baris Kepada. |
CcRecipientsCount |
Total # alamat email unik di baris Cc. |
BccRecipientsCount |
Total # alamat email unik di baris Bcc. |
UniqueRecipientsCount |
Ini adalah jumlah total penerima yang dideduplikasi untuk bidang Alamat Kepada, Cc, dan Bcc. |
AttachmentsCount |
Total # lampiran. |
TrafficSource |
Nama klien tempat permintaan email berasal. |
Sampel
{
"OperationType":"SendMail",
"OperationCategory":"EmailSendMailOperational",
"Size":0.026019,
"ToRecipientsCount":2,
"CcRecipientsCount":3,
"BccRecipientsCount":1,
"UniqueRecipientsCount":6,
"AttachmentsCount":0,
"TrafficSource":"Email .NET SDK"
}
Log operasional Pembaruan Status Email
Log operasional pembaruan status email memberikan wawasan mendalam tentang pembaruan status pengiriman tingkat pesan dan penerima pada permintaan API sendmail Anda. Log ini menawarkan detail khusus pesan, seperti waktu pengiriman, serta detail tingkat penerima, seperti alamat email dan pembaruan status pengiriman. Dengan melacak log ini, Anda dapat memastikan visibilitas penuh ke dalam proses pengiriman email Anda, dengan cepat mengidentifikasi masalah apa pun yang mungkin muncul dan mengambil tindakan korektif seperlunya.
| Properti | Deskripsi |
|---|---|
TimeGenerated |
Tanda waktu (UTC) saat log dihasilkan. |
Location |
Wilayah tempat operasi diproses. |
OperationName |
Operasi yang dikaitkan dengan catatan log. |
OperationVersion |
Yang api-version terkait dengan operasi, jika dilakukan menggunakan operationName API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi tersebut jika properti yang terkait dengan perubahan operasi di masa mendatang. |
Category |
Kategori log kejadian. Kategori ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya tertentu. Properti yang muncul dalam blob properti dari suatu kejadian sama dalam kategori log dan jenis sumber daya tertentu. |
CorrelationID |
ID untuk kejadian berkorelasi. Dapat digunakan untuk mengidentifikasi kejadian yang berkorelasi di antara beberapa tabel. Untuk semua log operasional Email, CorrelationId dipetakan ke MessageId, yang dikembalikan dari permintaan SendMail yang berhasil. |
RecipientId |
Alamat email untuk penerima yang ditargetkan. Jika ini adalah peristiwa tingkat pesan, properti akan kosong. |
DeliveryStatus |
Status terminal pesan. |
SmtpStatusCode |
Kode status SMTP dikembalikan dari server email penerima sebagai respons terhadap permintaan kirim email. |
EnhancedSmtpStatusCode |
Kode status SMTP yang disempurnakan dikembalikan dari server email penerima. |
SenderDomain |
Bagian domain dari SenderAddress yang digunakan dalam mengirim email. |
SenderUsername |
Bagian nama pengguna dari SenderAddress yang digunakan dalam mengirim email. |
IsHardBounce |
Menandakan apakah kegagalan pengiriman disebabkan oleh masalah permanen atau sementara. IsHardBounce == true berarti masalah kotak surat permanen yang mencegah pengiriman email. |
Sampel
{
"OperationType":"DeliveryStatusUpdate",
"OperationCategory":"EmailStatusUpdateOperational",
"RecipientId":"user@email.com",
"DeliveryStatus":"Delivered",
"SenderDomain":"contoso.com",
"SenderUsername":"donotreply",
"IsHardBounce":false
}
Email log operasional Keterlibatan Pengguna
Log operasional keterlibatan pengguna email memberikan wawasan tentang tren keterlibatan email untuk sistem email Anda. Data ini membantu Anda melacak dan menganalisis metrik email utama seperti tarif terbuka, tarif klik-tayang, dan tingkat berhenti berlangganan. Log ini dapat disimpan dan dianalisis, memungkinkan Anda untuk mendapatkan wawasan yang lebih mendalam tentang performa sistem email Anda, dan menyesuaikan strategi Anda dengan sesuai. Secara keseluruhan, log operasional Keterlibatan Pengguna Email menyediakan alat yang ampuh untuk meningkatkan performa sistem email Anda, mengukur secara proaktif, dan mengoptimalkan kampanye email Anda, dan meningkatkan keterlibatan pengguna dari waktu ke waktu.
| Properti | Deskripsi |
|---|---|
TimeGenerated |
Tanda waktu (UTC) saat log dihasilkan. |
Location |
Wilayah tempat operasi diproses. |
OperationName |
Operasi yang dikaitkan dengan catatan log. |
OperationVersion |
Yang api-version terkait dengan operasi, jika dilakukan menggunakan operationName API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi tersebut jika properti yang terkait dengan perubahan operasi di masa mendatang. |
Category |
Kategori log kejadian. Kategori ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya tertentu. Properti yang muncul dalam blob properti dari suatu kejadian sama dalam kategori log dan jenis sumber daya tertentu. |
CorrelationID |
ID untuk kejadian berkorelasi. Dapat digunakan untuk mengidentifikasi kejadian yang berkorelasi di antara beberapa tabel. Untuk semua log operasional Email, CorrelationId dipetakan ke MessageId, yang dikembalikan dari permintaan SendMail yang berhasil. |
RecipientId |
Alamat email untuk penerima yang ditargetkan. Jika ini adalah peristiwa tingkat pesan, properti akan kosong. |
EngagementType |
Jenis keterlibatan pengguna yang sedang dilacak. |
EngagementContext |
Konteks mewakili apa yang berinteraksi dengan pengguna. |
UserAgent |
String agen pengguna dari klien. |
Sampel
{
"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"
}