Información general de las métricas

  • Artículo

Actualmente, Azure Communication Services ofrece métricas para todas las primitivas de Azure Communication Services. El Explorador de métricas de Azure puede usarse para trazar gráficos propios, investigar anomalías en los valores de las métricas y comprender el tráfico de las API mediante el uso de 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 de libros del 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.

Solicitudes de API de mensajería avanzada

Las siguientes operaciones están disponibles en las métricas de solicitudes de API de Mensajería avanzada:

Operación/ruta Descripción Escenario
DownloadMedia Descargue la solicitud de carga multimedia. La empresa solicitó descargar la carga multimedia.
ListTemplates Solicite plantillas de lista. La empresa solicitó enumerar plantillas para un canal determinado.
ReceiveMessage Mensaje recibido. El usuario envió un mensaje a la empresa.
SendMessage Envíe una solicitud de notificación de mensaje. La empresa solicita el envío de un mensaje al usuario.
SendMessageDeliveryStatus Estado de entrega recibido. La empresa recibió respuesta sobre un mensaje que solicitó enviar a un usuario.

Recorte de pantalla de la métrica de solicitud de mensajería avanzada.

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 Intercambie un token de acceso de Microsoft Entra de un usuario de Teams por un nuevo token de acceso de Communication Identity con una hora de expiración coincidente.

Recorte de pantalla de la métrica de solicitud de autenticación.

Solicitudes de la API de automatización de llamadas

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
Creación de una llamada Cree una llamada saliente al usuario.
Llamada de respuesta Responda a una llamada entrante.
Llamada de redirección Redirija una llamada entrante a otro usuario.
Rechazo de una llamada Rechace una llamada entrante.
Transferencia de llamada al participante Transfiera una llamada individual a otro usuario.
Reproducir Reproduzca el audio a todos los participantes.
PlayPrompt Reproduzca una solicitud a los usuarios como parte de la acción Reconocer.
Recognize Reconozca las entradas de usuario de los participantes de la llamada.
Adición de participantes Incorpore un participante a una llamada.
Eliminación de participantes Elimine un participante de una llamada.
HangUp Call Cuelgue el teléfono.
Finalización de una llamada Finalice la llamada para todos los participantes.
Obtención de una llamada Obtenga detalles sobre una llamada.
Obtención de un participante Obtenga detalles sobre un participante de la llamada.
Obtención de participantes Obtenga todos los participantes en una llamada.
Eliminación de una llamada Elimine una llamada.
Cancelación de todas las operaciones multimedia Cancele todas las operaciones multimedia en curso o en cola en una llamada.

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.

Recorte de pantalla de la métrica de solicitud de API de chat.

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

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.
ReclassifyJob Reclasifique un trabajo.
CancelJob Envía la solicitud para cancelar un trabajo existente por identificador al proporcionar el motivo de la 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 conflicto 409 si otro agente ya aceptó el trabajo.
DeclineJobOffer Rechaza una oferta para trabajar en un trabajo.
UpsertWorker Crea o actualiza un trabajador.
GetWorker Recupera un trabajador existente por identificador.
GetWorkers Recupera los trabajadores 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.

Recorte de pantalla de la métrica de solicitud de token TURN.

Solicitudes de API de salas

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

Operación/ruta Descripción
CreateRoom Crea una sala.
DeleteRoom Elimina una sala.
GetRoom Obtiene una sala por identificación de sala.
PatchRoom Actualiza una sala por identificación de sala.
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 Actualiza la lista de participantes de una sala.

Recorte de pantalla de la métrica de solicitud de salas.

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.

Recorte de pantalla de la métrica de solicitud de API de SMS.

Pasos siguientes