.env.example

# This file is divided into two parts:
# 1. Top Section: Most common configurations for deployment. Check here first.
# 2. Bottom Section: Stable advanced settings. Keep defaults unless specifically required.

# ── Common ───────────────────────────
# HTTP bind address
WDAPM_BIND_ADDR=0.0.0.0:3000
# SQLite database path. Recommended to keep under /data for Docker deployments.
WDAPM_DATABASE_URL=sqlite:///data/wdapm.db
# Firecrawl async task callback URL prefix
# Set to the public access URL of this project, e.g., https://your-domain.com
# Leave blank to switch to background polling mode
WDAPM_WEBHOOK_BASE_URL=

# ── Runtime ──────────────────────────
# Enable background worker (Firecrawl async polling + alert checks)
WDAPM_WORKER_ENABLED=true
# Alert rule check interval (seconds). Rules are configured on the "Alerts" UI page.
WDAPM_ALERT_CHECK_INTERVAL_SECONDS=300
# Request log body capture mode: metadata_only / failures_only / failures_and_slow
WDAPM_REQUEST_LOG_CAPTURE_MODE=failures_and_slow

# ── Advanced: SQLite ─────────────────
# These parameters usually don't need adjustment; defaults are optimized for single-machine Docker.
# SQLite connection pool size
WDAPM_SQLITE_MAX_CONNECTIONS=8
# SQLite busy timeout (milliseconds)
WDAPM_SQLITE_BUSY_TIMEOUT_MS=15000
# SQLite page cache size per connection (KiB)
WDAPM_SQLITE_CACHE_SIZE_KIB=16384
# SQLite mmap size (MiB)
WDAPM_SQLITE_MMAP_SIZE_MB=256
# SQLite journal size limit (MiB)
WDAPM_SQLITE_JOURNAL_SIZE_LIMIT_MB=64
# SQLite optimization interval (seconds)
WDAPM_SQLITE_OPTIMIZE_INTERVAL_SECONDS=21600
# SQLite checkpoint check interval (seconds)
WDAPM_SQLITE_CHECKPOINT_INTERVAL_SECONDS=60
# WAL size threshold to trigger a passive checkpoint (MiB)
WDAPM_SQLITE_CHECKPOINT_WAL_MB=64
# Forced truncate checkpoint interval (seconds)
WDAPM_SQLITE_CHECKPOINT_TRUNCATE_INTERVAL_SECONDS=1800
# Number of pages for incremental_vacuum during each maintenance cycle
WDAPM_SQLITE_INCREMENTAL_VACUUM_PAGES=256

# ── Advanced: Worker ─────────────────
# Firecrawl async task polling interval (seconds)
WDAPM_WORKER_FIRECRAWL_INTERVAL_SECONDS=30
# Max Firecrawl async tasks processed per polling round
WDAPM_WORKER_FIRECRAWL_BATCH_LIMIT=50

# ── Advanced: Request Logs ───────────
# Max bytes captured for request/response bodies
WDAPM_REQUEST_LOG_BODY_MAX_BYTES=8192
# Slow request threshold (ms). Bodies are captured if exceeded.
WDAPM_REQUEST_LOG_SLOW_MS=2000
# Queue capacity for asynchronous request log writes
WDAPM_REQUEST_LOG_QUEUE_CAPACITY=4096
# Enable request log archiving
WDAPM_REQUEST_LOG_ARCHIVE_ENABLED=true
# Archive directory for request logs. Defaults to 'archive' folder next to the database if blank.
WDAPM_REQUEST_LOG_ARCHIVE_DIR=
# Retention period for hot database logs (hours)
WDAPM_REQUEST_LOG_HOT_RETENTION_HOURS=168
# Retention period for archived logs (days)
WDAPM_REQUEST_LOG_ARCHIVE_RETENTION_DAYS=90
# Execution interval for archiving/cleanup tasks (seconds)
WDAPM_REQUEST_LOG_ARCHIVE_INTERVAL_SECONDS=300
# Max logs processed per archiving/cleanup round
WDAPM_REQUEST_LOG_ARCHIVE_BATCH_SIZE=5000
# Max size limit for the archive directory (bytes). 0 for no limit.
WDAPM_REQUEST_LOG_ARCHIVE_MAX_BYTES=0