Exportation des journaux IoT Platform - IoT Platform - Centre de documentation Alibaba Cloud

Prérequis

Simple Log Service est activé. Pour plus d'informations, consultez la rubrique Prise en main de Simple Log Service.

Remarques d'utilisation

IoT Platform ne permet pas d'exporter ou de télécharger directement les fichiers de journaux. Pour obtenir, exporter ou sauvegarder les journaux IoT Platform, activez la fonctionnalité d'exportation des journaux afin d'exporter les journaux en temps réel vers un Logstore dans Simple Log Service pour leur interrogation, leur analyse et leur stockage à long terme.

La fonctionnalité d'exportation des journaux est disponible uniquement pour les comptes Alibaba Cloud.

L'exportation des journaux vers un Logstore dans Simple Log Service engendre des frais. Pour plus d'informations, consultez la rubrique Facturation de Simple Log Service.

Activation de l'exportation des journaux IoT Platform

Activez la fonctionnalité d'exportation des journaux individuellement pour chaque produit.

Connectez-vous à la console IoT Platform.
Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, choisissez O&M > Log Service.
Sélectionnez un produit et cliquez sur l'onglet Export IoT Platform Logs.
Cliquez sur Enable Now.
Dans la boîte de dialogue qui s'affiche, suivez les instructions pour activer l'exportation des journaux.

Remarque
Si Simple Log Service n'est pas activé, un clic sur

Enable Now

vous redirige vers la page permettant de l'activer.
1. Cliquez sur Create à côté de Role et de Log Export Destination.
  
  Remarque
  Si l'état
  
  Created
  
  s'affiche à côté de
  
  Role
  
  et de
  
  Log Export Destination
  
  , ignorez cette étape.
2. Cliquez sur OK.
Une fois l'exportation des journaux activée pour un produit, un emplacement de stockage des journaux et un rôle lié au service pour l'exportation des journaux sont automatiquement créés.
- Rôle lié au service pour l'exportation des journaux : ce rôle sert à accorder les autorisations d'exportation des journaux. Pour plus d'informations, consultez la rubrique Description du rôle.
- Emplacement de stockage des journaux :
  - Projet :iot-log-${uid}-${regionId}. Dans ce nom,${uid} correspond à l'ID de votre compte Alibaba Cloud, et ${regionId}à la région où réside votre service IoT Platform.
  - Logstore :iot-logs.
  Tous vos produits partagent cet emplacement de stockage. Les différents produits sont distingués par le mot-clé ProductKey dans le contenu des journaux. Pour plus d'informations sur les journaux, consultez la rubrique Journaux IoT Platform.
Définissez la période de conservation des données.

Les journaux exportés sont supprimés à l'issue de la période de conservation spécifiée. La période de conservation par défaut est de 7 jours. Définissez la période de conservation sur une valeur comprise entre 1 et 3000 jours, ou sélectionnez une conservation permanente.

Dans l'onglet Export IoT Platform Logs, cliquez sur Set Data Retention Period. Vous êtes redirigé vers la page de gestion du Logstore. Cliquez ensuite sur Modify, définissez la Data Retention Period, puis cliquez sur Save.

Utilisation de la fonctionnalité d'interrogation et d'analyse des journaux

Une fois l'exportation des journaux IoT Platform activée, effectuez les opérations suivantes dans l'onglet Export IoT Platform Logs :

Dans l'onglet Raw Logs :

Opération	Description
Interrogation et analyse des journaux	Dans l'onglet Raw Logs, utilisez des instructions SQL pour interroger les journaux sur une plage de temps donnée et effectuer une analyse statistique. Pour plus d'informations sur la syntaxe SQL, consultez les rubriques Syntaxe et fonctionnalités des requêtes et Syntaxe d'analyse.
Statistical Charts	Dans l'onglet Statistical Charts, consultez les graphiques statistiques générés.
LogReduce	Dans l'onglet LogReduce, regroupez les journaux présentant une forte similarité pour obtenir rapidement une vue d'ensemble de vos journaux.
Field Settings	Après avoir interrogé les journaux, analysez rapidement la distribution d'un champ spécifique dans les résultats de la requête.
Configure Alerts	Lorsqu'une alerte est déclenchée, le système envoie les informations d'alerte via des SMS, des appels vocaux, des e-mails et des robots DingTalk.

Dans l'onglet Log Reports :

Opération Description

Consultation des rapports

Consultez les rapports de journaux pour une plage de temps donnée. Les rapports de journaux affichent l'état opérationnel et les problèmes anormaux des appareils. Pour la liste des éléments inclus, consultez le Tableau 1. Descriptions des rapports.

Par défaut, les rapports affichent les données de la dernière heure, et la granularité temporelle des graphiques linéaires est d'une minute.

