Solución de problemas de Azure Stream Analytics mediante registros de recursos

En ocasiones, un trabajo de Azure Stream Analytics deja de procesarse inesperadamente. Los errores pueden deberse a un resultado de consulta inesperado, la conectividad a los dispositivos o una interrupción inesperada del servicio. Los registros de recursos de Azure Stream Analytics pueden ayudarle a identificar la causa de estos errores y reducir el tiempo de recuperación.

Habilitar los registros de recursos para todos los trabajos de Stream Analytics para facilitar la depuración y la supervisión.

Tipos de registro de Stream Analytics

Stream Analytics ofrece dos tipos de registros:

• Registros de actividad (siempre activados), que proporcionan información sobre las operaciones realizadas en los trabajos.

• Registros de recursos (configurables), que proporcionan información más completa sobre todo lo que ocurre con un trabajo. Los registros de recursos comienzan cuando se crea la tarea y finalizan cuando se elimina. Abarcan los eventos que ocurren cuando se actualiza la tarea y durante su ejecución.

Depuración de trabajos de Stream Analytics mediante registros de actividad

Los registros de actividad están activados de forma predeterminada y proporcionan conclusiones de alto nivel sobre las operaciones realizadas por el trabajo de Stream Analytics. La información presente en los registros de actividad puede ayudar a encontrar la causa principal de los problemas que afectan al trabajo. Para usar registros de actividad en Stream Analytics, siga estos pasos:

1. Inicie sesión en Azure Portal y seleccione Registro de actividad en Introducción.

   

2. Puede ver una lista de operaciones que se han realizado. Cualquier operación que haya hecho que su tarea fallara tiene una burbuja informativa roja.

3. Seleccione una operación para ver su vista de resumen. La información aquí suele ser limitada. Para más información acerca de la operación, seleccione JSON.

   

4. Desplácese hacia abajo hasta la sección Propiedades del código JSON, que proporciona los detalles del error que provocó el error de la operación. En este ejemplo, el fallo se debió a un error en tiempo de ejecución causado por valores de latitud fuera de los límites permitidos. Una discrepancia en los datos que procesa un trabajo de Stream Analytics provoca un error de datos. Puede obtener información sobre diferentes errores de entrada y salida de datos y por qué se producen.

   

5. Realice acciones correctivas en función del mensaje de error en JSON. En este ejemplo, agregue comprobaciones para asegurarse de que el valor de latitud está entre -90 grados y 90 grados.

6. Si el mensaje de error en los registros de actividad no resulta útil para identificar la causa raíz, habilite los registros de recursos y utilice los registros de Azure Monitor.

Envío de diagnósticos de Stream Analytics a registros de Azure Monitor

Habilite los registros de recursos y envíelos a los registros de Azure Monitor. Los registros de recursos están desactivados de forma predeterminada.

1. Cree un área de trabajo de Log Analytics, en caso de que no tenga una. Coloque el área de trabajo de Log Analytics en la misma región que el trabajo de Stream Analytics.

2. Inicie sesión en Azure Portal y vaya al trabajo de Stream Analytics. En Supervisión, seleccione Registros de diagnóstico. Después, seleccione Activar diagnósticos.

   

3. Indique un Nombre en Nombre de la configuración de diagnóstico y marque las casillas Ejecución y Edición debajo de log, y AllMetrics debajo de metric. Después, seleccione Enviar a Log Analytics y elija su área de trabajo. Seleccione Guardar.

   

4. Cuando se inicia el trabajo de Stream Analytics, los registros de recursos se envían a su área de trabajo de Log Analytics. Para ver los registros de recursos del trabajo, seleccione Registros en la sección Supervisión.

   

5. Stream Analytics proporciona consultas predefinidas que le permiten buscar fácilmente los registros que le interesan. Puede seleccionar las consultas predefinidas en el panel izquierdo y, a continuación, seleccionar Ejecutar. Verá los resultados de la consulta en el panel inferior.

   

Categorías de registro de recursos de Stream Analytics

Azure Stream Analytics captura dos categorías de registros de recursos:

• Creación: Captura registros de eventos relacionados con operaciones de creación de trabajos, como creación de trabajos, adición y eliminación de entradas y salidas, adición y actualización de la consulta, e inicio y detención del trabajo.

• Ejecución: Captura los eventos que se producen durante la ejecución del trabajo.

  • Errores de conectividad
  • Errores de procesamiento de datos, como por ejemplo:
    • Eventos que no se ajustan a la definición de consulta (tipos y valores de campo no coincidentes, campos ausentes, etc.)
    • Errores de evaluación de expresión
  • Otros eventos y errores

Todos los registros se almacenan en formato JSON. Para obtener información sobre el esquema de los registros de recursos, consulte Esquema de registros de recursos.

Pasos siguientes

• Errores de datos de Stream Analytics
• Referencia de lenguaje de consulta de Stream Analytics