Información general de las métricas

Actualmente, Azure Communication Services proporciona métricas para todos los primitivos de Azure Communication Services. El Explorador de métricas de Azure se puede usar para trazar sus propios gráficos, investigar anomalías en los valores de métricas y comprender el tráfico de la API mediante los datos de métricas que emiten las solicitudes de correo electrónico.

Dónde encontrar las métricas

Las primitivas de Azure Communication Services emiten métricas sobre las solicitudes de API. Estas métricas se pueden encontrar en la pestaña Métricas del recurso de Communication Services. También puede crear paneles permanentes mediante la pestaña libros en el recurso de Communication Services.

Definiciones de métricas

Todas las métricas de las solicitudes de API contienen tres dimensiones que sirven para filtrar los datos de las métricas. Estas dimensiones se pueden agregar juntas mediante el tipo de agregación Count, y admiten todas las series temporales de agregación estándares de Azure, como Sum, Average, Min y Max.

Más información sobre los tipos de agregación admitidos y las agregaciones de series temporales en Características avanzadas del Explorador de métricas de Azure.

  • Operation: todas las operaciones o rutas a las que se puede llamar en la puerta de enlace de chat de Azure Communication Services.
  • Status Code: respuesta del código de estado enviada después de la solicitud.
  • StatusSubClass: la serie de código de estado enviada después de la respuesta.

Operaciones de las métricas de solicitudes de API de Chat

Las siguientes operaciones están disponibles en las métricas de solicitudes de API de Chat:

Operación/ruta Descripción
GetChatMessage Obtiene un mensaje por identificador de mensaje.
ListChatMessages Obtiene una lista de mensajes de chat de una conversación.
SendChatMessage Envía un mensaje de chat a una conversación.
UpdateChatMessage Actualiza un mensaje de chat.
DeleteChatMessage Elimina un mensaje de chat.
GetChatThread Obtiene una conversación de chat.
ListChatThreads Obtiene la lista de conversaciones de chat de un usuario.
UpdateChatThread Actualiza las propiedades de la conversación de chat.
CreateChatThread Crea una conversación de chat.
DeleteChatThread Elimina una conversación.
GetReadReceipts Obtiene confirmaciones de lectura de una conversación.
SendReadReceipt Envía un evento de confirmación de lectura a una conversación en nombre de un usuario.
SendTypingIndicator Publica un evento de escritura a una conversación en nombre de un usuario.
ListChatThreadParticipants Obtiene los miembros de una conversación.
AddChatThreadParticipants Agrega miembros a una conversación. Si ya existen, no se produce ningún cambio.
RemoveChatThreadParticipant Elimina un miembro de una conversación.

Screenshot of Chat API Request Metric.

Si se realiza una solicitud a una operación que no se reconoce, recibirá una respuesta de valor de "Ruta incorrecta".

Solicitudes de API de SMS

Las siguientes operaciones están disponibles en las métricas de solicitud de API de SMS:

Operación/ruta Descripción
SMSMessageSent envía un mensaje SMS.
SMSDeliveryReportsReceived Obtiene informes de entrega de SMS.
SMSMessagesReceived Obtiene mensajes SMS.

Screenshot of SMS API Request Metric.

Solicitudes de API de autenticación

Las siguientes operaciones están disponibles en las métricas de solicitudes de API de autenticación:

Operación/ruta Descripción
CreateIdentity Crea una identidad que representa a un solo usuario.
DeleteIdentity Elimina una identidad.
CreateToken Crea un token de acceso.
RevokeToken Revoca todos los tokens de acceso creados para una identidad antes de un tiempo dado.
ExchangeTeamsUserAccessToken Intercambiar un token de acceso de Microsoft Entra de un usuario de Teams para un nuevo token de acceso de Identidad de comunicación con una fecha de expiración coincidente.

Screenshot of authentication Request Metric.

Llamadas a solicitudes de API de Automation

Las siguientes operaciones están disponibles en las métricas de solicitud de la API de Automatización de llamadas:

