> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/fr/module-9-supervision-et-depannage/03-log-management.md).

# Gestion et redirection des journaux

Types de journaux VergeOS, conservation de 45 jours dans l’interface, journaux spécifiques au contexte, configuration de la redirection syslog à distance, gestion SEL et rapports d’activité SMTP.

## Le rôle des journaux dans les opérations VergeOS

Les journaux constituent la piste d’audit et l’épine dorsale du diagnostic de chaque environnement VergeOS. Ils enregistrent les actions initiées par les utilisateurs, les événements système automatisés, les relevés des capteurs matériels et l’activité de réplication — fournissant les preuves dont vous avez besoin pour résoudre les problèmes, satisfaire aux exigences de conformité et comprendre ce qui s’est passé et quand.

VergeOS organise les journaux en trois catégories distinctes, chacune remplissant une fonction différente et étant stockée à un emplacement différent. Comprendre ces catégories est essentiel pour savoir où regarder lors du diagnostic d’un problème et comment garantir une conservation à long terme.

```mermaid
graph TB
    subgraph logTypes["Catégories de journaux VergeOS"]
        direction TB
        SYS["Journaux système<br/>Activité utilisateur et automatisée<br/>événements vSAN, VM, réseau"]
        SYNC["Journaux de synchronisation<br/>Activité de réplication de synchronisation de site<br/>Démarrage/arrêt, données transférées"]
        SEL["Journal des événements système (SEL)<br/>Événements IPMI du matériel<br/>Stocké sur le matériel BMC"]
    end

    subgraph retention["Conservation"]
        UI["Dans l'UI : 45 jours"]
        HW["Sur le matériel : capacité limitée"]
        EXT["Externe : transfert Syslog"]
    end

    SYS --> UI
    SYNC --> UI
    SEL --> HW
    SYS --> EXT
    SEL --> EXT

    style logTypes fill:#f0f4ff,stroke:#336
    style retention fill:#f0fff4,stroke:#363
```

## Types de journaux en détail

### Journaux système

Les journaux système sont la principale catégorie de journaux dans VergeOS. Ils capturent les activités liées aux **opérations vSAN, aux événements du cycle de vie des VM, aux modifications réseau, aux connexions des utilisateurs, aux modifications de configuration**, et à d'autres opérations liées au système. Ces journaux sont essentiels pour comprendre les opérations détaillées et les performances de l’ensemble de l’environnement.

Exemples d’entrées de journal système :

| Type d'événement                 | Exemple d'entrée de journal                                                |
| -------------------------------- | -------------------------------------------------------------------------- |
| **Authentification utilisateur** | Adresse IP, nom d'utilisateur, horodatage de connexion                     |
| **Changements de mot de passe**  | Quel utilisateur a changé quel mot de passe, depuis quel environnement     |
| **Opérations VM**                | VM démarrée, arrêtée, migrée, instantané créé                              |
| **Événements de stockage**       | Avertissements de disque, changements d’état du niveau vSAN, alertes SMART |
| **Événements réseau**            | Réseau créé, règle de pare-feu modifiée, changement d’état de la NIC       |
| **Opérations système**           | Mise à jour téléchargée, nœud redémarré, mode maintenance activé           |

Les journaux système sont accessibles depuis le **Tableau de bord principal** (en bas de la page) ou en sélectionnant **Journaux** dans le menu du haut. Chaque entrée de journal comprend un **niveau** (Critique, Erreur, Avertissement ou Message), un **horodatage**, un **source** (par exemple, node1, vSAN, admin), et un **message** décrivant l'événement.

### Journaux de synchronisation

Les journaux de synchronisation sont spécifiques aux **opérations de synchronisation de site (réplication)** Ils sont disponibles sur les tableaux de bord de synchronisation entrante et sortante et fournissent des statistiques détaillées pour chaque tâche de synchronisation d'instantané :

* **Heures de début et de fin** pour chaque opération de synchronisation
* **Quantité de données vérifiée** -- données totales évaluées pour des modifications
* **Quantité de données analysée** -- données lues pendant la synchronisation
* **Quantité de données envoyée** -- données modifiées identifiées comme nécessitant un envoi (avant compression)
* **Données nettes envoyées** -- octets réels sur le fil (après compression)
* **Nombre de répertoires et de fichiers** -- portée de l'opération de synchronisation

Les journaux de synchronisation sont inestimables pour surveiller l’intégrité de la réplication, vérifier que les tâches de reprise après sinistre se terminent à l’heure et diagnostiquer les problèmes de bande passante ou de performances liés à la synchronisation de site à site.

