# Logging in database

This module adds a logs handler writing to database.

Notice

> - Following code will create a log in db with a unique pid per logger:
>     import logging logger = SmileLogger(dbname, model_name, res_id, uid) logger.info(your_message)

Features :

- Create logs when executing an action.
- Archive and delete old logs from database.
- Give users access right to see logs.

Table of contents

- Configuration
- Usage
- Bug Tracker
- GDPR / EU Privacy
- Credits
  - Authors
  - Maintainer

# Configuration

- Developer adds `import logging` to his python file.
- Developer must add following code to his action and specify the database, the model name, the res_id, and uid. Then give a message to log for information:

    logger = SmileLogger(dbname, model_name, res_id, uid)
    logger.info(your_message)

- Administrator must create a `Scheduled Action` to call the function `archive_and_delete_old_logs`, configure archiving path and the number of days to archive and delete logs.

# Usage

To add Logs handler to an action :

> 1. Import SmileDBLogger to your python code and add code lines as shown in following example :

> 2. Add `smile_log` to your module dependence:

> 3. Now execute the action.:

> 4. Go to `Settings > Technical > Logging`> Logs menu to see logs.

Administrator can give access right to users, to see logs, by checking `Smile Logs / User`.

To create the scheduled action:

  1. Go to `Settings > Technical > Automation > Scheduled Actions` and fill fields as follow:

     > `(Make sure that the given folder has a write access!)`

  2. After running the action, the extracted logs file in csv format is as shown in next figure:

# Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback here.

Do not contact contributors directly about support or help with technical issues.

# GDPR / EU Privacy

This addons does not collect any data and does not set any browser cookies.

# Credits

## Authors

- Corentin POUHET-BRUNERIE
- Xavier FERNANDEZ
- Majda EL MARIOULI

## Maintainer

This module is maintained by the Smile SA.

Since 1991 Smile has been a pioneer of technology and also the European expert in open source solutions.

This module is part of the odoo-addons project on GitHub.

You are welcome to contribute.