> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/retrieve-platform-logs.md).

# Récupérer les journaux de la plateforme

Depuis la console d'administration, trouvez, filtrez et exportez les journaux de la plateforme The Wallet Crew, et retrouvez les routes de l'API Insights et de MCP pour des requêtes répétables.

Les journaux de la plateforme retracent l’activité de la plateforme pour un locataire. Ils couvrent les rendus de Carte, les push planifiées, les appels de connecteur, les rechargements de configuration et les imports en échec.

Les journaux sont disponibles via trois systèmes :

| Système                      | Idéal pour                                                                              | Accès                                                     |
| ---------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| **Console d’administration** | Recherches rapides, support quotidien et exportations CSV                               | Un compte de la console d’administration                  |
| **API Insights**             | Requêtes reproductibles, agrégation et pipelines BI                                     | Une clé API avec `tenant.insights:read`                   |
| **MCP**                      | Des investigations en langage courant dans les journaux, la configuration et les Cartes | Un compte de la console d’administration et un client MCP |

<details>

<summary><strong>Exemples concrets</strong></summary>

* Un agent du support vérifie si une notification push a quitté la plateforme.
* Un ingénieur d’intégration retrace un appel d’API en échec à l’aide de son identifiant d’opération.
* Une équipe opérations compte les erreurs de composants avant d’escalader un incident.
* Un assistant IA enquête sur un incident et résume les lignes de journal pertinentes.

</details>

## Source de données de journaux partagée

La console d’administration, l’API Insights et MCP lisent tous la même `table Journaux` . Chaque requête est limitée à un seul locataire. Les données d’un autre locataire sont inaccessibles.

Les journaux de la plateforme sont conservés pendant **45 jours**. Les lignes plus anciennes ne peuvent pas être récupérées, alors exportez avant cette échéance les preuves nécessaires pour les audits, post-mortems ou litiges. Les événements Wallet dans `Événements` restent disponibles indéfiniment.

{% hint style="warning" %}
Les journaux de la plateforme peuvent contenir des identifiants, des chemins de requête, des agents utilisateurs et des charges utiles d’erreur. Traitez-les comme des données opérationnelles sensibles. Partagez des extraits, pas des exportations, et uniquement avec les personnes qui en ont besoin.
{% endhint %}

## Ce qu’un enregistrement de journal contient

Chaque route expose le même enregistrement. La console d’administration affiche un sous-ensemble de ces colonnes (Horodatage, Message, Nom de l’opération, ID d’opération, Gravité, Agent utilisateur, Catégorie, Propriétés). L’API Insights et MCP exposent toutes les colonnes. Les principales sont listées ci-dessous.

| Colonne                             | Type     | Ce qu’elle contient                                                          |
| ----------------------------------- | -------- | ---------------------------------------------------------------------------- |
| `Horodatage`                        | datetime | Quand la ligne a été émise, en UTC                                           |
| `Message`                           | string   | Message rendu lisible par l’humain                                           |
| `SeverityLevel`                     | int      | Niveau de gravité ; voir ci-dessous                                          |
| `CategoryName`                      | string   | Composant de plateforme émetteur, comme le composant Wallet Apple            |
| `OperationName`                     | string   | Opération active, comme `HTTP POST /api/mcp` ou le nom d’une tâche planifiée |
| `OperationId`                       | string   | Identifiant de corrélation pour suivre une requête de bout en bout           |
| `RequestId`                         | string   | Identifiant de requête individuel au sein d’une opération                    |
| `Properties`                        | dynamic  | Champs structurés, tels que `requestPath` et `originalFormat`                |
| `UserAgent`                         | string   | Client déclencheur, le cas échéant                                           |
| `UserId` / `UserName` / `SessionId` | string   | Contexte de l’acteur, lorsqu’il est attribué                                 |
| `TenantId`                          | string   | Identifiant du locataire actuel                                              |
| `Id`                                | guid     | Identifiant unique de l’enregistrement                                       |

Le préfixe `neostore` est l’ancien nom de la plateforme et est conservé dans les identifiants techniques.

### Niveaux de gravité

`SeverityLevel` est stocké sous forme de nombre. La console d’administration affiche un badge libellé.

| Valeur | Libellé       | Lisez-le comme                                                    |
| ------ | ------------- | ----------------------------------------------------------------- |
| `0`    | Verbeux       | Détail de bas niveau, rarement émis                               |
| `1`    | Informations  | Fonctionnement normal et la majeure partie du volume des journaux |
| `2`    | Avertissement | Quelque chose a été récupéré, dégradé ou réessayé                 |
| `3`    | Erreur        | Une opération a échoué                                            |
| `4`    | Critique      | Une défaillance à l’impact étendu                                 |

{% hint style="info" %}
Les locataires sains génèrent de nombreuses `Informations` lignes. Filtrez sur `SeverityLevel >= 2` avant de tirer des conclusions.
{% endhint %}

## Console d’administration : journaux d’application

La **page Journaux d’application** est la voie la plus rapide pour le travail de support.

La page nécessite l’ `tenant.insights:read` autorisation. Elle affiche aussi ce que les scripts du locataire écrivent avec `console`: recherchez `Neo.Scripting`, le début de la catégorie de ces lignes. `console.info`, `console.warn` et `console.error` sont journalisés comme Information, Avertissement et Erreur. `console.log` est journalisé au niveau Debug (affiché comme **Verbeux** dans le tableau des niveaux de gravité), en dessous du niveau Information que la plateforme conserve par défaut, utilisez donc `console.info` pour trouver des lignes ici.

{% stepper %}
{% step %}

### Ouvrez la page

Dans la console d’administration, ouvrez **Paramètres → Surveillance → Journaux**.

