Configurer un appender Syslog
Vous pouvez envoyer des logs directement dans un système syslog, syslog-ng ou rsyslog.
Procédure
-
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
- Sauvegardez le fichier.
-
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.
-
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.
-
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 :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 :{ "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" }
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."taskId": {"$resolver": "mdc", "key": "flowID"}, "executionId": {"$resolver": "mdc", "key": "flowExecutionId"},
-
Dans <RemoteEngineInstallationDirectory>/etc, créez un fichier de configuration et nommez-le jsonLogMinTemplateCustom.json.
- Configurez votre système JMS pour qu'il utilise ce nouveau modèle jsonLogMinTemplateCustom.json au lieu de celui par défaut jsonLogMinTemplate.json.
Cette page vous a-t-elle aidé ?
Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.