Operación/ruta Descripción
Crear llamada Cree una llamada saliente al usuario.
Llamada de respuesta Responda a una llamada entrante.
Llamada de redirección Redirigir una llamada entrante a otro usuario.
Rechazar llamada Rechazar una llamada entrante.
Transferir llamada al participante Transferir 1:1 llamada a otro usuario.
Reproducir Reproducir audio para llamar a los participantes.
PlayPrompt Reproducir una solicitud a los usuarios como parte de la acción Reconocer.
Recognize Reconocer la entrada del usuario de los participantes de la llamada.
Agregar participantes Agregue un participante a una llamada.
Quitar participantes Quite un participante de una llamada.
Llamada de bloqueo Cuelga tu pierna de llamada.
Finalizar llamada Finalice la convocatoria para todos los participantes.
Obtener llamada Obtenga detalles sobre una llamada.
Obtener participante Obtenga detalles sobre un participante de la llamada.
Obtener participantes Obtener todos los participantes en una llamada.
Eliminar llamada Elimine una llamada.
Cancelar todas las operaciones multimedia Cancele todas las operaciones de medios en curso o en cola en una llamada.

Solicitudes de API del enrutador de trabajos

Las siguientes operaciones están disponibles en las métricas de solicitud de api del enrutador de trabajos:

Operación/ruta Descripción
UpsertClassificationPolicy Crea o actualiza una directiva de clasificación.
GetClassificationPolicy Recupera una directiva de clasificación existente por identificador.
ListClassificationPolicies Recupera las directivas de clasificación existentes.
DeleteDistributionPolicy Elimine una directiva de clasificación por identificador.
UpsertDistributionPolicy Crea o actualiza una directiva de distribución.
GetDistributionPolicy Recupera una directiva de distribución existente por identificador.
ListDistributionPolicies Recupera las directivas de distribución existentes.
DeleteDistributionPolicy Elimine una directiva de distribución por identificador.
UpsertExceptionPolicy Crea o actualiza una directiva de excepciones.
GetExceptionPolicy Recupera una directiva de excepción existente por identificador.
ListExceptionPolicies Recupera las directivas de excepción existentes.
DeleteExceptionPolicy Elimine una directiva de excepciones por identificador.
UpsertQueue Crea o actualiza una cola.
GetQueue Recupera una cola existente por identificador.
GetQueues Recupera las colas existentes.
DeleteQueue Elimine una cola por identificador.
GetQueueStatistics Recupera las estadísticas de una cola.
UpsertJob Crea o actualiza un trabajo.
GetJob Recupera un trabajo existente por identificador.
GetJobs Recupera los trabajos existentes.
DeleteJob Elimine una directiva de cola por identificador.
ReclasificarJob Reclasifique un trabajo.
CancelJob Envía la solicitud para cancelar un trabajo existente por identificador al proporcionar el motivo de cancelación de forma gratuita.
CompleteJob Completa un trabajo asignado.
CloseJob Cierra un trabajo completado.
AcceptJobOffer Acepta una oferta para trabajar en un trabajo y devuelve un 409/Conflicto si otro agente ya aceptó el trabajo.
DeclineJobOffer Rechaza una oferta para trabajar en un trabajo.
UpsertWorker Crea o actualiza un trabajo.
GetWorker Recupera un trabajo existente por identificador.
GetWorkers Recupera los trabajos existentes.
DeleteWorker Elimina un trabajo y todos sus seguimientos.

Solicitudes de API de Network Traversal

Las siguientes operaciones están disponibles en las métricas de solicitudes de API de Network Traversal:

Operación/ruta Descripción
IssueRelayConfiguration Emita la configuración de un servidor STUN/TURN.

Screenshot of TURN Token Request Metric.

Solicitudes de API de salas

Las siguientes operaciones están disponibles en las métricas de solicitud de la API de Rooms:

Operación/ruta Descripción
CreateRoom Crea una sala.
DeleteRoom Elimina una sala.
GetRoom Obtiene un room by Room ID.
PatchRoom Novedades un id. de habitación por habitación.
ListRooms Enumera todas las salas de un recurso de Azure Communication Services.
AddParticipants Agrega participantes a una sala.
RemoveParticipants Quita los participantes de una sala.
GetParticipants Obtiene la lista de participantes de una sala.
UpdateParticipants Novedades lista de participantes para una sala.

Screenshot of Rooms Request Metric.

Pasos siguientes