Exportación de registros de IoT Platform - IoT Platform - Centro de documentación de Alibaba Cloud

Requisitos previos

Simple Log Service debe estar habilitado. Para obtener más información, consulte Get started with Simple Log Service.

Notas de uso

IoT Platform no admite la exportación ni la descarga directa de archivos de registro. Para obtener, exportar o respaldar los registros de IoT Platform, debe habilitar la función de exportación de registros. Esto permite enviarlos en tiempo real a un Logstore en Simple Log Service para su consulta, análisis y almacenamiento a largo plazo.

La función de exportación de registros solo está disponible para cuentas de Alibaba Cloud.

La exportación de registros a un Logstore en Simple Log Service genera costos. Para obtener más información, consulte Billing of Simple Log Service.

Habilitar la exportación de registros de IoT Platform

Debe habilitar la función de exportación de registros para cada producto de forma individual.

Inicie sesión en la consola de IoT Platform.
En la página Overview, localice la instancia que desea gestionar y haga clic en el ID o nombre de la instancia.
En el panel de navegación izquierdo, seleccione O&M > Log Service.
Seleccione un producto y haga clic en la pestaña Export IoT Platform Logs.
Haga clic en Enable Now.
En el cuadro de diálogo que aparece, siga las instrucciones para habilitar la exportación de registros.

Nota
Si Simple Log Service no está habilitado, al hacer clic en

Enable Now

se le redirigirá a la página donde puede habilitarlo.
1. Haga clic en Create junto a Role y Log Export Destination.
  
  Nota
  Si se muestra
  
  Created
  
  junto a
  
  Role
  
  y
  
  Log Export Destination
  
  , puede omitir este paso.
2. Haga clic en OK.
Después de habilitar la exportación de registros para un producto, se crean automáticamente una ubicación de almacenamiento de registros y un rol vinculado al servicio para dicha exportación.
- Rol vinculado al servicio para la exportación de registros: Este rol se utiliza para otorgar permisos de exportación de registros. Para obtener más información, consulte Role description.
- Ubicación de almacenamiento de registros:
  - Proyecto:iot-log-${uid}-${regionId}. En este nombre,${uid} es su ID de cuenta de Alibaba Cloud y ${regionId} es la región donde reside su servicio de IoT Platform.
  - Logstore:iot-logs.
  Todos sus productos comparten esta ubicación de almacenamiento. Los distintos productos se distinguen mediante la palabra clave ProductKey en el contenido del registro. Para obtener más información sobre los registros, consulte IoT Platform logs.
Establezca el periodo de retención de datos.

Los registros exportados se eliminan después del periodo de retención de datos especificado. El periodo de retención predeterminado es de 7 días. Puede configurar el periodo de retención con un valor de 1 a 3000 días, o bien seleccionar la retención permanente.

En la pestaña Export IoT Platform Logs, haga clic en Set Data Retention Period. Se le redirigirá a la página de gestión de Logstore. A continuación, haga clic en Modify, configure el Data Retention Period y haga clic en Save.

Uso de la función de consulta y análisis de registros

Una vez habilitada la exportación de registros de IoT Platform, puede realizar las siguientes operaciones en la pestaña Export IoT Platform Logs:

En la pestaña Raw Logs:

Operación	Descripción
Consulta y análisis de registros	En la pestaña Raw Logs, utilice sentencias SQL para consultar registros dentro de un rango de tiempo específico y realizar análisis estadísticos. Para obtener más información sobre la sintaxis SQL, consulte Query syntax and features y Analysis syntax.
Statistical Charts	En la pestaña Statistical Charts, consulte los gráficos estadísticos generados.
LogReduce	En la pestaña LogReduce, agrupe registros con alta similitud para obtener rápidamente una visión general de sus registros.
Field Settings	Después de consultar los registros, analice rápidamente la distribución de un campo específico en los resultados de la consulta.
Configure Alerts	Cuando se activa una alerta, el sistema envía información de alerta mediante métodos como mensajes de texto, llamadas de voz, correos electrónicos y robots de DingTalk.

En la pestaña Log Reports:

Operación Descripción

Ver informes

Consulte informes de registros para un rango de tiempo específico. Los informes de registros muestran el estado operativo y los problemas anómalos de los dispositivos. Para ver una lista de los elementos incluidos, consulte la Tabla 1. Descripciones de informes.

De forma predeterminada, los informes muestran datos de la última hora, y la granularidad temporal para los gráficos de líneas es de 1 minuto.

