Diagnóstico y solución de problemas en el entorno de Azure Time Series Insights Gen1
Nota:
El servicio Time Series Insights (TSI) dejará de admitirse a partir de marzo de 2025. Considere la posibilidad de migrar los entornos de TSI existentes a soluciones alternativas lo antes posible. Para más información sobre la entrada en desuso y la migración, consulte nuestra documentación.
Precaución
Este es un artículo de Gen1.
En este artículo se describen algunos problemas que podría encontrar en el entorno de Azure Time Series Insights. Se ofrecen posibles causas y soluciones para la resolución.
Vídeo
Conozca los desafíos y las mitigaciones comunes de Azure Time Series Insights.
Problema: no se muestra ningún dato
Si no aparece ningún dato en el explorador de Azure Time Series Insights, considere estas causas comunes.
Causa A: los datos de origen del evento no tienen formato JSON
Azure Time Series Insights solo admite datos JSON. Para ver ejemplos de JSON, consulte Formas de JSON admitidas.
Causa B: a la clave de origen del evento le falta un permiso necesario
Para un centro de IoT en Azure IoT Hub, debe proporcionar la clave con los permisos de conexión de servicio. Seleccione la directiva iothubowner o service. Ambas tienen permisos de conexión de servicio.
Para un centro de eventos de Azure Event Hubs, debe proporcionar la clave con permisos de escucha. Servirán las directivas read y manage, dado que ambas tienen permisos de escucha.
Causa C: el grupo de consumidores proporcionado no es exclusivo de Azure Time Series Insights.
Al registrar un centro de IoT o un centro de eventos, es importante establecer el grupo de consumidores que quiere usar para leer los datos. Este grupo de consumidores no puede ser compartido. Si el grupo de consumidores es compartido, el centro de IoT o el centro de eventos subyacente desconectará automáticamente uno de los lectores de forma aleatoria. Proporcione un grupo de consumidores exclusivo que pueda leer Azure Time Series Insights.
Causa D: el entorno se ha aprovisionado recientemente
Los datos aparecerán en el Explorador de Azure Time Series Insights al cabo de unos minutos, después de que se creen por primera vez el entorno y sus datos.
Problema: se muestran algunos datos, pero faltan otros
Cuando los datos solo aparecen parcialmente y parece que están atrasados, tenga en cuenta estos posibles problemas.
Causa A: puede que se esté limitando el entorno
La limitación es un problema común cuando se aprovisionan entornos después de crear un origen de eventos que tiene datos. Azure IoT Hub y Azure Events Hubs almacenan datos durante siete días como máximo. Azure Time Series Insights siempre empieza con el evento más antiguo del origen de eventos (primero en entrar, primero en salir o FIFO).
Por ejemplo, si tiene 5 millones de eventos en un origen de eventos al conectarse a un único entorno S1 de Azure Time Series Insights, Azure Time Series Insights lee aproximadamente 1 millón de eventos al día. Podría parecer que Azure Time Series Insights está experimentando cinco días de latencia. Sin embargo, lo que sucede es que el entorno está limitado.
Si tiene los eventos antiguos en el origen de eventos, puede enfocarlo de dos maneras:
- Cambie los límites de retención del origen de eventos para ayudar a eliminar los eventos antiguos que no quiere que aparezcan en Azure Time Series Insights.
- Aprovisione un tamaño mayor de entorno (número de unidades) para aumentar el rendimiento de los eventos antiguos. Siguiendo con el ejemplo anterior, si aumenta ese mismo entorno de S1 a cinco unidades durante un día, debería actualizarse en el plazo de un día. Si la producción de eventos de estado estable es de 1 millón o menos eventos al día, puede reducir la capacidad de eventos a una unidad cuando Azure Time Series Insights se ponga al día.
El límite de aplicación se basa en el tipo y la capacidad de la SKU del entorno. Todos los orígenes de eventos del entorno comparten esta capacidad. Si el origen de eventos de la instancia de IoT Hub o del centro de evento inserta datos por encima de los límites exigidos, experimentará limitaciones y retrasos.
En la siguiente ilustración se muestra un entorno de Azure Time Series Insights con una SKU de S1 y una capacidad de 3. Este entorno registra 3 millones de eventos al día.
Imagine un entorno que ingiere mensajes de un centro de eventos. Tiene una tasa de entrada diaria de aproximadamente 67 000 mensajes. Esta velocidad se traduce aproximadamente en 46 mensajes por minuto.
- Si cada mensaje del centro de eventos se acopla a un evento de Azure Time Series Insights, no se produce ninguna limitación.
- Si cada mensaje del centro de eventos se acopla a 100 eventos de Azure Time Series Insights, se deben ingerir 4600 eventos por minuto.
Un entorno de SKU S1 que tiene una capacidad de 3 solo puede admitir la entrada de 2100 eventos por minuto (1 millón de eventos por día = 700 eventos por minuto por 3 unidades = 2100 eventos por minuto).
Para comprender de una manera más profunda cómo funciona la lógica de aplanamiento, consulte Formas JSON admitidas.
Resoluciones recomendadas para la limitación excesiva
Para corregir el retraso, aumente la capacidad de la SKU de su entorno. Para más información, consulte Escalado de su entorno de Azure Time Series Insights.
Causa B: la ingesta inicial de los datos históricos ralentiza la entrada
Si va a conectar un origen de eventos existente, es probable que su centro de eventos o instancia de IoT Hub ya contengan datos. El entorno comienza a extraer datos del principio del período de retención del mensaje de origen del evento. Este proceso predeterminado no se puede invalidar. Puede exponerse a limitaciones. La limitación puede tardar un rato en alcanzarse ya que ingiere datos históricos.
Resoluciones recomendadas para una ingesta inicial grande
Para corregir el retraso:
Aumente la capacidad de la SKU al valor máximo permitido (10 en este caso). Después de aumentar la capacidad, se inicia el proceso de entrada para ponerse al día mucho más rápidamente. El aumento de capacidad se le cobra. Para visualizar lo rápido que se pone al día, puede ver el gráfico de disponibilidad en el Explorador de Azure Time Series Insights.
Cuando se actualice el retraso, reduzca la capacidad de la SKU a la velocidad de entrada normal.
Problema: los datos se mostraban anteriormente, pero ya no lo hacen
Si Azure Time Series Insights ya no ingiere datos, pero se siguen transmitiendo eventos a IoT Hub o al centro de eventos, tenga en cuenta esta posible causa.
Causa A: se ha regenerado la clave de acceso del centro y su entorno necesita actualizarse.
Este problema se produce cuando la clave proporcionada al crear el origen del evento ya no es válida. Verá la telemetría en el centro, pero ningún mensaje de entrada recibido en Azure Time Series Insights. Si no sabe seguro si se ha regenerado la clave, puede buscar "Crear o actualizar reglas de autorización de espacio de nombres" en el registro de actividad de Event Hubs. Para un centro de IoT, busque "Crear o actualizar recursos de IotHub".
Para actualizar el entorno de Azure Time Series Insights con la nueva clave, abra el recurso del centro en Azure Portal y copie la nueva clave. Vaya a su recurso de Azure Time Series Insights y seleccione Event Sources (Orígenes de eventos):
Seleccione el origen o los orígenes de eventos en los que se ha detenido la ingesta, pegue la nueva clave y seleccione Guardar:
Problema: la configuración de nombre de propiedad timestamp del origen de eventos no funciona.
Asegúrese de que el valor de la propiedad timestamp que procede del origen del evento, como una cadena JSON, esté en el formato yyyy-MM-ddTHH:mm:ss.FFFFFFFK. Este es un ejemplo: 2008-04-12T12:53Z.
Recuerde que el nombre de la propiedad timestamp distingue mayúsculas de minúsculas.
La manera más fácil de asegurarse de que el nombre de la propiedad timestamp se captura y funciona correctamente consiste en utilizar el Explorador de Azure Time Series Insights. En el Explorador de Azure Time Series Insights, valiéndose del gráfico, seleccione un período de tiempo después de proporcionar el nombre de la propiedad timestamp. Haga clic con el botón derecho en la selección y, a continuación, seleccione la opción Explorar eventos.
El primer encabezado de columna debe ser el nombre de propiedad timestamp. Junto a la palabra Timestamp, se mostrará ($ts) .
No se mostrarán estos valores:
- (abc) : indica que Azure Time Series Insights está leyendo los valores de datos como cadenas.
- Icono de calendario: indica que Azure Time Series Insights está leyendo los valores de datos como valores datetime.
- # : indica que Azure Time Series Insights está leyendo los valores de datos como enteros.
Pasos siguientes
Más información sobre la mitigación de la latencia en Azure Time Series Insights.