### Journal des événements système (SEL)

Le journal des événements système (SEL) contient des événements provenant de l' **interface matérielle IPMI** (Intelligent Platform Management Interface). Contrairement aux journaux système, le SEL est **stocké directement sur le matériel BMC du serveur**, ce qui signifie qu'il a une **capacité limitée et fixe**. Une fois le SEL plein, les nouveaux événements ne peuvent plus être enregistrés jusqu'à ce qu'il soit vidé.

Le tableau de bord du nœud affiche une **barre de pourcentage** indiquant quelle part de la capacité SEL est actuellement utilisée sur chaque nœud. Les entrées SEL courantes incluent :

* Dépassements de seuil de température
* Avertissements de vitesse des ventilateurs
* Événements de l'alimentation
* Erreurs ECC de mémoire
* Événements thermiques du processeur
* Événements d'initialisation matérielle

{% hint style="warning" %}
**La capacité du SEL est limitée**

Le SEL est stocké sur le contrôleur de gestion de la carte mère (BMC) du serveur et dispose d'une capacité limitée et fixe. Si le SEL se remplit complètement, les nouveaux événements matériels sont silencieusement rejetés. Surveillez le pourcentage de capacité du SEL sur le tableau de bord de chaque nœud et videz le SEL de manière proactive.
{% endhint %}

## Conservation des journaux dans l'UI

VergeOS conserve les journaux système dans l'interface utilisateur pendant un maximum de **45 jours**. Après cette période, les journaux sont automatiquement supprimés de l'UI. Cette fenêtre de conservation suffit pour le dépannage quotidien et l'audit à court terme, mais les organisations soumises à des exigences de conformité (HIPAA, SOC 2, PCI-DSS, etc.) devront configurer **le transfert distant des journaux** pour conserver les journaux plus longtemps.

### Journaux spécifiques au contexte

L'une des fonctionnalités les plus pratiques de la journalisation VergeOS est **le filtrage de journaux spécifique au contexte**. Dans de nombreuses zones de la plateforme -- comme le tableau de bord d'une VM individuelle, d'un réseau ou d'un locataire -- il existe un **Journaux** bouton qui n'affiche que les journaux pertinents pour cet objet spécifique.

Ce cadrage élimine le besoin de rechercher manuellement parmi des milliers d'entrées de journal à l'échelle du système. Par exemple :

