> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md).

# Analyseur de données

Diagnostiquez les flux de données des appareils IoT en temps réel à l'aide de l'Analyseur de données. Validez les valeurs d'attribut, vérifiez l'intégrité des données et accédez aux dumps TCP ainsi qu'aux journaux des nœuds.

**Analyseur de données** est un outil spécialisé de dépannage qui fournit des diagnostics en temps réel pour la transmission des données des appareils IoT. Lorsque vos appareils ne remontent pas les données comme prévu, cet outil puissant permet une vérification et un débogage immédiats sur l'ensemble de votre flotte, quel que soit le fabricant ou le protocole. Pour résoudre efficacement les problèmes, vous pouvez :

* Effectuer des contrôles de santé en temps réel de la transmission des données des appareils sans intervention du fournisseur
* Déboguer des attributs spécifiques grâce à une analyse ciblée du flux de données
* Valider l'intégrité des données avec une journalisation exhaustive des valeurs (y compris les valeurs nulles)
* Vérifier les processus de transformation des données et les attributs calculés
* Accéder aux captures TCP et aux journaux de nœud pour des diagnostics techniques approfondis
* Recouper plusieurs sources de données pour identifier les problèmes d'intégration

Contrairement aux solutions classiques spécifiques à un fournisseur, **Analyseur de données** offre une compatibilité universelle des appareils et des capacités de dépannage à distance via une seule interface technique, ce qui réduit considérablement le temps et la complexité des diagnostics des appareils.

{% hint style="info" %}
Pour ouvrir Analyseur de données :

1. Ouvrez IoT Logic. La page de démarrage s'ouvre sur le **tableau des flux créés** .
2. Cliquez sur le nom du flux que vous souhaitez analyser, ou ouvrez son menu et sélectionnez **...** le menu **Modifier**. Le flux s'ouvre sur le canevas.
3. Cliquez sur l'onglet **Analyseur de données** en haut du canevas.
   {% endhint %}

