SMS Günlüklerini Azure İletişim Hizmetleri

  • Makale

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.

Önemli

Aşağıdakiler Azure İzleyici aracılığıyla etkinleştirilen günlükleri ifade eder (ayrıca bkz. SSS). İletişim Hizmetlerinizde bu günlükleri etkinleştirmek için bkz. Tanılama Ayarları'nda günlüğü etkinleştirme

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

Aşağıda, İletişim Hizmetleriniz için günlükler ve ölçümler 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 sms günlüklerini etkinleştirmek için lütfen "SMS Operasyonel" öğesini seçin.

Genel bakış

SMS işlem günlükleri, SMS API isteklerinizle ilgili içgörüler sağlayan olayların ve etkinliklerin kayıtlarıdır. İletinin başarıyla teslim edilip edilmediği, engellenip engellenmediği veya gönderilemediği hakkındaki ayrıntılar da dahil olmak üzere SMS temel öğesinin performansı ve işlevselliği hakkındaki ayrıntıları yakaladılar. SMS işlem günlükleri eğilimleri ve desenleri belirlemeye, başarısız ileti teslimleri veya hizmet sorunları gibi performansı etkileyebilecek sorunları çözmeye yardımcı olan bilgiler içerir. Günlükler aşağıdaki ayrıntıları içerir:

  • Gönderilen iletiler.
  • İleti alındı.
  • İletiler teslim edildi.
  • İletiler kabul etme ve geri çevirme.

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
  • SMS işlem günlükleri - SMS hizmetiyle ilgili temel bilgileri 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ı.

SMS işlem günlükleri

Özellik Açıklama
TimeGenerated Günlüğün oluşturulduğu zaman damgası (UTC).
OperationName Günlük kaydıyla ilişkili işlem.
CorrelationID bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için kullanılabilir.
OperationVersion operationName bir API kullanılarak gerçekleştirildiyse, işlemle ilişkili api sürümü. 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.
ResultType İşlemin durumu.
ResultSignature İşlemin alt durumu. Bu işlem bir REST API çağrısına karşılık geliyorsa, bu alan ilgili REST çağrısının HTTP durum kodudur.
ResultDescription Bu işlemin statik metin açıklaması.
DurationMs İşlemin milisaniye cinsinden süresi.
CallerIpAddress İşlem genel kullanıma açık BIR IP adresine sahip bir varlıktan gelen bir API çağrısına karşılık geliyorsa çağıranın IP adresi.
Level Olayın önem düzeyi.
URI İsteğin URI'sini.
OutgoingMessageLength Giden iletideki karakter sayısı.
IncomingMessageLength Gelen iletideki karakter sayısı.
DeliveryAttempts Bu iletiyi teslim etmek için yapılan girişimlerin sayısı.
PhoneNumber SMS iletisinin gönderildiği telefon numarası.
SdkType İstekte kullanılan SDK türü.
PlatformType İstekte kullanılan platform türü.
Method İstekte kullanılan yöntem.
NumberType SMS iletisinin gönderildiği numaranın türü. LongCodeNumber veya ShortCodeNumber ya da DynamicAlphaSenderID olabilir
MessageID Giden ve gelen her ileti için oluşturulan benzersiz messageId değerini temsil edin. Bu, SMS API yanıt nesnesinde bulunabilir
Country SMS iletilerinin gönderildiği veya alındığı ülkeleri/bölgeleri temsil etme

Örnek SMS gönderilen günlük


    [
      {
        "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"
      }
    ]

Örnek SMS teslim raporu günlüğü


    [
      {
        "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"
      }
    ]

Örnek SMS alınan günlük


    [
      {
        "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"
      }
    ]

(ayrıca bkz.SSS).