Share via

Log SMS Azure Communication Services

  • Artikel

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).