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

  • Artigo

Os Serviços de Comunicação do Azure oferecem recursos de registro em log que você pode usar para monitorar e depurar sua solução de Serviços de Comunicação. Esses recursos podem ser configurados por meio do portal do Azure.

Importante

O seguinte refere-se aos logs habilitados por meio do Azure Monitor (consulte também Perguntas frequentes). Para habilitar esses logs para seus Serviços de Comunicações, consulte: Habilitar o registro em 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 dos Logs do Azure Monitor e das Métricas do Azure Monitor. Cada recurso do Azure requer sua própria configuração de diagnóstico, que define os seguintes critérios:

  • Categorias de logs e dados métricos enviados para os destinos definidos na configuração. As categorias disponíveis variam para diferentes tipos de recursos.
  • Um ou mais destinos para enviar os logs. Os destinos atuais incluem o espaço de trabalho do Log Analytics, Hubs de Eventos e Armazenamento do Azure.
  • Uma única configuração de diagnóstico não pode definir mais do que um de cada um dos destinos. Se você quiser enviar dados para mais de um tipo de destino específico (por exemplo, dois espaços de trabalho diferentes do Log Analytics), 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 do Azure Monitor para começar a criar logs e métricas para seus Serviços de Comunicações. Para obter documentação detalhada sobre como usar as Configurações de Diagnóstico em todos os recursos do Azure, consulte: Habilitar o registro em log nas Configurações de Diagnóstico

Nota

Em Nome da configuração de diagnóstico, selecione "Logs de salas operacionais" para ativar os logs de salas.

Descrição geral

Os logs operacionais de salas são registros de eventos e atividades que fornecem informações sobre suas solicitações de API de salas. Eles capturam detalhes sobre o desempenho e a funcionalidade do primitivo Rooms, incluindo o status de cada solicitação de Rooms, 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 registo

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

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

Esquema de logs das Salas Operacionais

Propriedade Description
Correlation ID ID exclusivo do pedido.
Level O nível de gravidade 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 api associada à operação.
ResultType O estado da operação.
ResultSignature O substatus da operação. Se essa operação corresponder a uma chamada de API REST, esse campo será o código de status HTTP da chamada REST correspondente.
.RoomId O ID do quarto.
RoomLifeSpan A vida útil do quarto em minutos.
AddedRoomParticipantsCount A contagem de participantes adicionada a uma sala.
UpsertedRoomParticipantsCount A contagem de participantes aumentou 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 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 registo 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",
      },
    ]

(Ver também Perguntas frequentes).