Log SMS 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.
Penting
Hal berikut mengacu ke log yang diaktifkan melalui Azure Monitor (lihat juga FAQ). Untuk mengaktifkan log ini bagi Communication Services Anda, lihat: Aktifkan pembuatan log di Pengaturan Diagnostik
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.
Berikut adalah instruksi untuk mengonfigurasikan sumber daya Azure Monitor Anda untuk mulai membuat log dan metrik untuk Communication 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 "Sms Operational" untuk mengaktifkan log untuk SMS.
Ringkasan
Log operasional SMS adalah catatan peristiwa dan aktivitas yang memberikan wawasan tentang permintaan SMS API Anda. Mereka menangkap detail tentang performa dan fungsionalitas primitif SMS, termasuk detail tentang status pesan apakah mereka berhasil dikirim, diblokir, atau gagal dikirim. Log operasional SMS berisi informasi yang membantu mengidentifikasi tren dan pola, mengatasi masalah yang mungkin memengaruhi performa pengiriman pesan yang gagal atau masalah layanan. Log mencakup detail berikut:
- Pesan terkirim.
- Pesan diterima.
- Pesan dikirimkan.
- Pesan ikut serta & menolak.
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 SMS - menyediakan informasi dasar yang terkait dengan layanan SMS
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 adalah granularitas tempat 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 SSIS
Properti | Deskripsi |
---|---|
TimeGenerated |
Tanda waktu (UTC) saat log dihasilkan. |
OperationName |
Operasi yang terkait dengan rekaman log. |
CorrelationID |
ID untuk kejadian berkorelasi. Dapat digunakan untuk mengidentifikasi kejadian yang berkorelasi di antara beberapa tabel. |
OperationVersion |
Versi api yang 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 adalah granularitas tempat 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. |
ResultType |
Status operasi. |
ResultSignature |
Sub status operasi. Jika operasi ini sesuai dengan panggilan REST API, bidang ini adalah kode status HTTP dari panggilan REST yang sesuai. |
ResultDescription |
Deskripsi teks statis dari operasi ini. |
DurationMs |
Durasi operasi, dalam milidetik. |
CallerIpAddress |
Alamat IP pemanggil, jika operasi sesuai dengan panggilan API yang berasal dari entitas dengan alamat IP yang tersedia untuk umum. |
Level |
Tingkat keparahan peristiwa. |
URI |
URI permintaan. |
OutgoingMessageLength |
Jumlah karakter dalam pesan keluar. |
IncomingMessageLength |
Jumlah karakter dalam pesan masuk. |
DeliveryAttempts |
Jumlah upaya yang dilakukan untuk menyampaikan pesan ini. |
PhoneNumber |
Nomor telepon pengirim pesan SMS. |
SdkType |
Jenis SDK yang digunakan dalam permintaan. |
PlatformType |
Jenis platform yang digunakan dalam permintaan. |
Method |
Metode yang digunakan dalam permintaan. |
NumberType |
Jenis nomor, pesan SMS sedang dikirim. Ini bisa berupa LongCodeNumber atau ShortCodeNumber atau DynamicAlphaSenderID |
MessageID |
Mewakili messageId unik yang dihasilkan untuk setiap pesan keluar dan masuk. Ini dapat ditemukan di objek respons SMS API |
Country |
Mewakili negara/wilayah tempat pesan SMS dikirim atau diterima dari |
Contoh log yang dikirim SMS
[
{
"TimeGenerated": "2022-09-26T15:58:30.100Z",
"OperationName": "SMSMessagesSent",
"CorrelationId": "dDRmubfpNZZZZZnxBtw3Q.0",
"OperationVersion": "2020-07-20-preview1",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 202,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://sms-e2e-prod.communication.azure.com/sms?api-version=2020-07-20-preview1",
"OutgoingMessageLength": 151,
"IncomingMessageLength": 0,
"DeliveryAttempts": 0,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "azsdk-net-Communication.Sms",
"PlatformType": "Microsoft Windows 10.0.17763",
"Method": "POST",
"MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
"Country": "US"
}
]
Contoh log laporan pengiriman SMS
[
{
"TimeGenerated": "2022-09-26T15:58:30.200Z",
"OperationName": "SMSDeliveryReportsReceived",
"CorrelationId": "tl8WpUTESTSTSTccYadXJm.0",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 200,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/DeliveryReport",
"OutgoingMessageLength": 0,
"IncomingMessageLength": 0,
"DeliveryAttempts": 1,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "",
"PlatformType": "",
"Method": "POST",
"MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
"Country": "US"
}
]
Contoh log yang diterima SMS
[
{
"TimeGenerated": "2022-09-27T15:58:30.200Z",
"OperationName": "SMSMessagesReceived",
"CorrelationId": "e2KFTSTSTI/5PTx4ZZB.0",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 200,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/inbound",
"OutgoingMessageLength": 0,
"IncomingMessageLength": 110,
"DeliveryAttempts": 0,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "",
"PlatformType": "",
"Method": "POST",
"MessageId": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
"Country": "US"
}
]
(lihat juga FAQ).