2.7 KiB

Raw Blame History

Log Management Guide

This guide covers log configuration and rotation for pcloudcc.

Log Files

pcloudcc supports two types of logs:

Debug Log - Operational information, errors, and debug messages
- Default location: ~/.pcloud/debug.log
- Configure with: --log-path and --log-level
Filesystem Events Log - Clean log of file/folder operations only
- Disabled by default
- Enable with: --fs-event-log

Log Configuration

Log Level

Control verbosity with --log-level:

# Errors only
pcloudcc -u user@example.com -d --log-level ERROR

# Normal operation (default)
pcloudcc -u user@example.com -d --log-level INFO

# Detailed debugging
pcloudcc -u user@example.com -d --log-level DEBUG

# Disable logging
pcloudcc -u user@example.com -d --log-level NONE

Available levels: NONE, ERROR, WARNING, INFO, NOTICE, DEBUG

Custom Log Path

# System-wide log
pcloudcc -u user@example.com -d --log-path /var/log/pcloudcc.log

# Custom user location
pcloudcc -u user@example.com -d --log-path ~/logs/pcloud.log

Filesystem Events Log

Enable a separate log containing only filesystem events:

pcloudcc -u user@example.com -d --fs-event-log ~/.pcloud/fs-events.log

Event format: <timestamp> <event_type> <path>

Example events:

Wed, 12 Nov 2025 05:24:23.032 +0000 file deleted /tmp/xxx
Wed, 12 Nov 2025 05:24:47.861 +0000 folder moved /tmp/test2 -> /tmp/test3
Wed, 12 Nov 2025 05:25:10.445 +0000 file created /tmp/newfile.txt

Log Rotation

System-Wide (with logrotate)

Install the provided configuration:

sudo cp pcloudcc.logrotate /etc/logrotate.d/pcloudcc

This rotates logs daily, keeps 7 days of history, and compresses old logs.

User-Specific Rotation

Create ~/.logrotate.conf:

/home/username/.pcloud/debug.log /home/username/.pcloud/fs-events.log {
    weekly
    rotate 4
    compress
    missingok
    notifempty
    create 0600 username username
    maxsize 50M
    postrotate
        pkill -USR2 -u username pcloudcc 2>/dev/null || true
    endscript
}

Add to crontab:

crontab -e
# Add this line:
0 2 * * * /usr/sbin/logrotate -s ~/.logrotate.state ~/.logrotate.conf

Manual Rotation

# Move current logs
mv ~/.pcloud/debug.log ~/.pcloud/debug.log.old
mv ~/.pcloud/fs-events.log ~/.pcloud/fs-events.log.old

# Signal pcloudcc to reopen logs
pkill -SIGUSR2 pcloudcc

Cache Management

Configure cache size (default 5GB):

# Set to 10GB
pcloudcc -u user@example.com -d --cache-size 10

# Set to 1GB for limited storage
pcloudcc -u user@example.com -d --cache-size 1

Check cache usage:

du -sh ~/.pcloud/Cache

Cache is stored in ~/.pcloud/Cache/ and managed automatically by pcloudcc.

2.7 KiB Raw Blame History