Session Log Analyzer
View and analyze session logs, generate PDF reports, and sync to Notion. Supports daily automated reporting via cron.
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
cd scripts && python3 analyze_logs.py
Manual Notion Sync
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:
- Runs
analyze_logs.pyto generate a dated PDF report - Syncs the PDF to Notion via
sync_to_notion.py - Logs all output for debugging
To set up the cron schedule inside your tmux session:
# 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:
./tmux_scripts/start_dev_session.sh
Environment Variables
| Variable | Required | Description |
|---|---|---|
NOTION_API_KEY | Yes (for Notion sync) | Notion integration API key |
NOTION_REPORTS_DB_ID | Yes (for Notion sync) | Notion database ID for reports |
File Structure
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
Related skills
- Downloads
- 882All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.2.1
- License
- MIT-0