```
https://admin.thewalletcrew.io/tenant/~/settings/tools/logs
```

La `~` résout vers le locataire actuel de l’utilisateur connecté. Ce lien peut être partagé sans modification.
{% endstep %}

{% step %}

### Définissez la période

Le sélecteur de date est par défaut sur **Les 30 derniers jours**. Les préréglages incluent Aujourd’hui, Les 7 derniers jours, Cette semaine, Les 30 derniers jours, Ce mois-ci, Cette année, Le mois dernier, Les 3 derniers mois, Les 12 derniers mois, L’année dernière et Toute la période. Une plage **Personnalisée** est également disponible.

Les plages plus larges que la fenêtre de rétention ne renvoient rien au-delà. Réduisez d’abord la période.
{% endstep %}

{% step %}

### Rechercher

La zone de recherche correspond au texte dans chaque colonne, y compris `Properties`. Il n’y a pas de sélecteur de champ.

Les termes de recherche utiles incluent un numéro de série de Carte, un `OperationId`, un fragment d’erreur, ou un chemin de requête tel que `/api/mcp`.

Le terme est enregistré dans l’adresse sous la forme `?search=...`. Une vue filtrée peut donc être partagée telle quelle.
{% endstep %}

{% step %}

### Lire les résultats

Les résultats sont classés du plus récent au plus ancien. L’ **Horodatage** en-tête modifie l’ordre de tri. Développez une **Properties** cellule pour afficher les champs structurés.

Copiez un **ID d’opération** et recherchez-le pour suivre une requête. Chaque ligne écrite pendant cette requête partage l’identifiant.
{% endstep %}

{% step %}

### Exporter

**Exporter les journaux** télécharge la vue actuelle au format CSV, limitée à **10 000 lignes**. Réduisez la période et le terme de recherche avant d’exporter.

Utilisez l’ [API Insights](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/insights-api.md) API Insights et MCP pour des exports plus volumineux ou récurrents, et paginez les résultats avec `row_number()`.
{% endstep %}
{% endstepper %}

## API Insights et MCP

La [API Insights](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/insights-api.md) interroge les données de journaux partagées avec [Kusto Query Language (KQL)](https://learn.microsoft.com/en-us/kusto/query/). La page Développeurs est la référence pour l’authentification, les hôtes, les limites, les tables, les colonnes, les requêtes paramétrées et la pagination. Elle explique aussi comment un assistant IA connecté à MCP exécute les mêmes requêtes, avec des modèles de prompt.

Chaque table utilise **PascalCase** noms de colonnes, `table Journaux` et `Événements` y compris. KQL est sensible à la casse, donc `timestamp` ne fonctionne pas là où `Horodatage` Timestamp

### Recettes de requêtes

**Erreurs et avertissements dans le temps**

```kql
table Journaux
| where Timestamp > ago(7d)
| summarize Errors = countif(SeverityLevel >= 3),
          Warnings = countif(SeverityLevel == 2)
  by bin(Timestamp, 1h)
| order by Timestamp asc
```

**Quel composant échoue**

```kql
table Journaux
| where Timestamp > ago(7d) and SeverityLevel >= 3
| summarize Failures = count() by CategoryName
| order by Failures desc
| take 20
```

**Filtrer sur une propriété structurée**

```kql
table Journaux
| where Timestamp > ago(2d)
| where tostring(Properties.requestPath) startswith "/api/"
| summarize Calls = count() by tostring(Properties.requestPath)
| order by Calls desc
| take 25
```

**Taux d’erreur en pourcentage**

```kql
table Journaux
| where Timestamp > ago(24h)
| summarize Total = count(), Failures = countif(SeverityLevel >= 3)
| extend ErrorRate = round(100.0 * Failures / Total, 2)
```

**Suivre une requête de bout en bout**

```kql
table Journaux
| where OperationId == "<OPERATION_ID>"
| project Timestamp, SeverityLevel, CategoryName, OperationName, Message, Properties
| order by Timestamp asc
```

## Dépannage

| Ce qui s’affiche                                                   | Signification                                                                                                                     |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Aucune ligne alors qu’on en attendait                              | Vérifiez la fenêtre de conservation de 45 jours, puis la casse des colonnes.                                                      |
| La requête expire                                                  | Réduisez la plage temporelle, filtrez par `SeverityLevel`, et ne projetez que les colonnes nécessaires.                           |
| `401`, `403`, `400` ou les erreurs de limitation de débit de l’API | Voir Dépannage sur la [API Insights](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/insights-api.md) page. |

## Bonne pratique

* Commencez de façon ciblée : une plage temporelle et un filtre de gravité rendent les étapes suivantes plus rapides.
* Corrélez avec `OperationId`, pas avec les horodatages, qui s’entrecroisent entre les requêtes.

## FAQ

<details>

<summary><strong>Un suivi en direct est-il disponible ?</strong></summary>

Aucun suivi en direct en libre-service n’est disponible. Réglez la période sur **Aujourd’hui** et actualisez la page, ou interrogez périodiquement l’API Insights sur une plage étroite.

</details>

<details>

<summary><strong>Faut-il utiliser les journaux ou l’API Insights pour le reporting ?</strong></summary>

Utilisez les événements Wallet pour le reporting. Les journaux de la plateforme décrivent le comportement du système, pas les performances du programme. Pour l’adoption, les installations et les scans, voir [Définitions des KPI](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/kpi-definitions.md) et [Tableaux de bord Analytics](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/analytics-dashboards.md).

</details>


---

# 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://docs.thewalletcrew.io/guides-monitoring/fr/monitor/retrieve-platform-logs.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.
