Supervisión de Azure Digital Twins con métricas

Las métricas descritas en este artículo ofrecen información sobre el estado de los recursos de Azure Digital Twins en la suscripción de Azure. Las métricas de Azure Digital Twins le ayudan a evaluar el estado general del servicio Azure Digital Twins y los recursos conectados a este. Estas estadísticas orientadas al usuario ayudan a ver lo que está ocurriendo con su instancia de Azure Digital Twins y a analizar las causas raíz de los problemas sin necesidad de ponerse en contacto con el Soporte técnico de Azure.

Las métricas están habilitadas de forma predeterminada. Puede ver las métricas de Azure Digital Twins desde Azure Portal.

Visualización de las métricas

  1. Cree una instancia de Azure Digital Twins. Encontrará instrucciones sobre cómo configurar una instancia de Azure Digital Twins en Configuración de una instancia y autenticación.

  2. Busque la instancia de Azure Digital Twins en Azure Portal (puede abrir la página correspondiente escribiendo su nombre en la barra de búsqueda del portal).

    En el menú de la instancia, seleccione Métricas.

    Screenshot showing the metrics page for Azure Digital Twins in the Azure portal.

    En esta página se muestran las métricas de la instancia de Azure Digital Twins. También puede crear vistas personalizadas de las métricas seleccionando las que quiera ver en la lista.

  3. Para elegir entre enviar los datos de las métricas a un punto de conexión de Event Hubs o a una cuenta de Azure Storage, seleccione Configuración de diagnóstico en el menú y, luego, Agregar configuración de diagnóstico.

    Screenshot showing the diagnostic settings page and button to add in the Azure portal.

    Para más información sobre este proceso, consulte Supervisión con registros de diagnóstico.

  4. Para optar por configurar alertas para los datos de métricas, seleccione Alertas en el menú y, a continuación, + Nueva regla de alerta. Screenshot showing the Alerts page and button to add in the Azure portal.

    Para más información sobre este proceso, consulte Supervisión con alertas.

Lista de métricas

Azure Digital Twins proporciona varias métricas para ofrecerle una visión general del estado de la instancia y de sus recursos asociados. También puede combinar información de varias métricas para conseguir una imagen más amplia del estado de la instancia.

En las tablas siguientes se describen las métricas de las que las instancias de Azure Digital Twins realizan un seguimiento y cómo se relaciona cada métrica con el estado general de la instancia.

Métricas para el seguimiento de los límites del servicio

Puede configurar estas métricas para que realicen un seguimiento cuando se acerque al límite del servicio publicado en algún aspecto de la solución.

Para configurar este seguimiento, use la característica de alertas de Azure Monitor. Asimismo, puede definir los umbrales de estas métricas para recibir una alerta cuando una métrica alcance un determinado porcentaje de su límite publicado.

Métrica Nombre para mostrar de la métrica Unidad Tipo de agregación Descripción Dimensions
TwinCount Recuento de gemelos (versión preliminar) Count Total Número total de gemelos de una instancia de Azure Digital Twins. Use esta métrica para determinar si se está aproximando al límite del servicio respecto al número máximo de gemelos permitido por instancia. None
ModelCount Recuento de modelos (versión preliminar) Count Total Número total de modelos de una instancia de Azure Digital Twins. Use esta métrica para determinar si se está aproximando al límite del servicio respecto al número máximo de modelos permitido por instancia. None

Métricas de solicitud de API

Métricas relacionadas con las solicitudes de API:

Métrica Nombre para mostrar de la métrica Unidad Tipo de agregación Descripción Dimensions
ApiRequests Solicitudes de API Count Total Número de solicitudes de API realizadas para las operaciones de lectura, escritura, eliminación y consulta de Digital Twins. Autenticación,
operación,
protocolo,
código de estado,
clase de código de estado,
Texto de estado
ApiRequestsFailureRate Tasa de errores de solicitudes de API Percent Average Porcentaje de solicitudes de API que el servicio recibe para la instancia que proporciona un código de respuesta de error interno (500) para las operaciones de lectura, escritura, eliminación y consulta de Digital Twins. Autenticación,
operación,
protocolo,
código de estado,
clase de código de estado,
Texto de estado
ApiRequestsLatency Latencia de solicitudes de API Milisegundos Average Tiempo de respuesta de las solicitudes de API. Este valor hace referencia a la hora desde la que Azure Digital Twins recibe la solicitud hasta que el servicio envía un resultado de éxito o error para las operaciones de lectura, escritura, eliminación y consulta de Digital Twins. Autenticación,
operación,
Protocolo

