Logs das Salas dos Serviços de Comunicação do Azure

Artigo
10/16/2024

Os Serviços de Comunicação do Azure oferecem funcionalidades de log que você pode usar para monitorar e depurar sua solução dos Serviços de Comunicação. Essas funcionalidades podem ser configuradas por meio do portal do Azure.

Importante

O exemplo a seguir refere-se aos logs habilitados por meio do Azure Monitor (confira também as perguntas frequentes). Para habilitar esses logs para os Serviços de Comunicações, confira: Habilitar o registro em log nas Configurações de Diagnóstico

Pré-requisitos

Os Serviços de Comunicação do Azure fornecem recursos de monitoramento e análise por meio da Visão geral de Logs do Azure Monitor e Métricas do Azure Monitor. Cada recurso do Azure requer sua própria configuração de diagnóstico, o que define os seguintes critérios:

As categorias de logs e os dados de métrica enviados aos destinos definidos na configuração. As categorias disponíveis irão variar para diferentes tipos de recursos.
Um ou mais destinos para enviar os logs. Os destinos atuais incluem o workspace do Log Analytics, os Hubs de Eventos e o Armazenamento do Microsoft Azure.
Uma única configuração de diagnóstico pode definir apenas um de cada um dos destinos. Se você quiser enviar dados para mais de um tipo de destino específico (por exemplo, dois workspaces do Log Analytics diferentes), crie várias configurações. Cada recurso pode ter até cinco configurações de diagnóstico.

A seguir estão instruções para configurar seu recurso Azure Monitor para começar a criar logs e métricas para seus Serviços de Comunicação. Para ver a documentação detalhada sobre como usar Configurações de Diagnóstico em todos os recursos do Azure, consulte Habilitar o registro em log em Configurações de Diagnóstico

Observação

No nome da configuração de diagnóstico, selecione "Logs de Salas Operacionais" para habilitar os logs para Salas.

Visão geral

Os logs operacionais de salas são registros de eventos e atividades que fornecem insights sobre suas solicitações de API de Salas. Eles capturam detalhes sobre o desempenho e a funcionalidade das Salas primitivas, incluindo o status de cada solicitação de Salas, bem como propriedades adicionais. Os logs operacionais das Salas contêm informações que ajudam a identificar tendências e padrões de uso das Salas.

Categorias de log

Os Serviços de Comunicação seguintes tipos de logs que você pode habilitar:

Logs de Salas Operacionais - fornecem informações básicas relacionadas ao serviço de Salas

Esquema de logs de Salas Operacionais

Propriedade	Descrição
`Correlation ID`	ID exclusiva da solicitação.
`Level`	O nível de severidade do evento.
`Operation Name`	A operação associada ao registro de log. Por exemplo, CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	A versão da API associada à operação.
`ResultType`	O status da operação.
`ResultSignature`	O substatus da operação. Se essa operação corresponder a uma chamada à API REST, esse campo será o código de status HTTP da chamada REST correspondente.
.`RoomId`	A ID da Sala.
`RoomLifeSpan`	O tempo de vida da Sala em minutos.
`AddedRoomParticipantsCount`	A contagem de participantes adicionados a uma Sala.
`UpsertedRoomParticipantsCount`	A contagem de participantes inseridos em uma Sala.
`RemovedRoomParticipantsCount`	A contagem de participantes removidos de uma Sala.
`TimeGenerated`	O carimbo de data/hora (UTC) de quando o log foi gerado.
`PstnDialOutEnabled`	Indica se uma sala tem a capacidade de fazer chamadas PSTN para convidar pessoas para uma reunião.

Exemplo de log do 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,
      }
    ]

Exemplo de log do 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",
      },
    ]

Exemplo de log do 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,
      },
    ]

Exemplo de log do 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",
      },
    ]

Exemplo de log do ListRooms

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

Exemplo de log do 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",
      },
    ]

(Consulte também Perguntas frequentes).

Compartilhar via