Sdílet prostřednictvím

SMS protokoly

Služba Azure Communication Services poskytuje možnosti protokolování, které můžete použít k monitorování a ladění řešení Communication Services. Tyto funkce můžete nakonfigurovat prostřednictvím webu Azure Portal.

Důležité

Tento článek popisuje protokoly povolené prostřednictvím služby Azure Monitor , viz také nejčastější dotazy. Pokud chcete povolit tyto protokoly pro službu Communications Services, přečtěte si téma: Povolení protokolování v nastavení diagnostiky.

Požadavky

Azure Communications Services poskytuje funkce monitorování a analýzy prostřednictvím přehledu protokolů služby Azure Monitor a metrik Azure Monitoru.

Každý prostředek Azure vyžaduje vlastní nastavení diagnostiky, které definuje následující kritéria:

  • Kategorie protokolů a dat metrik odesílaných do cílů definovaných v nastavení Dostupné kategorie se liší pro různé typy prostředků.
  • Jeden nebo více cílů pro odesílání protokolů. Mezi aktuální cíle patří pracovní prostor služby Log Analytics, Event Hubs a Azure Storage.
  • Jedno nastavení diagnostiky nemůže definovat více než jedno z jednotlivých cílů. Pokud chcete odesílat data do více než jednoho konkrétního cílového typu (například do dvou různých pracovních prostorů služby Log Analytics), musíte vytvořit více nastavení. Každý prostředek může mít až pět nastavení diagnostiky.

Podle těchto pokynů nakonfigurujte prostředek služby Azure Monitor tak, aby se začaly vytvářet protokoly a metriky pro komunikační služby. Podrobnou dokumentaci k používání nastavení diagnostiky ve všech prostředcích Azure najdete v tématu: Povolení protokolování v nastavení diagnostiky.

Poznámka:

Chcete-li povolit protokoly pro SMS, vyberte v nastavení diagnostiky SMS operační.

Přehled

Provozní protokoly SMS jsou záznamy událostí a aktivit, které poskytují přehled o vašich požadavcích rozhraní SMS API. Protokoly zaznamenávají podrobnosti o výkonnosti a funkci SMS. Podrobnosti zahrnují stav zpráv, jestli se zpráva úspěšně doručila, zablokovala nebo se neposlala.

Provozní záznamy SMS obsahují informace, které pomáhají identifikovat trendy a vzory, řešit problémy, které mohou ovlivňovat výkon, jako například neúspěšné doručování zpráv nebo problémy se serverem. Protokoly obsahují následující podrobnosti:

  • Odesílané zprávy.
  • Zpráva byla přijata.
  • Zprávy doručené.
  • Možnost přihlásit se k odběru zpráv a odhlásit se.

Kategorie protokolu prostředků

Komunikační služby nabízejí následující typy protokolů:

  • Protokoly využití – poskytuje data o využití přidružená k jednotlivým fakturovaným nabídkám služeb.
  • Provozní protokoly SMS – poskytuje základní informace související se službou SMS.

Schéma protokolů využití

Vlastnost Popis
Timestamp Časové razítko (UTC) při vygenerování protokolu
Operation Name Operace přidružená k záznamu protokolu.
Operation Version Přidružená api-version k operaci, pokud byl operationName proveden pomocí rozhraní API. Pokud žádné rozhraní API neodpovídá této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category Kategorie protokolu události. Kategorie je členitost, při které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti, které se zobrazí v objektu blob vlastností události, jsou stejné v určité kategorii protokolu a typu prostředku.
Correlation ID ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami.
Properties Další data použitelná pro různé režimy komunikačních služeb.
Record ID Jedinečné ID pro daný záznam využití.
Usage Type Režim použití. Například Chat, PSTN, NAT atd.
Unit Type Typ jednotky, která je pro daný režim použití založená na využití. Například minuty, megabajty, zprávy atd.
Quantity Počet použitých nebo spotřebovaných jednotek pro tento záznam.

Provozní protokoly SMS

Vlastnost Popis
TimeGenerated Časové razítko (UTC) při vygenerování protokolu
OperationName Operace přidružená k záznamu protokolu.
CorrelationID ID pro korelované události. Lze použít k identifikaci korelovaných událostí mezi více tabulkami.
OperationVersion Verze rozhraní API přidružená k operaci, pokud byla operace provedena pomocí rozhraní API. Pokud žádné rozhraní API neodpovídá této operaci, verze představuje verzi této operace v případě, že se vlastnosti přidružené k operaci v budoucnu změní.
Category Kategorie protokolu události. Kategorie je členitost, při které můžete povolit nebo zakázat protokoly konkrétního prostředku. Vlastnosti v bloku vlastností události jsou stejné v rámci konkrétní kategorie protokolu a typu prostředku.
ResultType Stav operace.
ResultSignature Dílčí stav operace. Pokud tato operace odpovídá volání rozhraní REST API, toto pole je stavový kód HTTP odpovídajícího volání REST.
ResultDescription Statický textový popis této operace.
DurationMs Doba trvání operace v milisekundách.
CallerIpAddress IP adresa volajícího, pokud operace odpovídá volání rozhraní API, které by pocházelo z entity s veřejně dostupnou IP adresou.
Level Úroveň závažnosti události.
URI Identifikátor URI požadavku.
OutgoingMessageLength Počet znaků v odchozí zprávě.
IncomingMessageLength Počet znaků v příchozí zprávě.
DeliveryAttempts Počet pokusů o doručení této zprávy
PhoneNumber Telefonní číslo, ze kterého se zpráva SMS odesílá.
SdkType Typ sady SDK použitý v požadavku.
PlatformType Typ platformy použitý v požadavku.
Method Metoda použitá v požadavku.
NumberType Typ čísla, odesílají se zprávy SMS. Může to být LongCodeNumber, ShortCodeNumber nebo DynamicAlphaSenderID.
MessageID Představuje jedinečné ID zprávy vygenerované pro každou odchozí a příchozí zprávu. Vyhledejte MessageId v objektu odpovědi rozhraní SMS API. Formát ID zprávy vrácené tímto rozhraním API se považuje za interní podrobnosti implementace a bez předchozího upozornění se může změnit. Klienti musí považovat ID zprávy za neprůkazné identifikátory a nesmí analyzovat, odvozovat strukturu ani vytvářet logiku na základě jejich formátu nebo obsahu.
Country Představuje země nebo oblasti, ze kterých se zprávy SMS odesílají nebo přijímají.

Příklad odeslaného protokolu 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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

Příklad protokolu sms zprávy o doručení


    [
      {
        "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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

Příklad přijatého protokolu 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": "11c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

Nejčastější dotazy ohledně SMS