![Vue de l'Analyseur de données](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-64233e70edebf9a9953d056d4c33d2d3aa1a3792%2FData_Analyzer_big.png?alt=media)

Examinons plus en détail toutes les possibilités et fonctions que vous pouvez trouver ici.

## Espace de travail principal

Les principales options de contrôle de l'outil Analyseur de données sont regroupées dans le menu supérieur.

**Flux de données** : Cette liste vous permet de sélectionner un flux déjà créé dans votre compte. C'est le principal paramètre de regroupement, vous pourrez donc rechercher uniquement les appareils et les attributs appartenant au flux choisi.

**Mode** : L'outil propose deux modes, et son affichage dépend du mode choisi.

* **Vue tabulaire** (par défaut) : Ce mode affiche les données décodées des appareils sous forme de tableau.
* **Journaux de flux** (à venir) : Ce mode affiche les journaux globaux, les captures TCP et les journaux de nœud dans le flux choisi. Il sera ajouté dans les prochaines itérations.

{% hint style="info" %}
Les options ci-dessus sont inactives pour le moment et contiennent les sélections par défaut. Elles deviendront disponibles avec de futures améliorations des fonctionnalités d'IoT Logic. Restez à l'écoute !
{% endhint %}

En cliquant sur le **Fermer** bouton, vous revenez à l'écran principal d'IoT Logic.

Examinons maintenant de plus près les sections de l'interface et les informations qu'elles contiennent.

## Vue tabulaire

### Barre de menu supérieure

![Contrôles de la barre de menu supérieure](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee5bbc0ade92cf35375b25b2265c0863fb7dd3b7%2FMenu_bar.png?alt=media)

Le menu supérieur contient les principaux contrôles de la vue tabulaire.

* **Exclure les valeurs nulles** : Ce réglage vous permet de basculer entre deux modes d'affichage des données :
  * **Désactivé** : Affiche toutes les valeurs selon les paquets reçus de l'appareil, y compris celles pour lesquelles l'attribut sélectionné a des valeurs nulles (manquantes). Ce mode fournit une vue complète de toutes les données des paquets.
  * **Activé** : Affiche uniquement les paquets pour lesquels des informations ont effectivement été reçues des appareils pour l'attribut sélectionné, avec des valeurs valides et non nulles. En d'autres termes, il filtre les données incomplètes.
* **Profondeur** : Ce contrôle est responsable de la profondeur des données d'historique et définit la plage des données récentes à afficher. Par exemple, combien d'étapes dans le passé devons-nous parcourir pour afficher les valeurs des attributs. Le maximum est de 12 étapes dans le passé. Vous pouvez choisir le nombre d'étapes que vous souhaitez voir et vérifier comment les valeurs évoluent. Par exemple, si vous définissez profondeur=4, vous voyez les valeurs des trois étapes précédentes \[3], \[2], \[1] et les dernières valeurs reçues \[0].
* **Lecture/Pause** : Ce bouton vous permet de commencer à recevoir les mises à jour des valeurs dans le tableau en temps réel, ou de mettre les mises à jour en pause.
* **Valeur de recherche** : Ce champ sert à rechercher une valeur spécifique parmi tous les attributs du tableau. La limite de recherche est de 100 caractères. Par exemple, si vous vérifiez le fonctionnement des événements et recherchez un événement spécifique provenant d'un appareil qui devrait être déclenché, la valeur recherchée est mise en surbrillance.
* **Exporter** : Vous pouvez exporter tous les journaux à l'aide du bouton d'exportation pour partager les informations avec d'autres spécialistes. Les informations seront au format JSON pour faciliter la lecture.

### Bloc des appareils et des attributs

Le bloc du menu de gauche contient une liste des appareils et des attributs appartenant au flux choisi. Pour passer d'une liste à l'autre, utilisez les **Appareils** et **Attribut** boutons en haut de la liste. Vous pouvez rechercher des appareils par ID et des attributs par leur nom.

{% columns %}
{% column %}
![Ajout d'appareils pour la surveillance](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-6cfc30f8c71afd682ac1c4271d064d10736039a5%2FDevices_list.png?alt=media)
{% endcolumn %}

{% column %}
![Ajout d'attributs pour la surveillance](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-08c305a53836a9e7766138a2e4c111f9a0c5ba1c%2FAttributes_list.png?alt=media)
{% endcolumn %}
{% endcolumns %}

Vous pouvez sélectionner jusqu'à 10 appareils. Une fois sélectionnés, tous les attributs pris en charge par ces appareils s'affichent, ce qui vous permet d'en choisir autant que vous le souhaitez à afficher dans le tableau. Seuls les attributs pertinents pour les appareils sélectionnés seront disponibles.

### Tableau des dernières valeurs d'attributs

Les informations sur les valeurs reçues pour les appareils et attributs choisis seront affichées dans ce tableau.

![Exemple de vue tabulaire](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1adb6be507b789d981673ac9eb1d73b1c9ea82f9%2FTable_example.png?alt=media)

Le tableau fournit les informations de la manière suivante :

* La ligne d'en-tête du tableau est une liste des appareils choisis pour la surveillance. Ces appareils deviennent des colonnes qui affichent les valeurs de chaque appareil.
* Les lignes portant le nom des attributs regrouperont les données de l'attribut choisi. Les informations collectées dans la profondeur choisie à partir de cet attribut pour chaque appareil sont affichées ci-dessous.\
  La première colonne des lignes situées sous le nom de l'attribut et contenant des nombres correspond à la profondeur des valeurs. 0 est la valeur actuelle, 1 la précédente, et ainsi de suite.

Lorsque vous survolez une valeur avec la souris, vous voyez des données supplémentaires indiquant quand cet attribut a été généré par un appareil et quand il a été reçu par la plateforme Navixy :

![Exemple d'horodatage de la valeur](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d715c21104434f1aabec1543cc579017752b9eb%2Fimage-20241204-160551.png?alt=media)

Une fois de nouvelles valeurs reçues d'un appareil, elles sont mises en surbrillance en vert pendant environ 2 secondes. Ainsi, vous voyez quel attribut sur quel appareil a été mis à jour. En cliquant sur une ligne d'appareil, vous la développez et affichez les valeurs historiques limitées par le réglage défini **Profondeur**.

#### Lecture du tableau

Interprétons les valeurs du tableau à l'aide de l'exemple de la capture d'écran ci-dessus et voyons quelles informations nous pouvons en tirer :

* Appareil **#1Teltonika FMB001** ne renvoie aucune valeur. Cela peut signifier que l'appareil ne peut pas fournir ce type de données précis. Vérifiez s'il existe d'autres attributs avec des valeurs pour cet appareil ; si ce n'est pas le cas, assurez-vous que l'appareil est correctement connecté.
* Appareils **#2Teltonika FMB001** - **#5Teltonika FMB001** renvoient des valeurs de manière cohérente, ce qui indique qu'ils sont correctement connectés. Leur position peut être déterminée à l'aide des attributs **latitude** et **longitude** . Comme leurs coordonnées restent inchangées sur plusieurs **Profondeur** niveaux **En mouvement** attribut, dont la valeur est **0**. D'après ces observations, les données semblent exactes et mises à jour en temps réel.
* Appareil **STARLINK** a fourni des valeurs pour un seul **Profondeur** niveau, ce qui suggère qu'il a été connecté récemment. L'absence de valeurs pour l' **En mouvement** attribut indique probablement que cet appareil ne dispose pas du capteur correspondant.

## Disponibilité des données

Analyseur de données conserve les dernières valeurs d'un appareil pendant 30 jours maximum après le message le plus récent de cet appareil. Navixy conserve les valeurs en mémoire pour des diagnostics rapides, et non dans un stockage à long terme.

Lorsqu'un appareil n'envoie rien pendant plus de 30 jours, Navixy supprime d'un coup toutes les valeurs mises en cache de cet appareil. L'appareil apparaît toujours dans la **Appareils** liste, mais ses colonnes dans le tableau restent vides jusqu'à ce qu'il remonte des données à nouveau. Cliquez sur **Lecture** pour surveiller l'arrivée de nouveaux messages et confirmer que l'appareil est de retour.

Les formules d'IoT Logic lisent les mêmes valeurs mises en cache ; ainsi, un appareil qui revient après plus de 30 jours de silence démarre sans historique. Pour plus de détails, voir [Syntaxe complète](/docs/user/fr/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#full-syntax).

La fenêtre de 30 jours s'applique uniquement aux valeurs que l'Analyseur de données affiche. Elle ne limite pas l'historique des trajets et des événements de votre compte. Pour la rétention de cet historique, voir [Rétention des données](/docs/user/fr/guide/account/data-retention.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/fr/guide/account/iot-logic/data-stream-analyzer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.