[enh] Add fr for new doc about log system

This commit is contained in:
ljf (zamentur) 2018-06-05 17:50:24 +02:00 committed by GitHub
parent a9d7d867be
commit 9b926559ce
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -45,6 +45,36 @@ Comme les instances de YunoHost possèdent une architecture unifiée, vous serez
### Commandes pratiques
<a class="btn btn-lg btn-default" href="packaging_apps_helpers_fr">Commandes pratiques</a>
### 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 dinstallation
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`;