Logs Runbook — DjangoPlay Web

---

#1. Overview

Logs are the primary source of information for debugging issues in production and development environments.

DjangoPlay Web generates logs from multiple components:

Logs can be accessed in two ways:

1. Direct log file access (standard Linux tools)
2. Using djangoplay-cli log streaming (recommended for development)

---

#2. Log Types

Typical logs include:

---

#3. Viewing Logs (Standard Method)

#View last lines of a log file

tail -n 50 <log-file>

#Follow log in real time

tail -f <log-file>

CODEBLOCKPLACEHOLDER0


### Search logs by keyword

```bash id="34vxd9"
grep "keyword" <log-file>

CODEBLOCKPLACEHOLDER1


This streams the main Django log file.

### Stream logs for a specific app

```bash id="wq2xkr"
dplay logs <app_name>

CODEBLOCKPLACEHOLDER2


### Show last N lines

```bash id="ksg9v3"
dplay logs django --no-follow -n 100

CODEBLOCKPLACEHOLDER3


Log levels:

| Level    | Description         |
| -------- | ------------------- |
| DEBUG    | Debug information   |
| INFO     | General information |
| WARNING  | Warning messages    |
| ERROR    | Errors              |
| CRITICAL | Critical errors     |

### CLI Logging Options Summary

| Command                             | Description           |
| ----------------------------------- | --------------------- |
| dplay logs                      | Stream main logs      |
| dplay logs users                | Stream users app logs |
| dplay logs mailer               | Stream mailer logs    |
| dplay logs django -n 100        | Show last 100 lines   |
| dplay logs django --level ERROR | Show only errors      |
| dplay logs                          | Global logs command   |

---

## 5. Log Rotation

Logs should be rotated to prevent disk space issues.

Recommended rotation policy:

| Log Type         | Rotation       |
| ---------------- | -------------- |
| Application logs | Daily          |
| Gunicorn logs    | Daily          |
| Celery logs      | Daily          |
| Nginx logs       | Weekly         |
| System logs      | System default |

Use tools such as:

* logrotate
* journald
* external logging system

---

## 6. Debugging Order (Very Important)

When debugging an issue, check logs in this order:

1. Django application log
2. App-specific logs
3. Mailer log
4. Gunicorn error log
5. Celery worker log
6. Nginx error log
7. System logs

This order helps isolate the issue quickly.

---

## 7. Common Log Investigation Scenarios

| Problem                     | Check Logs              |
| --------------------------- | ----------------------- |
| 500 error                   | Django log              |
| Emails not sending          | Mailer log + Celery log |
| Background job failed       | Celery log              |
| Site slow                   | Gunicorn + system logs  |
| Static files not loading    | Nginx log               |
| Login issues                | Users app log           |
| API errors                  | Django log              |
| Worker not processing tasks | Celery log              |

---

## 8. Summary

Logs can be accessed using:

| Method         | Usage                 |
| -------------- | --------------------- |
| tail / grep    | Production servers    |
| system logs    | Service debugging     |
| djangoplay-cli | Local development     |
| Log files      | Application debugging |

---