You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Log level for file logs (debug, info, warn, error). Default changed from debug to reduce verbosity
1441
+
- ``info``
1442
+
- Log level for file logs (debug, info, warn, error). Provides good operational visibility without excessive verbosity
1443
1443
* - ``KOPIA_LOG_DIR_MAX_FILES``
1444
-
- ``10``
1445
-
- Maximum number of CLI log files to retain. Older files are automatically deleted
1444
+
- ``3``
1445
+
- Maximum number of CLI log files to retain. Optimized for Kubernetes where logs are externally collected
1446
1446
* - ``KOPIA_LOG_DIR_MAX_AGE``
1447
-
- ``24h``
1448
-
- Maximum age of CLI log files. Format: duration string (e.g., "24h", "7d", "168h")
1447
+
- ``4h``
1448
+
- Maximum age of CLI log files. Short retention since Kubernetes typically has external logging
1449
1449
* - ``KOPIA_CONTENT_LOG_DIR_MAX_FILES``
1450
-
- ``10``
1451
-
- Maximum number of content log files to retain (low-level formatting logs)
1450
+
- ``3``
1451
+
- Maximum number of content log files to retain. Minimal retention for immediate debugging only
1452
1452
* - ``KOPIA_CONTENT_LOG_DIR_MAX_AGE``
1453
-
- ``24h``
1454
-
- Maximum age of content log files. These logs don't contain sensitive data
1453
+
- ``4h``
1454
+
- Maximum age of content log files. Short retention optimized for Kubernetes environments
1455
1455
1456
1456
**Default Configuration Rationale**:
1457
1457
@@ -1593,7 +1593,7 @@ Best Practices for Logging in Kubernetes
1593
1593
1594
1594
1. **Use External Logging Systems**: Rely on Kubernetes pod logs and external aggregation (Loki, ElasticSearch, Splunk) rather than file logs.
1595
1595
1596
-
2. **Conservative Defaults**: The VolSync defaults (warn level, 10 files, 24h retention) work well for most use cases.
1596
+
2. **Conservative Defaults**: The VolSync defaults (info level, 3 files, 4h retention) are optimized for Kubernetes environments where external logging is typically used.
1597
1597
1598
1598
3. **Monitor Cache PVC Usage**: Set up alerts for cache PVC usage to catch issues early:
1599
1599
@@ -1681,9 +1681,9 @@ If you're experiencing cache PVC issues with existing deployments:
1681
1681
kubectl edit secret kopia-config -n <namespace>
1682
1682
1683
1683
# Add the logging configuration
1684
-
# KOPIA_FILE_LOG_LEVEL: "warn"
1685
-
# KOPIA_LOG_DIR_MAX_FILES: "10"
1686
-
# KOPIA_LOG_DIR_MAX_AGE: "24h"
1684
+
# KOPIA_FILE_LOG_LEVEL: "info"
1685
+
# KOPIA_LOG_DIR_MAX_FILES: "3"
1686
+
# KOPIA_LOG_DIR_MAX_AGE: "4h"
1687
1687
1688
1688
3. **Trigger New Backup**: Force a new backup to apply settings
0 commit comments