Session Log Analyzer#

Analyze agent session logs, generate PDF reports, and sync them to Notion — manually or on a daily schedule.

Features#

• Log Analysis: Parse JSONL session logs, compute statistics (session counts, skill invocations, success rates, errors)
• PDF Report Generation: Produce formatted PDF analysis reports via nano-pdf
• Notion Sync: Upload generated reports to a Notion database
• Daily Automation: Cron-driven pipeline that runs at 2:00 AM, generates a dated PDF, and syncs to Notion

Quick Start#

Manual Analysis#

bash

cd scripts && python3 analyze_logs.py

Manual Notion Sync#

bash

export NOTION_API_KEY="your-key"
export NOTION_REPORTS_DB_ID="your-db-id"
cd scripts && python3 sync_to_notion.py

Daily Automated Report#

The daily report pipeline is managed by tmux_scripts/daily-log-report.sh. It:

1. Runs analyze_logs.py to generate a dated PDF report
2. Syncs the PDF to Notion via sync_to_notion.py
3. Logs all output for debugging

To set up the cron schedule inside your tmux session:

bash

# Add to crontab (runs at 2:00 AM daily)
(crontab -l 2>/dev/null; echo "0 2 * * * /root/.openclaw/workspace/tmux_scripts/daily-log-report.sh >> /root/.openclaw/workspace/pdfs/daily_report.log 2>&1") | crontab -

Or simply start the dev tmux session — the cron job is registered automatically:

bash

./tmux_scripts/start_dev_session.sh

Environment Variables#

VariableRequiredDescriptionNOTION_API_KEYYes (for Notion sync)Notion integration API keyNOTION_REPORTS_DB_IDYes (for Notion sync)Notion database ID for reports

File Structure#

text

scripts/analyze_logs.py       — Log analysis & PDF generation
scripts/sync_to_notion.py     — Notion sync logic
tmux_scripts/daily-log-report.sh — Daily cron pipeline script
session_logs/                  — Raw JSONL session log files
pdfs/                          — Generated PDF reports

Changelog#

• 1.2.1 — 新增每日自动生成日志分析报告并同步至Notion的定时任务功能
• 1.1.0 — Added PDF report generation and Notion sync support
• 1.0.0 — Initial release — view and analyze session logs