Protokoly místností služeb 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 Protokoly operačních místností a povolte protokoly pro místnosti.

Přehled

Provozní protokoly místností jsou záznamy událostí a aktivit, které poskytují přehled o požadavcích rozhraní Rooms API. Zaznamenávají podrobnosti o výkonu a funkčnosti primitivních místností, včetně stavu jednotlivých požadavků místnosti a dalších vlastností. Provozní protokoly místností obsahují informace, které pomáhají identifikovat trendy a vzory využití místností.

Kategorie protokolů

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

Protokoly operačních místností – poskytuje základní informace související se službou Rooms

Schéma protokolů operačních místností

Vlastnost	Popis
`Correlation ID`	Jedinečné ID požadavku.
`Level`	Úroveň závažnosti události.
`Operation Name`	Operace přidružená k záznamu protokolu. Například CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	Verze rozhraní API přidružená k operaci.
`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.
.`RoomId`	ID místnosti.
`RoomLifeSpan`	Životnost místnosti v minutách.
`AddedRoomParticipantsCount`	Počet účastníků přidaných do místnosti
`UpsertedRoomParticipantsCount`	Počet účastníků se přeložil do místnosti.
`RemovedRoomParticipantsCount`	Počet účastníků odebraných z místnosti
`TimeGenerated`	Časové razítko (UTC) při vygenerování protokolu
`PstnDialOutEnabled`	Určuje, jestli má místnost možnost volat do veřejné telefonní sítě a pozvat lidi na schůzku.

Příklad protokolu 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,
      }
    ]

Příklad protokolu 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",
      },
    ]

Příklad protokolu 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,
      },
    ]

Příklad protokolu 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",
      },
    ]

Příklad protokolu ListRooms

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

Příklad protokolu 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",
      },
    ]

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

Share via