# Configurer un appender Syslog

Vous pouvez envoyer des logs directement dans un système syslog, syslog-ng ou rsyslog.

## Procédure

1. Ouvrez le fichier <RemoteEngineInstallationDirectory>/etc/org.ops4j.pax.logging.cfg et ajoutez les lignes suivantes :
   ### Exemple
   ```
   log4j2.appender.syslog.type = Syslog
   log4j2.appender.syslog.name = SyslogAppender
   log4j2.appender.syslog.format = RFC5424
   log4j2.appender.syslog.host = localhost
   log4j2.appender.syslog.port = 514
   log4j2.appender.syslog.protocol = TCP
   log4j2.appender.syslog.appName = RE
   log4j2.appender.syslog.includeMDC = true
   log4j2.appender.syslog.facility = LOCAL0
   log4j2.appender.syslog.layout.type = JsonTemplateLayout
   log4j2.appender.syslog.layout.eventTemplateUri=${karaf.base.uri}/etc/jsonLogMinTemplate.json
   log4j2.appender.syslog.layout.stackTraceElementTemplateUri=${karaf.base.uri}/etc/StackTraceElementLayout.json

   log4j2.rootLogger.appenderRef.SyslogAppender.ref = SyslogAppender
   ```
2. Sauvegardez le fichier.
3. Ajoutez les informations MDC (Mapped Diagnostic Context) au fichier de modèle JSON pour que les logs de sortie contiennent les informations MDC, si applicable. Ces informations MDC comprennent l'ID d'exécution d'une tâche de Talend Management Console.
   1. Dans <RemoteEngineInstallationDirectory>/etc, créez un fichier de configuration et nommez-le jsonLogMinTemplateCustom.json.

      Dans ce fichier, vous pouvez configurer le format des logs de sortie.
   2. Ajoutez les lignes suivantes à ce nouveau fichier pour créer un résolveur MDC :
      ## Exemple
      ```
      {
         "logMessage": {
            "$resolver": "message", 
            "stringified": true
         },
         "my_mdc": { 
            "$resolver": "mdc" 
         },
         "logTimestamp": {
            "$resolver": "timestamp", 
            "epoch": {
               "unit": "millis", 
               "rounded": true
             }
         },
          "severity": {
             "$resolver": "level",
             "field": "name"
         },
          "ticLogLevel": {
             "$resolver": "source", 
             "field": "ticLogLevel"
         }
      }
      ```

      Cet exemple définit un objet JSON permettant de spécifier les champs à inclure dans la sortie MDC. Cet objet utilise des paires clé-valeur, dans lesquelles les clés représentent les champs de sortie et les valeurs permettent de spécifier les résolveurs pour alimenter ces champs.

      La ligne "my\_mdc": { "$resolver": "mdc" } crée un champ nommé my\_mdc dans la sortie. Le résolveur mdc alimente ce champ avec tous les champs MDC, fournissant des informations de diagnostic supplémentaires associées aux logs. Un champ my\_mdc se présente comme suit :
      ```
      { 
        "accountID":"31e47fe5-abcd-4a80-a8b2-590123456789",
        "bundle.id":"289",
        "bundle.name":"org.talend.ipaas.engine.deployment-agent",
        "bundle.version":"2.13.7",
        "executionDestination":"REMOTE_ENGINE",
        "flowExecutionId":"ed31c1a8-abcd-4121-98bd-cd0123456789",
        "flowID":"61fbfc899e86410123456789",
        "flowVersion":"45.28",
        "remoteEngineId":"c62cd9a1-abcd-4580-8af1-220123456789",
        "userId":"user.talend.com",
        "workspaceId":"5ef6605b2632fd1234567890"
      }
      ```

      Pour récupérer des champs MDC spécifiques, comme flowID (représentant un ID de tâche) et flowExecutionId (représentant un ID d'exécution de tâche), remplacez la ligne "my\_mdc": { "$resolver": "mdc" } par :
      ```
      "taskId": {"$resolver": "mdc", "key": "flowID"},
      "executionId": {"$resolver": "mdc", "key": "flowExecutionId"},
      ```

      Les noms des champs taskId et executionId ne sont que des exemples. Vous pouvez utiliser n'importe quel nom significatif pour les champs MDC à inclure dans la sortie.
4. Configurez votre système JMS pour qu'il utilise ce nouveau modèle jsonLogMinTemplateCustom.json au lieu de celui par défaut jsonLogMinTemplate.json.