Puede hacer clic en la lista desplegable azul de configuración de tiempo en la esquina superior derecha de la página, o bien hacer clic en > Select Time Range en la esquina superior derecha de un informe individual para establecer el rango de tiempo.
En la pestaña Raw Logs, utilice SQL para establecer la granularidad temporal de los gráficos de líneas. Para obtener más información sobre la sintaxis, consulte Date and time functions.
Por ejemplo, utilice bizCode:device | SELECT date_format(date_trunc('hour',__time__), '%m-%d %H:%i') AS Time, count(1) AS count , operation GROUP BY Time, operation ORDER BY Time limit 1440 para establecer la granularidad temporal en 1 hora.

Subscribe to Reports El sistema genera periódicamente imágenes de los informes y las envía al personal especificado por correo electrónico o a través de robots de DingTalk.

Tabla 1. Descripciones de informes
Informe	Estilo de visualización	Descripción
Recuento de dispositivos en línea/fuera de línea	Gráfico de líneas	Muestra el número de veces que los dispositivos se conectaron y desconectaron dentro de un rango de tiempo específico.
Número de mensajes originados/terminados en móvil	Gráfico de líneas	Muestra el número de mensajes originados y terminados en móvil dentro de un rango de tiempo específico.
20 principales dispositivos por volumen de mensajes originados/terminados en móvil	Lista	Muestra los 20 dispositivos con mayor volumen de mensajes originados o terminados en móvil, junto con sus respectivos volúmenes de mensajes.
Distribución de códigos de error del script de análisis de datos	Gráfico circular	Muestra la distribución de códigos de error ocurridos durante el análisis del script dentro de un rango de tiempo específico. Puede consultar registros por código de error para ver los detalles de los errores de análisis del script y optimizar sus scripts en consecuencia.
10 principales dispositivos con errores en el script de análisis de datos	Lista	Muestra los 10 dispositivos con más errores de análisis de script dentro de un rango de tiempo específico y sus recuentos de errores correspondientes. Puede consultar registros por DeviceName del dispositivo para ver los detalles de los errores de análisis del script y optimizar sus scripts en consecuencia.
Distribución de códigos de error de validación del modelo TSL (Thing Specification Language)	Gráfico circular	Muestra la distribución de códigos de error de validación del modelo TSL dentro de un rango de tiempo específico. Puede consultar registros por código de error para ver los detalles de los errores de validación del modelo TSL y solucionar los problemas.
10 principales dispositivos con errores de validación del modelo TSL	Lista	Muestra los 10 dispositivos con más errores de validación del modelo TSL dentro de un rango de tiempo específico y sus recuentos de errores correspondientes. Puede consultar registros por DeviceName del dispositivo para ver los detalles de los errores de validación del modelo TSL y solucionar los problemas.
Volumen de mensajes de suscripción del lado del servidor	Gráfico de líneas	Muestra el volumen de mensajes reenviados a través de suscripciones del lado del servidor AMQP y MNS dentro de un rango de tiempo específico.
Últimos 20 registros de mensajes anómalos de dispositivos	Gráfico circular	Muestra los últimos 20 registros de mensajes anómalos de dispositivos dentro de un rango de tiempo específico. Puede consultar registros por DeviceName del dispositivo y código de error para ver los detalles de los mensajes anómalos y solucionar los problemas.
Número de mensajes de reenvío de datos	Gráfico de líneas	Muestra el volumen de mensajes reenviados a otros servicios en la nube dentro de un rango de tiempo específico.
Últimos 20 registros anómalos de reenvío del motor de reglas	Lista	Muestra los últimos 20 registros anómalos de reenvío del motor de reglas dentro de un rango de tiempo específico. Puede consultar registros por DeviceName del dispositivo y código de error para ver los detalles del reenvío anómalo del motor de reglas y solucionar los problemas.
Distribución de errores de llamada a API en la nube	Gráfico circular	Muestra la distribución de errores de llamada a API en la nube dentro de un rango de tiempo específico. Puede consultar registros por nombre de API y utilizar los detalles del registro y los códigos de error para solucionar los problemas.

Deshabilitar la exportación de registros de IoT Platform

Puede deshabilitar la función de exportación de registros para un producto específico en cualquier momento para ahorrar espacio de almacenamiento.

En la consola de IoT Platform, vaya a la página Instance Overview y haga clic en la tarjeta de la instancia objetivo.
En el panel de navegación izquierdo, seleccione O&M > Log Service.
Seleccione un producto y haga clic en la pestaña Export IoT Platform Logs.
Haga clic en Disable Export y luego en Confirm.

Después de deshabilitar la exportación de registros para el producto, los nuevos registros de IoT Platform dejarán de exportarse al Logstore. Los registros ya exportados se conservarán hasta que finalice el periodo de retención de datos especificado y luego se eliminarán.