Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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"
}
]