Dzienniki sms usług Azure Communication Services

Artykuł
10/26/2023

Usługi Azure Communication Services oferują 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

Poniżej 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 Communications Services, zobacz: 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 docelowego (na przykład dwóch różnych obszarów roboczych usługi Log Analytics), utwórz wiele ustawień. Każdy zasób może mieć maksymalnie pięć ustawień diagnostycznych.

Poniżej przedstawiono instrukcje dotyczące konfigurowania zasobu usługi Azure Monitor w celu rozpoczęcia tworzenia 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

W obszarze Nazwa ustawienia diagnostycznego wybierz pozycję "Sms Operational", aby włączyć dzienniki dla wiadomości SMS.

Omówienie

Dzienniki operacyjne programu SMS to rekordy zdarzeń i działań, które zapewniają wgląd w żądania interfejsu API programu SMS. Przechwycili szczegółowe informacje o wydajności i funkcjonalności elementu pierwotnego programu SMS, w tym szczegółowe informacje o stanie wiadomości, czy zostały one pomyślnie dostarczone, zablokowane lub 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 dostarczanie komunikatów lub problemy. Dzienniki zawierają następujące szczegóły:

Wysłane wiadomości.
Odebrano wiadomość.
Komunikaty dostarczane.
Wiadomości zrezygnuj z zgody i rezygnacji.

Kategorie dzienników zasobów

Usługi komunikacyjne oferują następujące typy dzienników, które można włączyć:

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 nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli 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. (na przykład Czat, PSTN, NAT itp.)
`Unit Type`	Typ jednostki, która jest oparta na danym trybie użycia. (na przykład minuty, megabajty, komunikaty itp.).
`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 nie ma interfejsu API odpowiadającego tej operacji, wersja reprezentuje wersję tej operacji, jeśli 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.
`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ć wartość LongCodeNumber lub ShortCodeNumber lub DynamicAlphaSenderID
`MessageID`	Reprezentują unikatowy identyfikator messageId wygenerowany dla każdej wiadomości wychodzącej i przychodzącej. Można to znaleźć w obiekcie odpowiedzi interfejsu API programu SMS
`Country`	Reprezentują kraje/regiony, w których wiadomości SMS zostały wysłane do lub odebrane z

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

(zobacz też Często zadawane pytania).

Udostępnij za pośrednictwem