Protokoly SMS služby Azure Communication Services

Článek
10/26/2023

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

Důležité

Následující informace se týkají protokolů povolených 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 diagnostickém Nastavení

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 budou lišit 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), vytvořte několik nastavení. Každý prostředek může mít až pět nastavení diagnostiky.

Následují pokyny ke konfiguraci prostředku služby Azure Monitor, aby se začaly vytvářet protokoly a metriky pro komunikační služby. Podrobnou dokumentaci k používání diagnostických Nastavení napříč všemi prostředky Azure najdete v tématu: Povolení protokolování v diagnostickém Nastavení

Poznámka:

V části Název nastavení diagnostiky vyberte "Provoz sms" a povolte protokoly pro SMS.

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. Zachytili podrobnosti o výkonu a funkčnosti primitivního serveru SMS, včetně podrobností o stavu zprávy, zda byly úspěšně doručeny, blokovány nebo neúspěšně odeslány. Provozní protokoly SMS obsahují informace, které pomáhají identifikovat trendy a vzory, vyřešit problémy, které můžou mít vliv na výkon takových neúspěšných dodávek zpráv nebo obsluhovat problémy. Protokoly obsahují následující podrobnosti:

Odesílané zprávy.
Zpráva byla přijata.
Zprávy doručené.
Zprávy odhlaste a odhlaste se.

Kategorie protokolu prostředků

Služba Communication Services nabízí následující typy protokolů, které můžete povolit:

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 neexistuje žádné rozhraní API odpovídající 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 neexistuje žádné rozhraní API odpovídající 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.
`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 nebo ShortCodeNumber nebo DynamicAlphaSenderID.
`MessageID`	Představuje jedinečný identifikátor messageId vygenerovaný pro každou odchozí a příchozí zprávu. Najdete ho v objektu odpovědi rozhraní SMS API.
`Country`	Představuje země/oblasti, ve kterých byly zprávy SMS odeslány nebo přijímány z

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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(viz také Časté otázky).

Sdílet prostřednictvím