Udostępnij przez


Rejestry SMS

Usługi Azure Communication Services udostępniają funkcje rejestrowania, których można użyć do monitorowania i debugowania rozwiązania usług Komunikacyjnych. Te możliwości można skonfigurować za pośrednictwem witryny Azure Portal.

Ważne

W tym artykule opisano dzienniki włączone za pośrednictwem usługi Azure Monitor Zobacz też Często zadawane pytania. Aby włączyć te dzienniki dla usług komunikacyjnych, sprawdź: Włączanie rejestrowania w ustawieniach diagnostycznych.

Wymagania wstępne

Usługi Azure Communications Services udostępniają funkcje monitorowania i analizy za pośrednictwem przeglądu dzienników usługi Azure Monitor i metryk usługi Azure Monitor.

Każdy zasób platformy Azure wymaga własnego ustawienia diagnostycznego, które definiuje następujące kryteria:

  • Kategorie dzienników i danych metryk wysyłanych do miejsc docelowych zdefiniowanych w ustawieniu. Dostępne kategorie różnią się w zależności od różnych typów zasobów.
  • Co najmniej jedno miejsce docelowe do wysyłania dzienników. Bieżące miejsca docelowe obejmują obszar roboczy usługi Log Analytics, usługę Event Hubs i usługę Azure Storage.
  • Jedno ustawienie diagnostyczne może definiować nie więcej niż jedno z miejsc docelowych. Jeśli chcesz wysłać dane do więcej niż jednego z określonego typu miejsca docelowego (na przykład dwóch różnych obszarów roboczych usługi Log Analytics), musisz utworzyć wiele ustawień. Każdy zasób może mieć maksymalnie pięć ustawień diagnostycznych.

Wykonaj te instrukcje, aby skonfigurować zasób usługi Azure Monitor, aby rozpocząć tworzenie dzienników i metryk dla usług Communications Services. Aby uzyskać szczegółową dokumentację dotyczącą używania ustawień diagnostycznych we wszystkich zasobach platformy Azure, zobacz: Włączanie rejestrowania w ustawieniach diagnostycznych.

Uwaga

Aby włączyć dzienniki dla wiadomości SMS, w ustawieniach diagnostycznych wybierz SMS Operational.

Omówienie

Dzienniki operacyjne programu SMS to rekordy zdarzeń i działań, które zapewniają wgląd w żądania interfejsu API programu SMS. Dzienniki przechwytują szczegółowe informacje o wydajności i funkcji programu SMS. Szczegóły obejmują stan komunikatów, niezależnie od tego, czy wiadomość została pomyślnie dostarczona, zablokowana, czy nie można wysłać.

Dzienniki operacyjne programu SMS zawierają informacje ułatwiające identyfikowanie trendów i wzorców, rozwiązywanie problemów, które mogą mieć wpływ na wydajność, takie jak nieudane dostawy komunikatów lub problemy z usługą. Dzienniki zawierają następujące szczegóły:

  • Wysłane wiadomości.
  • Odebrano wiadomość.
  • Komunikaty dostarczane.
  • Subskrypcja i anulowanie subskrypcji wiadomości.

Kategorie dzienników zasobów

Usługi komunikacyjne oferują następujące typy dzienników:

  • Dzienniki użycia — udostępnia dane użycia skojarzone z każdą ofertą rozliczanej usługi
  • Dzienniki operacyjne programu SMS — zawiera podstawowe informacje dotyczące usługi SMS

Schemat dzienników użycia

Właściwości opis
Timestamp Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
Operation Name Operacja skojarzona z rekordem dziennika.
Operation Version Skojarzony api-version z operacją, jeśli operacja operationName została wykonana przy użyciu interfejsu API. Jeśli żaden interfejs API nie odpowiada tej operacji, wersja reprezentuje wersję tej operacji w przypadku, gdy właściwości skojarzone ze zmianą operacji w przyszłości.
Category Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości wyświetlane we właściwościach obiektu blob zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
Correlation ID Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami.
Properties Inne dane dotyczące różnych trybów usług komunikacyjnych.
Record ID Unikatowy identyfikator dla danego rekordu użycia.
Usage Type Tryb użycia. Takie jak Chat, PSTN, NAT itd.
Unit Type Typ jednostki, która jest oparta na danym trybie użycia. Takie jak minuty, megabajty, komunikaty itd.
Quantity Liczba jednostek używanych lub używanych dla tego rekordu.

Dzienniki operacyjne programu SMS

Właściwości opis
TimeGenerated Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
OperationName Operacja skojarzona z rekordem dziennika.
CorrelationID Identyfikator skorelowanych zdarzeń. Może służyć do identyfikowania skorelowanych zdarzeń między wieloma tabelami.
OperationVersion Wersja interfejsu API skojarzona z operacją, jeśli operacja operationName została wykonana przy użyciu interfejsu API. Jeśli żaden interfejs API nie odpowiada tej operacji, wersja reprezentuje wersję tej operacji w przypadku, gdy właściwości skojarzone ze zmianą operacji w przyszłości.
Category Kategoria dziennika zdarzenia. Kategoria to stopień szczegółowości, w którym można włączać lub wyłączać dzienniki w określonym zasobie. Właściwości obiektu blob właściwości zdarzenia są takie same w określonej kategorii dziennika i typie zasobu.
ResultType Stan operacji.
ResultSignature Stan podrzędny operacji. Jeśli ta operacja odpowiada wywołaniu interfejsu API REST, to pole jest kodem stanu HTTP odpowiedniego wywołania REST.
ResultDescription Statyczny opis tekstu tej operacji.
DurationMs Czas trwania operacji w milisekundach.
CallerIpAddress Adres IP obiektu wywołującego, jeśli operacja odpowiada wywołaniu interfejsu API pochodzącemu z jednostki z publicznie dostępnym adresem IP.
Level Poziom ważności zdarzenia.
URI Identyfikator URI żądania.
OutgoingMessageLength Liczba znaków w wiadomości wychodzącej.
IncomingMessageLength Liczba znaków w wiadomości przychodzącej.
DeliveryAttempts Liczba prób dostarczenia tej wiadomości.
PhoneNumber Numer telefonu wysyłany przez wiadomość SMS.
SdkType Typ zestawu SDK używany w żądaniu.
PlatformType Typ platformy używany w żądaniu.
Method Metoda użyta w żądaniu.
NumberType Typ numeru, z których jest wysyłana wiadomość SMS. Może to być LongCodeNumber, ShortCodeNumber lub DynamicAlphaSenderID.
MessageID Reprezentuje unikatowy identyfikator komunikatu wygenerowany dla każdej wiadomości wychodzącej i przychodzącej. Znajdź identyfikator MessageId w obiekcie odpowiedzi interfejsu API programu SMS. Format identyfikatora komunikatu zwróconego przez to API jest uważany za detal wewnętrznej implementacji i może ulec zmianie bez powiadomienia. Klienci muszą traktować identyfikator komunikatu jako nieprzezroczyste identyfikatory i nie mogą analizować, wnioskować struktury ani tworzyć logiki na podstawie ich formatu lub zawartości.
Country Reprezentuje kraje/regiony, w których wiadomości SMS są wysyłane do lub odbierane.

Przykładowy dziennik wysłanych wiadomości 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"
      }
    ]

Przykładowy dziennik raportów dostarczania wiadomości 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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

Przykładowy dziennik odebranych wiadomości 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"
      }
    ]

Często zadawane pytania dotyczące SMS-ów