Cliquez sur la liste déroulante bleue de définition de l'heure dans le coin supérieur droit de la page, ou sur > Select Time Range dans le coin supérieur droit d'un rapport individuel pour définir la plage de temps.
Dans l'onglet Raw Logs, utilisez SQL pour définir la granularité temporelle des graphiques linéaires. Pour plus d'informations sur la syntaxe, consultez la rubrique Fonctions de date et d'heure.
Par exemple, utilisez 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 pour définir la granularité temporelle sur 1 heure.

Abonnement aux rapports Le système génère périodiquement des rapports sous forme d'images et les envoie aux personnes désignées par e-mail ou via des robots DingTalk.

Tableau 1. Descriptions des rapports
Rapport	Style d'affichage	Description
Nombre de connexions/déconnexions des appareils	Graphique linéaire	Affiche le nombre de fois où les appareils se sont connectés et déconnectés sur une plage de temps donnée.
Nombre de messages mobiles origination/termination	Graphique linéaire	Affiche le nombre de messages mobiles en origination et en termination sur une plage de temps donnée.
Top 20 des appareils par volume de messages mobiles origination/termination	Liste	Affiche les 20 appareils ayant le volume le plus élevé de messages mobiles en origination ou en termination, ainsi que les volumes de messages.
Distribution des codes d'erreur d'analyse des scripts de données	Camembert	Affiche la distribution des codes d'erreur survenus lors de l'analyse des scripts sur une plage de temps donnée. Interrogez les journaux par code d'erreur pour afficher les détails des erreurs d'analyse de script et optimiser vos scripts en conséquence.
Top 10 des appareils avec des erreurs d'analyse de script de données	Liste	Affiche les 10 appareils ayant le plus grand nombre d'erreurs d'analyse de script sur une plage de temps donnée, ainsi que leurs nombres d'erreurs correspondants. Interrogez les journaux par DeviceName de l'appareil pour afficher les détails des erreurs d'analyse de script et optimiser vos scripts en conséquence.
Distribution des codes d'erreur de validation du modèle Thing Specification Language (TSL)	Camembert	Affiche la distribution des codes d'erreur de validation du modèle TSL sur une plage de temps donnée. Interrogez les journaux par code d'erreur pour afficher les détails des erreurs de validation du modèle TSL et résoudre les problèmes.
Top 10 des appareils avec des erreurs de validation du modèle TSL	Liste	Affiche les 10 appareils ayant le plus grand nombre d'erreurs de validation du modèle TSL sur une plage de temps donnée, ainsi que leurs nombres d'erreurs correspondants. Interrogez les journaux par DeviceName de l'appareil pour afficher les détails des erreurs de validation du modèle TSL et résoudre les problèmes.
Volume de messages d'abonnement côté serveur	Graphique linéaire	Affiche le volume de messages transférés via les abonnements côté serveur AMQP et MNS sur une plage de temps donnée.
20 derniers enregistrements de messages d'appareils anormaux	Camembert	Affiche les 20 derniers enregistrements de messages d'appareils anormaux sur une plage de temps donnée. Interrogez les journaux par DeviceName de l'appareil et par code d'erreur pour afficher les détails des messages d'appareils anormaux et résoudre les problèmes.
Nombre de messages de transfert de données	Graphique linéaire	Affiche le volume de messages transférés vers d'autres services cloud sur une plage de temps donnée.
20 derniers enregistrements de transfert anormal du moteur de règles	Liste	Affiche les 20 derniers enregistrements de transfert anormal du moteur de règles sur une plage de temps donnée. Interrogez les journaux par DeviceName de l'appareil et par code d'erreur pour afficher les détails des transferts anormaux du moteur de règles et résoudre les problèmes.
Distribution des erreurs d'appel API cloud	Camembert	Affiche la distribution des erreurs d'appel API cloud sur une plage de temps donnée. Interrogez les journaux par nom d'API et utilisez les détails des journaux et les codes d'erreur pour résoudre les problèmes.

Désactivation de l'exportation des journaux IoT Platform

Désactivez la fonctionnalité d'exportation des journaux pour un produit spécifique à tout moment afin d'économiser de l'espace de stockage.

Dans la console IoT Platform, accédez à la page Instance Overview et cliquez sur la carte de l'instance cible.
Dans le volet de navigation de gauche, choisissez O&M > Log Service.
Sélectionnez un produit et cliquez sur l'onglet Export IoT Platform Logs.
Cliquez sur Disable Export, puis cliquez sur Confirm.

Une fois l'exportation des journaux désactivée pour le produit, les nouveaux journaux IoT Platform ne sont plus exportés vers le Logstore. Les journaux exportés sont conservés jusqu'à la fin de la période de conservation spécifiée, puis supprimés.