Referencia de datos para la supervisión de Azure Service Bus
Consulte Supervisión de Azure Service Bus para más información sobre la recopilación y el análisis de datos de supervisión de Azure Service Bus.
Nota:
Azure Monitor no incluye dimensiones en los datos de métricas exportados que se envían a un destino, como Azure Storage, Azure Event Hubs, Log Analytics, etc.
Métricas
En esta sección se indican todas las métricas de la plataforma recopiladas automáticamente para Azure Service Bus. El proveedor de recursos para estas métricas es Microsoft.ServiceBus/namespaces.
Solicitud de métricas
Cuenta el número de solicitudes de operaciones de datos y administración.
| Nombre de la métrica | Se puede exportar con la configuración de diagnóstico. | Unidad | Tipo de agregación | Descripción | Dimensions |
|---|---|---|---|---|---|
| Solicitudes entrantes | Sí | Count | Total | Número de solicitudes realizadas al servicio de Service Bus durante un período determinado. | EntityName |
| Solicitudes correctas | No | Count | Total | Número de solicitudes correctas realizadas al servicio de Service Bus durante un período determinado. | Nombre de entidad OperationResult |
| Errores del servidor | No | Count | Total | Número de solicitudes no procesadas debido a un error en el servicio de Service Bus durante un período determinado. | Nombre de entidad OperationResult |
| User Errors | No | Count | Total | Número de solicitudes no procesadas debido a errores de usuario durante un período determinado. | Nombre de entidad |
| Solicitudes limitadas | No | Count | Total | Número de solicitudes que se han limitado porque se superó el uso. La dimensión MessagingErrorSubCode tiene los siguientes valores posibles:
|
Nombre de entidad MessagingErrorSubCode |
| Recuento de operaciones de punto de comprobación pendientes | No | count | Average | Número de operaciones de punto de comprobación pendientes en el espacio de nombres. El servicio comienza a limitar cuando el recuento de puntos de comprobación pendientes supera el límite de (500 000 + (500 000 * unidades de mensajería)) operaciones. Esta métrica solo se aplica a los espacios de nombres de nivel Premium. | MessagingErrorSubCode |
| Latencia de envío del servidor | No | milisegundos | Average | Tiempo que tarda el servicio Service Bus en completar la solicitud. | Nombre de entidad |
Los dos tipos de errores siguientes se clasifican como errores de usuario:
- Errores en el cliente (en HTTP, serían errores 400).
- Errores que se producen al procesar los mensajes, como MessageLockLostException.
Métricas de mensaje
| Nombre de la métrica | Se puede exportar con la configuración de diagnóstico. | Unidad | Tipo de agregación | Descripción | Dimensions |
|---|---|---|---|---|---|
| Mensajes entrantes | Sí | Count | Total | Número de eventos o mensajes enviados a Service Bus durante un período determinado. En el caso de los niveles básico y estándar, los mensajes entrantes reenviados automáticamente se incluyen en esta métrica. Y, para el nivel Premium, no se incluyen. | Nombre de entidad |
| Mensajes salientes | Sí | Count | Total | Número de eventos o mensajes recibidos de Service Bus durante un período determinado. Los mensajes salientes reenviados automáticamente no se incluyen en esta métrica. | Nombre de entidad |
| error de Hadoop | No | Count | Average | Recuento de mensajes de una cola/tema. Esta métrica contiene mensajes en todo tipo de estados: activo, fallido, programado, etc. | Nombre de entidad |
| Mensajes activos | No | Count | Average | Recuento de mensajes activos de una cola/tema. Los mensajes activos son mensajes de la cola o la suscripción que tienen un estado activo y están listos para entregar. Los mensajes están disponibles para recibirlos. | Nombre de entidad |
| Mensajes fallidos | No | Count | Average | Recuento de mensajes fallidos de una cola/tema. | Nombre de entidad |
| Mensajes programados | No | Count | Average | Recuento de mensajes programados de una cola/tema. | Nombre de entidad |
| Mensajes completados | Sí | Count | Total | Número de mensajes completados durante un período especificado. | Nombre de entidad |
| Mensajes abandonados | Sí | Count | Total | Número de mensajes abandonados durante un período especificado. | Nombre de entidad |
| Size | No | Bytes | Average | Tamaño de una entidad (cola o tema) en bytes. | Nombre de entidad |
Importante
Los valores de mensajes, activos, fallidos, programados, completados y abandonados son valores de un momento dado. Es posible que los mensajes entrantes que se consumieron inmediatamente después de ese momento dado no se reflejen en estas métricas.
Nota
Cuando un cliente intenta obtener información sobre una cola o un tema, el servicio Service Bus devuelve información estática como el nombre, la hora de la última actualización, la hora de creación, si requiere sesión o no, etc., e información dinámica como el número de mensajes. Si la solicitud se limita, el servicio devuelve la información estática y la información dinámica vacía. Por eso, los recuentos de mensajes se muestran como 0 cuando se limita el espacio de nombres. Este comportamiento es así por diseño.
Métricas de conexión
| Nombre de la métrica | Se puede exportar con la configuración de diagnóstico. | Unidad | Tipo de agregación | Descripción | Dimensions |
|---|---|---|---|---|---|
| Conexiones activas | No | Count | Total | Número de conexiones activas en un espacio de nombres y en una entidad en el espacio de nombres. El valor de esta métrica es un valor de un momento dado. Es posible que las conexiones que estaban activas inmediatamente después de ese momento dado no se reflejen en esta métrica. | |
| Conexiones abiertas | No | Count | Average | Número de conexiones abiertas. El valor de esta métrica es una agregación e incluye todas las conexiones abiertas en el período de tiempo de agregación. | Nombre de entidad |
| Conexiones cerradas | No | Count | Average | Número de conexiones cerradas. El valor de esta métrica es una agregación e incluye todas las conexiones abiertas en el período de tiempo de agregación. | Nombre de entidad |
Métricas de uso de recursos
Nota
Estas métricas están disponibles solo con el nivel Premium.
Estas son las métricas importantes que supervisar en busca de posibles interrupciones de un espacio de nombres de nivel Premium: Uso de CPU por espacio de nombres y Uso del tamaño de memoria por espacio de nombres. Configure alertas para estas métricas usando Azure Monitor.
La otra métrica que se podría supervisar es: Solicitudes limitadas. Con todo, esto no debería ser un problema siempre y cuando el espacio de nombres permanezca dentro de sus límites de memoria, CPU y conexiones desacopladas correspondientes. Para más información, vea Limitación en el nivel Prémium de Azure Service Bus.
| Nombre de la métrica | Se puede exportar con la configuración de diagnóstico. | Unidad | Tipo de agregación | Descripción | Dimensions |
|---|---|---|---|---|---|
| Uso de CPU por espacio de nombres | No | CPU | Percent | Porcentaje de uso de CPU del espacio de nombres. | Réplica |
| Uso de tamaño de memoria por espacio de nombres | No | Uso de la memoria | Percent | Porcentaje de uso de memoria del espacio de nombres. | Réplica |
Métricas de error
| Nombre de la métrica | Se puede exportar con la configuración de diagnóstico. | Unidad | Tipo de agregación | Descripción | Dimensions |
|---|---|---|---|---|---|
| Errores del servidor | No | Count | Total | Número de solicitudes no procesadas debido a un error en el servicio de Service Bus durante un período determinado. | Nombre de entidad Resultado de la operación |
| Errores de usuario | No | Count | Total | Número de solicitudes no procesadas debido a errores de usuario durante un período determinado. | Nombre de entidad Resultado de la operación |
Dimensiones de métricas
Azure Service Bus admite las siguientes dimensiones para las métricas de Azure Monitor. La adición de dimensiones a las métricas es opcional. Si no agrega dimensiones, las métricas se especifican en el nivel de espacio de nombres.
| Nombre de dimensión | Descripción |
|---|---|
| Nombre de entidad | Service Bus admite las entidades de mensajería en el espacio de nombres. Con la métrica "Solicitudes entrantes", la dimensión Nombre de entidad tendrá un valor de "-NamespaceOnlyMetric-" además de todos los temas y colas. Esto representa la solicitud que se realizó a nivel de espacio de nombres. Algunos ejemplos incluyen una solicitud para enumerar todos los temas y colas en el espacio de nombres o las solicitudes a entidades que hayan producido un error en la autenticación o autorización. |
Registros del recurso
En esta sección se enumeran los tipos de registros de recursos que se pueden recopilar para Azure Service Bus.
- Registros operativos
- Registros de filtrado de IP y red virtual
- Registros de auditoría en entorno de ejecución
Azure Service Bus ahora tiene la capacidad de enviar registros a dos tablas de destino: Azure Diagnostic o tablas específicas de recursos en Log Analytics. Puede usar el botón de alternancia disponible en Azure Portal para elegir tablas de destino.
Registros operativos
Las entradas de registros operativos incluyen los elementos que aparecen en la tabla siguiente:
| Nombre | Descripción | Compatible con AzureDiagnostics | Compatible con AZMSOperationalLogs (tabla específica del recurso) |
|---|---|---|---|
ActivityId |
Identificador interno que se usa para identificar la actividad especificada. | Sí | Sí |
EventName |
Nombre de operación | Sí | Sí |
ResourceId |
El identificador de recursos de Azure Resource Manager | Sí | Sí |
SubscriptionId |
Id. de suscripción | Sí | Sí |
EventtimeString |
Tiempo de la operación | Sí | No |
TimeGenerated [UTC] |
Hora de la operación ejecutada (en UTC) | No | Sí |
EventProperties |
Propiedades de la operación | Sí | Sí |
Status |
Estado de la operación | Sí | Sí |
Caller |
Autor de la llamada de la operación (Azure Portal o Management Client) | Sí | Sí |
Provider |
Nombre del servicio que emite los registros, por ejemplo, ServiceBus | No | Sí |
Type |
Tipo de registros emitidos | No | Sí |
Category |
Categoría del registro | Sí | No |
Este es un ejemplo de una cadena JSON de registro operativo:
AzureDiagnostics:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"EventName": "Create Queue",
"resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
"SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
"EventTimeString": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"category": "OperationalLogs"
}
Entrada de tabla específica del recurso:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"EventName": "Retrieve Queue",
"resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
"SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
"TimeGenerated(UTC)": "9/28/2023 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"type": "AZMSOperationalLogs",
"Provider" : "SERVICEBUS"
}
Eventos y operaciones capturados en registros operativos
Los registros operativos capturan todas las operaciones de administración que se realizan en el espacio de nombres de Azure Service Bus. Las operaciones de datos no se capturan debido al elevado volumen de este tipo de operaciones que se realizan en Azure Service Bus.
Nota
Para que sea más fácil hacer un seguimiento de las operaciones de datos, se recomienda usar el seguimiento del lado cliente.
Estas operaciones de administración se capturan en los registros operativos:
| Ámbito | Operación |
|---|---|
| Espacio de nombres | - Crear espacio de nombres - Actualizar espacio de nombres - Eliminar espacio de nombres - Actualizar espacio de nombres - Recuperar espacio de nombres - Directiva de SharedAccess |
| Cola | - Crear cola - Actualizar cola - Eliminar cola - Cola de eliminación automática - Recuperar cola |
| Tema | - Crear tema - Actualizar tema - Eliminar tema - Eliminar tema de AutoDelete - Recuperar tema |
| Suscripción | - Crear suscripción - Actualizar suscripción - Eliminar suscripción - Suscripción de eliminación automática - Recuperar suscripción |
Nota:
Actualmente, no se realiza un seguimiento de las operaciones de lectura en los registros operativos.
Registros de filtrado de IP y red virtual
Las cadenas JSON del evento de conexión de red virtual (VNet) de Service Bus contienen los elementos enumerados en la tabla siguiente:
| Nombre | Descripción | Compatible con Azure Diagnostics | Compatible con AZMSVnetConnectionEvents (tabla específica del recurso) |
|---|---|---|---|
SubscriptionId |
Identificador de suscripción de Azure | Sí | Sí |
NamespaceName |
Nombre del espacio de nombres | Sí | Sí |
IPAddress |
Dirección IP de un cliente que se conecta al servicio de Service Bus | Sí | Sí |
AddressIP |
Dirección IP del cliente que se conecta a Service Bus | Sí | Sí |
TimeGenerated [UTC] |
Hora de la operación ejecutada (en UTC) | Sí | Sí |
Action |
Acción realizada por el servicio Service Bus al evaluar las solicitudes de conexión. Las acciones admitidas son Accept Connection (Aceptar conexión) y Deny Connection (Denegar conexión). | Sí | Sí |
Reason |
Proporciona el motivo de que se haya realizado la acción. | Sí | Sí |
Count |
Número de repeticiones de una acción dada. | Sí | Sí |
ResourceId |
Identificador de recursos de Azure Resource Manager. | Sí | Sí |
Category |
Categoría del registro | Sí | No |
Provider |
Nombre del servicio que emite los registros, por ejemplo, ServiceBus | No | Sí |
Type |
Tipo de registros emitidos | No | Sí |
Nota:
Los registros de red virtual solo se generan si el espacio de nombres permite el acceso desde redes seleccionadas o desde direcciones IP específicas (reglas de filtro de IP).
Este es un ejemplo de una cadena JSON de registro de red virtual:
AzureDiagnostics;
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Accept Connection",
"Reason": "IP is accepted by IPAddress filter.",
"Count": 1,
"ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
"Category": "ServiceBusVNetConnectionEvent"
}
Entrada de tabla específica del recurso:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"AddressIp": "1.2.3.4",
"Action": "Accept Connection",
"Message": "IP is accepted by IPAddress filter.",
"Count": 1,
"ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
"Provider" : "SERVICEBUS",
"Type": "AZMSVNetConnectionEvents"
}
Registros de auditoría en tiempo de ejecución
Los registros de auditoría en tiempo de ejecución capturan información de diagnóstico agregada de diversas operaciones de acceso al plano de datos (como enviar o recibir mensajes) en Service Bus.
Nota
Los registros de auditoría en tiempo de ejecución solo están disponibles actualmente en el nivel prémium.
Los registros de auditoría en tiempo de ejecución incluyen los elementos enumerados en la tabla siguiente:
| Nombre | Descripción | Compatible con Azure Diagnostics | Compatible con AZMSRuntimeAuditLogs (tabla específica del recurso) |
|---|---|---|---|
ActivityId |
UUID generado aleatoriamente que garantiza la unicidad de la actividad de auditoría. | Sí | Sí |
ActivityName |
Nombre de la operación en tiempo de ejecución. | Sí | Sí |
ResourceId |
El recurso asociado con la actividad. | Sí | Sí |
Timestamp |
Tiempo de agregación. | Sí | No |
time Generated (UTC) |
Tiempo agregado | No | Sí |
Status |
Estado de la actividad (éxito o error). | Sí | Sí |
Protocol |
Tipo de protocolar asociado a la operación. | Sí | Sí |
AuthType |
Tipo de autenticación (Microsoft Entra ID o directiva SAS). | Sí | Sí |
AuthKey |
Nombre de la directiva SAS o id. de aplicación de Microsoft Entra que se usan para autenticarse en un recurso. | Sí | Sí |
NetworkType |
Tipo de acceso de red: Public o Private. |
Sí | Sí |
ClientIP |
Dirección IP de la aplicación cliente. | Sí | Sí |
Count |
Número total de operaciones realizadas durante el período agregado de 1 minuto. | Sí | Sí |
Properties |
Metadatos específicos de la operación del plano de datos. | Sí | Sí |
Category |
Categoría de registro | Sí | No |
Provider |
Nombre del servicio que emite los registros, por ejemplo, ServiceBus | No | Sí |
Type |
Tipo de registros emitidos | No | Sí |
Este es un ejemplo de una entrada de registro de auditoría en tiempo de ejecución:
AzureDiagnostics:
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
"Time": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | HTTP | SBMP",
"AuthType": "SAS | AAD",
"AuthKey": "<AAD Application Name| SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Category": "RuntimeAuditLogs"
}
Entrada de tabla específica del recurso:
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
"TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | HTTP | SBMP",
"AuthType": "SAS | AAD",
"AuthKey": "<AAD Application Name| SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Provider": "SERVICEBUS",
"Type" : "AZMSRuntimeAuditLogs"
}
Registros de errores de diagnóstico
Los registros de errores de diagnóstico capturan mensajes de error para cualquier lado cliente, limitación y errores superados de cuota. Proporcionan diagnósticos detallados para la identificación de errores.
Los registros de errores de diagnóstico incluyen elementos enumerados en la tabla siguiente:
| Nombre | Descripción | Compatible con Azure Diagnostics | Compatible con AZMSDiagnosticErrorLogs (tabla específica del recurso) |
|---|---|---|---|
ActivityId |
UUID generado aleatoriamente que garantiza la unicidad de la actividad de auditoría. | Sí | Sí |
ActivityName |
Nombre de operación | Sí | Sí |
NamespaceName |
Nombre del espacio de nombres | Sí | sí |
EntityType |
Tipo de entidad | Sí | Sí |
EntityName |
Nombre de la entidad | Sí | Sí |
OperationResult |
Tipo de error en Operación (Clienterror o Serverbusy o quotaexceeded) | Sí | Sí |
ErrorCount |
Recuento de errores idénticos durante el período de agregación de 1 minuto. | Sí | Sí |
ErrorMessage |
Mensaje de error detallado | Sí | Sí |
Provider |
Nombre del servicio que emite los registros. Valores posibles: eventhub, relay y servicebus | Sí | Sí |
Time Generated (UTC) |
Hora de la operación | No | Sí |
EventTimestamp |
Tiempo de la operación | Sí | No |
Category |
Categoría de registro | Sí | No |
Type |
Tipo de registros emitidos | No | Sí |
Este es un ejemplo de entrada del registro de errores de diagnóstico:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"SubscriptionId": "<Azure Subscription Id",
"NamespaceName": "Name of Service Bus Namespace",
"EntityType": "Queue",
"EntityName": "Name of Service Bus Queue",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
"OperationResult": "ClientError",
"ErrorCount": 1,
"EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
"ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
"category": "DiagnosticErrorLogs"
}
Entrada de tabla específica del recurso:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"NamespaceName": "Name of Service Bus Namespace",
"EntityType": "Queue",
"EntityName": "Name of Service Bus Queue",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
"OperationResult": "ClientError",
"ErrorCount": 1,
"TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
"ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
"Type": "AZMSDiagnosticErrorLogs"
}
El 30 de septiembre de 2026, retiraremos el soporte técnico del protocolo SBMP para Azure Service Bus, por lo que ya no podrá usar este protocolo después del 30 de septiembre de 2026. Migre a las bibliotecas más recientes del SDK de Azure Service Bus mediante el protocolo AMQP, que ofrecen actualizaciones de seguridad críticas y funcionalidades mejoradas, antes de esa fecha.
Para obtener más información, consulte el anuncio de retirada de soporte técnico.
Tablas de registros de Azure Monitor
Azure Service Bus usa tablas de Kusto de registros de Azure Monitor. Puede consultar estas tablas con Log Analytics. Para ver una lista de las tablas de Kusto que usa el servicio, consulte Referencia de las tablas de Azure Monitor.
Pasos siguientes
- Para más información sobre la supervisión de Azure Service Bus, consulte Supervisión Azure Service Bus.
- Para más información sobre la supervisión de recursos de Azure, consulte Supervisión de recursos de Azure con Azure Monitor.