Udostępnij za pośrednictwem

Dzienniki pokoi usług Azure Communication Services

  • Artykuł

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ę "Dzienniki pokoi operacyjnych", aby włączyć dzienniki dla pokoi.

Omówienie

Dzienniki operacyjne pokoi to rekordy zdarzeń i działań, które zapewniają wgląd w żądania interfejsu API pokoi. Przechwytują szczegółowe informacje o wydajności i funkcjonalności obiektu pierwotnego Pokoje, w tym stan każdego żądania Pokoje, a także dodatkowe właściwości. Dzienniki operacyjne pomieszczeń zawierają informacje ułatwiające identyfikowanie trendów i wzorców użycia pomieszczeń.

Rejestruj kategorie

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

  • Dzienniki pokoi operacyjnych — zawiera podstawowe informacje dotyczące usługi Rooms

Schemat dzienników pokoi operacyjnych

Właściwości opis
Correlation ID Unikatowy identyfikator żądania.
Level Poziom ważności zdarzenia.
Operation Name Operacja skojarzona z rekordem dziennika. Np. CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
Operation Version Wersja interfejsu API skojarzona z operacją.
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.
.RoomId Identyfikator pokoju.
RoomLifeSpan Żywotność pomieszczenia w ciągu kilku minut.
AddedRoomParticipantsCount Liczba uczestników dodanych do pokoju.
UpsertedRoomParticipantsCount Liczba uczestników została przesłonięta w pokoju.
RemovedRoomParticipantsCount Liczba uczestników usuniętych z pokoju.
TimeGenerated Sygnatura czasowa (UTC) czasu wygenerowania dziennika.
PstnDialOutEnabled Wskazuje, czy pokój ma możliwość nawiązywania połączeń PSTN w celu zapraszania osób na spotkanie.

Przykładowy dziennik CreateRoom

    [
      {
      "CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
      "Level": "Informational",
      "OperationName": "CreateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": 201,
      "RoomId": "99466898241024408",
      "RoomLifespan": 61,
      "AddedRoomParticipantsCount": 4,
      "TimeGenerated": "5/25/2023, 4:32:49.469 AM",
      "PstnDialOutEnabled": false,
      }
    ]

Przykładowy dziennik GetRoom

    [
      {
      "CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
      "Level": "Informational",
      "OperationName": "GetRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 61,
      "TimeGenerated": "2022-08-19T17:07:30.2400300Z",
      },
    ]

Przykładowy dziennik UpdateRoom

    [
      {
      "CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
      "Level": "Informational",
      "OperationName": "UpdateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.3543160Z",
      "PstnDialOutEnabled": false,
      },
    ]

Przykładowy dziennik DeleteRoom

    [
      {
      "CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
      "Level": "Informational",
      "OperationName": "DeleteRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "204",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
      },
    ]

Przykładowy dziennik ListRooms

	[
	  {
	  "CorrelationId": "KibM39CaXkK+HTInfsiY2w",
	  "Level": "Informational",
	  "OperationName": "ListRooms",
	  "OperationVersion": "2023-10-30-preview",
	  "ResultType": "Succeeded",
	  "ResultSignature": "200",
	  "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
	  },
	]

Przykładowy dziennik UpdateParticipants

    [
      {
      "CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
      "Level": "Informational",
      "OperationName": "UpdateParticipants",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "UpsertedRoomParticipantsCount": 5,
      "RemovedRoomParticipantsCount": 1,
      "TimeGenerated": "2023-04-14T17:07:30.5393800Z",
      },
    ]

(Zobacz również Często zadawane pytania).