From 9b926559ce3f87f8246b0d036d3c088545f40187 Mon Sep 17 00:00:00 2001 From: "ljf (zamentur)" Date: Tue, 5 Jun 2018 17:50:24 +0200 Subject: [PATCH] [enh] Add fr for new doc about log system --- packaging_apps_fr.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index 4b5d9a07..8bac6be0 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -45,6 +45,36 @@ Comme les instances de YunoHost possèdent une architecture unifiée, vous serez ### Commandes pratiques Commandes pratiques +### Référencement des logs +Dans de nombreuses situations, vous pouvez vouloir indexer un fichier de log pour qu'il soit affiché dans la webadmin. Pour indexer un log, il faut créer un fichier d'indexation dans /var/log/yunohost/categories/app/APPNAME.yml. + +Il est possible de spécifier la date de début en commençant le nom de fichier par la date YYYYMMDD-HHMMSS. + +Exemple de fichier de log d'indexation: +``` +log_path: /chemin/vers/le/fichier.log +``` + +Il est possible d'afficher des infos complémentaires, la variable env sera affichée dans la partie "Contexte" : +``` +extra: + env: + args1: value1 + args2: value2 + args3: value3 +``` + +Il est possible de rattacher le log à une application précise et/ou un service, un nom de domaine, une personne : +``` +related_to: + - ['app', 'APPNAME'] + - ['service', 'SERVICE1'] + - ['service', 'SERVICE2'] + - ['domain', 'DOMAIN.TLD'] +``` +Ces informations seront utilisées pour pemettre de filtrer le slogs en relation avec une de ces entités application, service, domaine, personne. + + ### Améliorer la qualité du paquet d’installation Vous trouverez ci-dessous une liste des points à vérifier concernant la qualité de vos scripts : * Vos scripts utilisent bien `sudo cp -a ../sources/. $final_path` plutôt que `sudo cp -a ../sources/* $final_path` ;