* **Tableau de bord de la VM → Journaux** affiche uniquement les événements liés à cette VM spécifique (démarrage, arrêt, migration, instantané, erreur)
* **Tableau de bord réseau → Journaux** affiche uniquement les événements liés au réseau (modifications de règles, changements d'état, événements de connectivité)
* **Tableau de bord du locataire → Journaux** affiche uniquement les événements dans le périmètre de ce locataire

Les journaux spécifiques au contexte accélèrent considérablement le dépannage en réduisant le rapport signal/bruit exactement à l'objet examiné.

## Transfert Syslog distant

Pour les organisations qui ont besoin d'une conservation des journaux au-delà de 45 jours ou qui doivent intégrer les journaux VergeOS dans une plateforme centralisée de gestion des journaux (Graylog, Splunk, Elastic Stack, Datadog, etc.), VergeOS prend en charge **le transfert syslog distant** via les protocoles syslog standard.

### Étapes de configuration

Le transfert syslog distant se configure via **Paramètres avancés** dans l'interface utilisateur VergeOS :

#### Étape 1 : Configurer le serveur Syslog distant

1. Accédez à **Système → Paramètres → Paramètres avancés**
2. Dans la **Paramètre** colonne, saisissez `syslog` et appuyez sur **Entrée** pour rechercher
3. Sélectionnez et modifiez **Serveur syslog distant (tcp: @@name/ip:port, udp: @name/ip:port)**
4. Entrez la destination syslog en utilisant la syntaxe appropriée :

| Protocole | Syntaxe         | Exemple             | Remarques                                        |
| --------- | --------------- | ------------------- | ------------------------------------------------ |
| **TCP**   | `@@<ip>:<port>` | `@@10.10.10.10:514` | Livraison fiable, recommandée                    |
| **UDP**   | `@<ip>:<port>`  | `@10.10.10.10:514`  | Moins de surcharge, aucune garantie de livraison |

5. Cliquez sur **Soumettre** pour enregistrer

#### Étape 2 : Configurer le modèle de format

1. Recherchez `syslog` à nouveau dans les Paramètres avancés
2. Sélectionnez et modifiez **Modèle à définir pour le serveur syslog (voir rsyslog pour le format)**
3. Entrez un format de modèle syslog compatible avec votre serveur distant

Pour **Graylog** en utilisant le format RFC 5424 :

```
GRAYLOGRFC5424,"<%PRI%>1 %TIMESTAMP:::date-rfc3339% %HOSTNAME%.your-hostname-here %APP-NAME% %PROCID% %MSGID% %STRUCTURED-DATA% %msg%\n"
```

{% hint style="warning" %}
Utilisez le littéral `1` après `<%PRI%>` — il s'agit du champ de version RFC 5424. N'utilisez pas `%PROTOCOL-VERSION%`: il s'affiche comme `0` sur le fil, et les collecteurs RFC 5424 stricts (Promtail/Loki, Fluent Bit, Graylog moderne) rejettent la version 0 avec des erreurs d'analyse.
{% endhint %}

{% hint style="success" %}
**Personnalisation du modèle**

Remplacez `your-hostname-here` par votre véritable nom d'hôte pour rendre les entrées de journal facilement identifiables dans votre plateforme de journaux centralisée. Le modèle suit la syntaxe rsyslog -- consultez la [documentation rsyslog](https://www.rsyslog.com/doc/configuration/examples.html) pour des options de format supplémentaires.
{% endhint %}

4. Cliquez sur **Soumettre** pour enregistrer

#### Étape 3 : Vérifier le transfert

Une fois la configuration terminée, les journaux commenceront à être transférés vers le serveur syslog spécifié. Vérifiez les journaux entrants de votre serveur distant pour confirmer que les entrées VergeOS sont bien reçues. Étapes de vérification courantes :

* Confirmer la connectivité réseau entre VergeOS et le serveur syslog (port 514 ou port personnalisé)
* Vérifier que les règles de pare-feu autorisent le trafic syslog dans les deux sens
* Consulter le tableau de bord d'ingestion des journaux du serveur distant pour les entrées entrantes
* Générer un événement de test (par exemple, se connecter/se déconnecter de l'interface utilisateur VergeOS) et confirmer qu'il apparaît sur le serveur distant

### Prérequis pour le transfert Syslog

Avant de configurer le transfert de journaux à distance, assurez-vous des éléments suivants :

* **Connectivité réseau** entre le système VergeOS et le serveur syslog distant
* **Règles de pare-feu** autorisant le trafic syslog (généralement le port TCP ou UDP 514, ou votre port personnalisé)
* **Accès aux paramètres système VergeOS** avec des privilèges administratifs
* Le serveur syslog distant est configuré pour **accepter les connexions entrantes** depuis la plage d'adresses IP VergeOS

## Gestion du SEL

Comme le SEL a une capacité matérielle limitée, il nécessite une maintenance périodique pour garantir que de nouveaux événements puissent toujours être enregistrés.

### Surveillance de la capacité SEL

La **tableau de bord du nœud** affiche une barre de pourcentage montrant l'utilisation actuelle du SEL pour chaque nœud. Surveillez régulièrement cet indicateur -- surtout sur le matériel ancien qui peut générer davantage d'événements IPMI.

### Vidage du SEL

Lorsque le SEL approche de sa capacité maximale, videz-le selon la procédure suivante :

1. Accédez à **Infrastructure → Nœuds**
2. Double-cliquez sur le nœud souhaité pour accéder au **Tableau de bord du nœud**
3. Cliquez sur **Vider le SEL** dans le menu de gauche
4. Cliquez sur **Oui** pour confirmer

{% hint style="success" %}
**Gestion proactive du SEL**

Envisagez d'établir un calendrier régulier pour vider le SEL -- par exemple, mensuellement ou trimestriellement -- afin d'éviter qu'il n'atteigne sa capacité maximale. Avant de le vider, exportez les entrées SEL vers votre serveur syslog distant ou consignez tout événement important pour vos archives.
{% endhint %}

### Filtrage des entrées SEL faussement positives

Certains matériels serveur génèrent des événements IPMI répétitifs ou bénins qui encombrent le SEL et les journaux système. Les faux positifs courants incluent :

* Des relevés de capteurs qui franchissent brièvement les seuils pendant les séquences de démarrage
* Des événements d'alimentation pendant les fenêtres de maintenance planifiées
* Des pics de température lors de charges de travail courtes qui se résolvent immédiatement

Pour les entrées faussement positives persistantes, VergeOS prend en charge le filtrage via un filtre regex syslog encodé en hexadécimal configuré via l'API. Après avoir appliqué le filtre, redémarrez le `openipmi` service pour activer la modification. Travaillez avec le support VergeOS pour obtenir des conseils sur la mise en œuvre de filtres SEL spécifiques à votre plateforme matérielle.

## Rapports d'activité SMTP

En plus des journaux système et du transfert syslog, VergeOS fournit **rapports de livraison SMTP** via le tableau de bord SMTP (couvert dans la [page Abonnements et alertes](https://docs.verge.io/learn-the-platform/fr/module-9-supervision-et-depannage/02-alerts.md) ). Ces rapports offrent une visibilité sur l'activité de livraison des e-mails :

* **File d'attente des messages** -- Afficher les messages en attente, l'état des tentatives et les échecs de livraison
* **Journal des e-mails** -- Piste d'audit de tous les e-mails d'abonnement envoyés avec horodatages et statut de livraison
* **Résumés de livraison quotidiens** -- Suivre l'activité SMTP d'hier et d'aujourd'hui pour confirmer que les alertes sont bien livrées

Les rapports d'activité SMTP complètent la gestion des journaux en fournissant un canal de vérification secondaire -- si vous vous attendez à recevoir une alerte mais que ce n'est pas le cas, le journal SMTP peut révéler si le message a été mis en file d'attente, livré ou rejeté.

## Bonnes pratiques de gestion des journaux

### Transférer les journaux à l'extérieur

Configurez le transfert syslog distant dès le départ. La conservation dans l'UI pendant 45 jours est insuffisante pour la plupart des cadres de conformité et limite l'analyse des tendances à long terme.

### Surveiller la capacité SEL

Vérifiez régulièrement la barre de pourcentage SEL sur chaque tableau de bord de nœud. Videz le SEL avant qu'il n'atteigne sa capacité maximale pour éviter toute perte de nouveaux événements matériels.

### Utiliser des journaux spécifiques au contexte

Lorsque vous dépannez une VM, un réseau ou un locataire spécifique, utilisez le bouton Journaux spécifique au contexte sur le tableau de bord de cet objet pour filtrer le bruit non pertinent.

### Établir des politiques de conservation

Définissez tôt les exigences de conservation de l'organisation. Utilisez le transfert syslog vers une plateforme centralisée pour le stockage à long terme, la recherche et l'audit de conformité.

{% hint style="info" %}
**Pont VMware**

Vous venez de VMware ? Dans VergeOS, les événements opérationnels et d'audit cohabitent dans une vue unique et filtrable des journaux système (Critique/Erreur/Avertissement/Message), conservée dans l'interface utilisateur pendant 45 jours. Le transfert syslog distant se configure une seule fois au niveau du système via deux champs Paramètres avancés -- serveur syslog et modèle -- plutôt que configuré par hôte.
{% endhint %}

{% hint style="info" %}
**Pont Nutanix**

Vous venez de Nutanix ? Dans VergeOS, les opérations système et les événements d'audit se trouvent dans une seule vue Journaux système (conservation dans l'interface utilisateur pendant 45 jours) ; le transfert syslog distant se configure une seule fois au niveau du système. Les événements matériels restent dans le SEL avec la même recommandation de vidage proactif.
{% endhint %}

## Points clés à retenir

### Trois types de journaux

**Journaux système** pour les événements opérationnels, **Journaux de synchronisation** pour l'activité de réplication, et **SEL** pour les événements IPMI du matériel. Chacun répond à un besoin de dépannage distinct.

### Conservation UI de 45 jours

VergeOS conserve les journaux système pendant 45 jours dans l'interface utilisateur. Configurez le transfert syslog distant pour une conservation plus longue et des exigences de conformité.

### Configuration Syslog simple

Deux champs Paramètres avancés -- adresse du serveur syslog et format du modèle -- configurent le transfert de journaux pour l'ensemble de l'environnement. TCP (`@@`) pour la fiabilité, UDP (`@`) pour les performances.

### Le SEL nécessite une maintenance

Le SEL matériel a une capacité fixe. Surveillez la barre de pourcentage sur chaque tableau de bord de nœud et videz le SEL de manière proactive pour éviter toute perte d'événements.


---

# 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.verge.io/learn-the-platform/fr/module-9-supervision-et-depannage/03-log-management.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.
