> 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/knowledge-base/fr/troubleshooting/configuring-remote-log-forwarding.md).

# Configurer la redirection des journaux distants (Syslog)

Comment configurer VergeOS pour transférer les journaux système vers un serveur syslog distant pour une gestion centralisée des journaux, l’archivage et la conformité.

VergeOS peut être configuré pour transférer les journaux vers un serveur Syslog distant, une capacité importante pour les organisations qui exploitent l’agrégation de journaux pour la gestion centralisée, l’archivage des journaux et la conformité.

{% hint style="success" %}
**Rétention des journaux**

Les activités journalisées sont généralement disponibles dans l’interface utilisateur VergeOS pendant un maximum de **45 jours**. Configurez le transfert de journaux à distance pour conserver les journaux plus longtemps.
{% endhint %}

## Prérequis

* Connectivité réseau entre VergeOS et le serveur syslog distant
* Règles de pare-feu appropriées pour autoriser le trafic syslog (généralement le port 514)
* Accès aux paramètres système de VergeOS

## Étapes de configuration

Pour configurer le transfert des journaux vers un serveur syslog distant :

### 1. Accédez à Paramètres avancés

Accédez à **Système > Paramètres > Paramètres avancés**.

### 2. Configurez le serveur syslog distant

1. Sous l’en-tête de colonne "Setting", saisissez `syslog` et appuyez sur **Entrée** pour rechercher
2. Sélectionnez et modifiez **Serveur syslog distant (tcp: @@name/ip:port, udp: @name/ip:port)**
3. Configurez ce paramètre selon la syntaxe attendue par votre serveur distant :

{% hint style="info" %}
**Exemples de configuration du serveur**

* **Pour TCP :** `@@10.10.10.10:514`
* **Pour UDP :** `@10.10.10.10:514`
  {% endhint %}

{% hint style="info" %}
**Choix entre TCP et UDP**

* **TCP (`@@`)** offre une livraison garantie ; utilisez-le pour les journaux d’audit et de conformité.
* **UDP (`@`)** fonctionne en mode « envoyer et oublier » : moins de surcharge, mais les messages peuvent se perdre en cas de charge.
  {% endhint %}

{% hint style="info" %}
**Port du collecteur**

Écouter sur le port 514 nécessite des privilèges root sur le collecteur. De nombreux collecteurs s’exécutent sans privilèges (par exemple, dans des conteneurs) et écoutent sur le port **1514** à la place. Saisissez le port sur lequel votre collecteur écoute.
{% endhint %}

4. Cliquez sur **Envoyer** en bas de la page pour enregistrer

### 3. Configurez le modèle de format

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

{% hint style="info" %}
**Exemple de modèle**

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

{% endhint %}

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

{% hint style="info" %}
Remplacez `your-hostname-here` par votre nom d’hôte réel, ou laissez-le tel quel `.HOSTNAME_HERE` pour utiliser le nom d’hôte système par défaut.
{% endhint %}

{% hint style="info" %}
**Transfert depuis plusieurs systèmes VergeOS**

`%HOSTNAME%` résout vers le simple nom du nœud (`node1`, `node2`), ce qui est ambigu lorsque plusieurs systèmes VergeOS transfèrent vers le même collecteur. Modèles courants de nom d’hôte :

| Modèle                             | Sortie d’exemple              | Utilisation                                                 |
| ---------------------------------- | ----------------------------- | ----------------------------------------------------------- |
| `%HOSTNAME%`                       | `node1`                       | Un seul système                                             |
| `mycluster-%HOSTNAME%`             | `mycluster-node1`             | Un préfixe par système ; recommandé pour plusieurs systèmes |
| `%HOSTNAME%.mycluster.example.com` | `node1.mycluster.example.com` | Style FQDN                                                  |
| {% endhint %}                      |                               |                                                             |

4. Cliquez sur **Envoyer** en bas de la page pour enregistrer le format

## Notes pour le collecteur

Le modèle RFC 5424 ci-dessus fonctionne avec les collecteurs courants :

| Collecteur                                                               | Notes de configuration                                                                                                     |
| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| Graylog                                                                  | Utilisez un **Syslog TCP** ou **Syslog UDP** en entrée.                                                                    |
| Loki                                                                     | Utilisez un job d’extraction Promtail ; Promtail nécessite un RFC 5424 strict (la version littérale `syslog` ). `1` Splunk |
| Utilisez une entrée de données TCP ou UDP, ou Splunk Connect for Syslog. | Elasticsearch                                                                                                              |
| Ingestion via Logstash avec le                                           | plugin d’entrée. `syslog` plugin d’entrée.                                                                                 |
| relai rsyslog                                                            | Utilisez un `imtcp` ou `imudp` écouteur standard.                                                                          |

## Ressources supplémentaires

Pour plus d’informations sur les modèles syslog et les options de formatage, consultez la [Documentation Rsyslog](https://www.rsyslog.com/doc/configuration/examples.html).

## Vérification

Après avoir enregistré la configuration, VergeOS commence à transférer les journaux vers le serveur spécifié. Vérifiez le collecteur pour confirmer que les journaux VergeOS arrivent.

Si les journaux n’arrivent pas :

1. Sur l’hôte collecteur, capturez le trafic sur le port syslog configuré pour confirmer que les paquets arrivent (remplacez `514` par le port que vous avez configuré) :

   ```bash
   tcpdump -i any -A port 514
   ```
2. Inspectez les messages capturés pour vérifier le format sur le fil. Un message RFC 5424 commence par `<PRI>1` (par exemple, `<30>1 2026-04-15T...`); une version de `0` signifie que le modèle utilise toujours `%PROTOCOL-VERSION%` — voir l’avertissement sur le modèle ci-dessus.
3. Assurez-vous que les règles de pare-feu entre VergeOS et le collecteur autorisent le port et le protocole configurés.


---

# 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/knowledge-base/fr/troubleshooting/configuring-remote-log-forwarding.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.
