# logs/

This directory contains EverShelf runtime log files.

Files are generated automatically by `api/logger.php` and follow the naming pattern:

```
evershelf_YYYY-MM-DD_HH.log
```

The directory is tracked in git (via this README) but `.log` files are ignored via `.gitignore`.

## Configuration (`.env`)

| Variable | Default | Description |
|---|---|---|
| `LOG_LEVEL` | `INFO` | Minimum log level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
| `LOG_ROTATE_HOURS` | `24` | Hours per file before rotating |
| `LOG_MAX_FILES` | `14` | Maximum number of rotated files to keep |

## Format

```
[2026-05-18 14:23:11] [INFO ] [rid=a1b2c3d4] [action] Message {"ctx":"value"}
```

## Remote inspection

```
GET /api/?action=get_logs&lines=100&level=WARN
```