Assist_Design/docs/logging/LOGGING_LEVELS.md

# 📊 Logging Configuration Guide

## Quick Log Level Changes

### Using the Script (Recommended)

```bash
# Check current level
./scripts/set-log-level.sh

# Set to minimal logging (production-like)
./scripts/set-log-level.sh warn

# Set to normal development logging
./scripts/set-log-level.sh info

# Set to detailed debugging
./scripts/set-log-level.sh debug
```

### Manual Configuration

Edit `.env` file:

```bash
LOG_LEVEL="info"  # Change this value
```

## Log Levels Explained

| Level   | Numeric | What You'll See      | Best For                  |
| ------- | ------- | -------------------- | ------------------------- |
| `error` | 0       | Only critical errors | Production monitoring     |
| `warn`  | 1       | Warnings + errors    | Quiet development         |
| `info`  | 2       | General operations   | **Normal development** ⭐ |
| `debug` | 3       | Detailed debugging   | Troubleshooting issues    |
| `trace` | 4       | Very verbose tracing | Deep debugging            |

## What's Been Optimized

### ✅ Reduced Noise

- **HTTP requests/responses**: Filtered out health checks, static assets
- **Request bodies**: Hidden by default (security + noise reduction)
- **Response bodies**: Hidden by default (reduces overwhelming output)
- **Session checks**: Frequent `/api/auth/session` calls ignored

### ✅ Cleaner Output

- **Pretty formatting**: Colored, timestamped logs in development
- **Message focus**: Emphasizes actual log messages over metadata
- **Structured data**: Still available but not overwhelming

### ✅ Security Enhanced

- **Sensitive data**: Automatically redacted (tokens, passwords, etc.)
- **Production ready**: No debug info exposed to customers

## Common Scenarios

### 🔇 Too Much Noise?

```bash
./scripts/set-log-level.sh warn
```

### 🐛 Debugging Issues?

```bash
./scripts/set-log-level.sh debug
```

### 🚀 Normal Development?

```bash
./scripts/set-log-level.sh info
```

### 📊 Production Monitoring?

```bash
./scripts/set-log-level.sh error
```

## Environment Variables

```bash
# Core logging
LOG_LEVEL="info"                    # Main log level
DISABLE_HTTP_LOGGING="false"        # Set to "true" to disable HTTP logs entirely

# Application context
APP_NAME="customer-portal-bff"      # Service name in logs
NODE_ENV="development"              # Affects log formatting
```

## Restart Required

After changing log levels, restart your development server:

```bash
# Stop current server (Ctrl+C)
# Then restart
pnpm dev
```

The new log level will take effect immediately.