> 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 en temps réel les flux de données des appareils IoT à l'aide de l'Analyseur de données. Validez les valeurs des attributs, vérifiez l'intégrité des données et accédez aux vidages TCP et 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 transmettent 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 d'état 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 complète des valeurs (y compris les valeurs nulles)
* Vérifier les processus de transformation des données et les attributs calculés
* Accéder aux dumps TCP et aux journaux de nœuds pour des diagnostics techniques approfondis
* Croiser plusieurs sources de données pour identifier les problèmes d'intégration

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

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

1. Ouvrez IoT Logic. La page d’accueil s’ouvre avec la **Flux créés** tableau.
2. Cliquez sur le nom du flux que vous souhaitez analyser, ou ouvrez son **...** menu et sélectionnez **Modifier**. Le flux s'ouvre sur le canevas.
3. Cliquez sur le **Analyseur de données** onglet 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. Il s'agit du principal paramètre de regroupement, vous pourrez donc rechercher uniquement les appareils et attributs appartenant au flux choisi.

**Mode** : L'outil propose deux modes, et l'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** (bientôt disponible) : Ce mode affiche les journaux globaux, les dumps TCP et les journaux de nœuds dans le flux choisi. Il sera ajouté lors des prochaines itérations.

{% hint style="info" %}
Les options ci-dessus sont actuellement inactives et affichent 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

![Commandes 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 principales commandes de la vue tabulaire.

* **Commutateur d'exclusion des valeurs nulles** : Ce paramètre vous permet de basculer entre deux modes d'affichage des données :
  * **Coupé** : Affiche toutes les valeurs en fonction des paquets reçus du dispositif, y compris ceux pour lesquels 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 réellement été reçues des appareils pour l'attribut sélectionné, avec des valeurs valides et non nulles. Autrement dit, il filtre les données incomplètes.
* **Profondeur** : Cette commande détermine la profondeur des données historiques et définit l'intervalle 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 combien d'étapes vous souhaitez voir et vérifier comment les valeurs changent. Par exemple, si vous définissez depth=4, vous voyez les valeurs pour trois étapes dans le passé \[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 les mettre en pause.
* **Rechercher une valeur** : Ce champ est utilisé pour trouver une valeur spécifique parmi tous les attributs du tableau. Le maximum est de 100 caractères à rechercher. Par exemple, si vous vérifiez le fonctionnement des événements et recherchez un événement précis provenant d'un appareil et censé être déclenché, la valeur recherchée est mise en surbrillance.
* **Exporter** : Vous pouvez exporter tous les journaux à l'aide du bouton d'exportation afin de partager les informations avec d'autres spécialistes. Les informations seront au format JSON pour en faciliter la lecture.

### Bloc des appareils et 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 **Traceurs** 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 à surveiller](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 à surveiller](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 pour les 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 les noms d'attributs regrouperont les données de l'attribut choisi. Les informations collectées à la profondeur choisie pour cet attribut pour chaque appareil sont affichées ci-dessous.\
  La première colonne des lignes sous le nom de l'attribut, avec des nombres, indique la profondeur des valeurs. 0 correspond à 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 sur le moment où cet attribut a été généré par un appareil et sur le moment où 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)

Dès que de nouvelles valeurs sont 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, ce qui affiche 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 particulier. Vérifiez si d'autres attributs de cet appareil ont des valeurs ; si ce n'est pas le cas, assurez-vous que l'appareil est correctement connecté.
* Traceurs **#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 **latitude** et **longitude** attributs. Comme leurs coordonnées restent inchangées sur plusieurs **Profondeur** niveaux récents, les appareils sont immobiles. Cela est en outre confirmé par l' **en mouvement** attribut, dont la valeur est de **0**. À la lumière de ces observations, les données semblent exactes et mises à jour en temps réel.
* Appareil **STARLINK** n'a fourni des valeurs que 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

L'Analyseur de données conserve les dernières valeurs d'un appareil jusqu'à 30 jours après le message le plus récent provenant 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 **Traceurs** liste, mais ses colonnes dans le tableau restent vides jusqu'à ce qu'il transmette de nouveau. Cliquez sur **Lecture** pour surveiller les nouveaux messages et confirmer que l'appareil est de retour.

Les formules d'IoT Logic lisent les mêmes valeurs mises en cache, de sorte qu'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 période de 30 jours s'applique uniquement aux valeurs affichées par l'Analyseur de données. Elle ne limite pas l'historique des trajets et des événements de votre compte. Pour la conservation de cet historique, voir [Conservation 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.