Información general de las métricas

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.

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.

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.

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.

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.

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.

Pasos siguientes

• Más información sobre las Métricas de la plataforma de datos.