Registros de salas de Azure Communication Services

  • Artículo

Azure Communication Services ofrece funcionalidades de registro que sirven para supervisar y depurar la solución de Communication Services. Estas funcionalidades pueden configurarse mediante Azure Portal.

Importante

A continuación se hace referencia a los registros habilitados mediante Azure Monitor (consulte también las preguntas más frecuentes). Para habilitar estos registros para Communications Services, consulte Habilitación del registro en Configuración de diagnósticos.

Requisitos previos

Azure Communications Services proporciona características de supervisión y análisis a través de Información general de registros de Azure Monitor y Métricas de Azure Monitor. Cada recurso de Azure necesita su propia configuración de diagnóstico, que establece los siguientes criterios:

  • Categorías de los datos de los registros y las métricas que se envían a los destinos definidos en la configuración. Las categorías disponibles varían para los distintos tipos de recursos.
  • Uno o más destinos para enviar los registros. Los destinos actuales incluyen el área de trabajo de Log Analytics, Event Hubs y Azure Storage.
  • Cada configuración de diagnóstico puede definir un único destino. Si desea enviar datos a más de un tipo de destino determinado (por ejemplo, dos áreas de trabajo de Log Analytics diferentes), cree varias configuraciones. Cada recurso puede tener hasta cinco configuraciones de diagnóstico.

A continuación, se indican instrucciones para configurar el recurso Azure Monitor para empezar a crear registros y métricas para Communication Services. Puede encontrar documentación detallada sobre el uso de Configuración de diagnóstico en todos los recursos de Azure en Habilitación del registro en Configuración de diagnóstico

Nota:

En el nombre de la configuración de diagnóstico, seleccione "Registros de salas operativas" para habilitar los registros de Salas.

Información general

Los registros operativos de salas son registros de eventos y actividades que proporcionan información sobre las solicitudes de API de Salas. Capturan detalles sobre el rendimiento y la funcionalidad de la primitiva Salas, incluido el estado de cada solicitud de Salas, así como propiedades adicionales. Los registros operativos de salas contienen información que ayuda a identificar tendencias y patrones de uso de Salas.

Categorías de registro

Communication Services ofrece los siguientes tipos de registros que se pueden habilitar:

  • Registros operativos de salas : proporciona información básica relacionada con el servicio Salas

Esquema de registros operativos de Salas

Propiedad Descripción
Correlation ID Identificador único de la solicitud.
Level Nivel de gravedad del evento.
Operation Name Operación asociada al registro. Por ejemplo, CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
Operation Version Versión de API asociada a la operación.
ResultType Estado de la operación.
ResultSignature Subestado de la operación. Si esta operación se corresponde con una llamada API de REST, este campo es el código de estado HTTP de la llamada REST correspondiente.
.RoomId Identificador de la Sala.
RoomLifeSpan La vida útil de la Sala en cuestión de minutos.
AddedRoomParticipantsCount Recuento de participantes agregados a una Sala.
UpsertedRoomParticipantsCount El recuento de participantes en aumento en una Sala.
RemovedRoomParticipantsCount Recuento de participantes eliminados de una Sala.
TimeGenerated Marca de tiempo (UTC) de cuando se generó el registro.
PstnDialOutEnabled Indica si una sala tiene la capacidad de realizar llamadas RTC para invitar a personas a una reunión.

Ejemplo de registro de 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,
      }
    ]

Ejemplo de registro de 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",
      },
    ]

Ejemplo de registro de 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,
      },
    ]

Ejemplo de registro 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",
      },
    ]

Ejemplo de registro de ListRooms

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

Ejemplo de registro 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 también Preguntas más frecuentes).