Métricas de facturación

Métricas relacionadas con la facturación:

Métrica Nombre para mostrar de la métrica Unidad Tipo de agregación Descripción Dimensions
BillingApiOperations Operaciones de la API de facturación Count Total Métrica de facturación para el recuento de todas las solicitudes de API realizadas en el servicio Azure Digital Twins. Meter ID
BillingMessagesProcessed Mensajes de facturación procesados Count Total Métrica de facturación para el número de mensajes enviados desde Azure Digital Twins a puntos de conexión externos.

Para que se considere un solo mensaje para su facturación, una carga no debe ser superior a 1 KB. Las cargas mayores que este límite se contarán como mensajes adicionales en incrementos de 1 KB (por lo que un mensaje de entre 1 y 2 KB se contará como dos mensajes; otro de entre 2 y 3 KB serán tres mensajes, etc.).
Esta restricción también se aplica a las respuestas, por lo que una llamada que devuelve 1,5 KB en el cuerpo de la respuesta, por ejemplo, se facturará como dos operaciones.
Meter ID
BillingQueryUnits Facturación de unidades de consulta Count Total Número de unidades de consulta, una medida del uso de recursos de servicio calculada internamente, que se consume para ejecutar consultas. También hay una API auxiliar disponible para medir las unidades de consulta: clase QueryChargeHelper. Meter ID

Para más información sobre la forma en que se factura Azure Digital Twins, consulte Precios de Azure Digital Twins.

Métricas de entrada

Métricas relacionadas con la entrada de datos:

Métrica Nombre para mostrar de la métrica Unidad Tipo de agregación Descripción Dimensions
IngressEvents Eventos de entrada Count Total Número de eventos de telemetría entrantes en Azure Digital Twins. Resultado
IngressEventsFailureRate Tasa de errores de los eventos de entrada Percent Average Porcentaje de eventos de telemetría entrantes para los que el servicio devuelve un código de respuesta de error interno (500). Resultado
IngressEventsLatency Latencia de eventos de entrada Milisegundos Average Hora a partir de la cual llega un evento cuando está listo para que Azure Digital Twins lo haga salir, momento en el que el servicio envía un resultado correcto o erróneo. Resultado

Métricas de enrutamiento

Métricas relacionadas con el enrutamiento:

Métrica Nombre para mostrar de la métrica Unidad Tipo de agregación Descripción Dimensions
MessagesRouted Mensajes enrutados Count Total Número de mensajes enrutados a un servicio de Azure de punto de conexión, como Event Hubs, Service Bus o Event Grid. Tipo de punto de conexión
Resultado
RoutingFailureRate Tasa de errores de enrutamiento Percent Average Porcentaje de eventos que producen un error a medida que se enrutan desde Azure Digital Twins a un servicio de Azure de punto de conexión, como Event Hubs, Service Bus o Event Grid. Tipo de punto de conexión
Resultado
RoutingLatency Latencia de enrutamiento Milisegundos Average Tiempo transcurrido entre el enrutamiento de un evento desde Azure Digital Twins hasta su publicación en el servicio de Azure de punto de conexión, como Event Hubs, Service Bus o Event Grid. Tipo de punto de conexión
Resultado

Dimensions

Las dimensiones ayudan a identificar más detalles sobre las métricas. Algunas de las métricas de enrutamiento proporcionan información por punto de conexión. En la tabla siguiente se enumeran los valores posibles para estas dimensiones.

Dimensión Valores
Autenticación OAuth
Operación (para las solicitudes de API) Microsoft.DigitalTwins/digitaltwins/delete,
Microsoft.DigitalTwins/digitaltwins/write,
Microsoft.DigitalTwins/digitaltwins/read,
Microsoft.DigitalTwins/eventroutes/read,
Microsoft.DigitalTwins/eventroutes/write,
Microsoft.DigitalTwins/eventroutes/delete,
Microsoft.DigitalTwins/models/read,
Microsoft.DigitalTwins/models/write,
Microsoft.DigitalTwins/models/delete,
Microsoft.DigitalTwins/query/action
Tipo de punto de conexión Event Grid,
Event Hubs,
Service Bus
Protocolo HTTPS
Resultado Correcto,
Error
Código de estado 200, 404, 500, etc.
Clase de código de estado 2xx, 4xx, 5xx, etc.
Texto de estado Error interno del servidor, No encontrado, etc.

Pasos siguientes

Para más información sobre la administración de las métricas registradas para Azure Digital Twins, consulte Supervisión con registros de diagnóstico.