From: Sebastian Harl <sh@tokkee.org>
Date: Thu, 17 May 2012 13:41:38 +0000 (+0200)
Subject: README.Debian: Added section 'Cleanup of old data'.
X-Git-Tag: collectd-4.10.7-1~24
X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=93c31961f8f127af6f6ddf13df58c0d1b9d62113;p=pkg-collectd.git

README.Debian: Added section 'Cleanup of old data'.

… explaining how to get rid of out-dated data files (e.g. RRD files).
---

diff --git a/debian/README.Debian b/debian/README.Debian
index 7513ac2..fbbb43f 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -61,6 +61,48 @@ solutions are welcome.
   with collectd. See /usr/share/doc/collectd/examples/collection3/README for
   details. This is a successor for collection.cgi.
 
+Cleanup of old data:
+--------------------
+
+collectd itself does not take care of removing any data files (e.g. RRDtool)
+that are no longer updated (e.g., no longer existing hosts or instances).
+There are a couple of ways to take care of that. In any case, double-check the
+list of files to be removed before doing so! We do not take responsibility for
+any data loss or similar.
+
+- Check the last modification time of all RRD files:
+
+    find /var/lib/collectd/rrd/ -mtime +30 -type f
+
+  This will list all files that have not been updated within the last 30 days.
+  After double-checking the list of files, use a command like the following to
+  delete old files:
+
+    find /var/lib/collectd/rrd/ -mtime +30 -type f | xargs rm
+
+  NOTE: Some versions of RRDtool did not update mtime when writing to a file.
+        This has been fixed in version 1.3.5 of RRDtool. If your version is
+        affected by that, this approach does not work.
+
+- Check the 'last_update' header of the RRD files:
+
+    export IFS="
+    "
+    for file in $( find /var/lib/collectd/rrd/ -type f -name '*.rrd' ); do
+        last_update=$( rrdtool info $file | grep last_update | cut -d' ' -f3 )
+        if test -n "$last_update" \
+                -a $(( $( date +%s ) - $last_update )) -gt 2592000; then
+            echo $file
+        fi
+    done
+
+  This will also list all files that have not been updated within the last 30
+  days. It's a bit more expensive since each and every RRD file will have to
+  be read from disk rather than checking the file-system meta-data only.
+
+When doing those checks, take into account any caching times configured in the
+RRDtool plugin or when using RRDCacheD.
+
 Building your own plugins:
 --------------------------
 
diff --git a/debian/changelog b/debian/changelog
index 43a9012..9d17e27 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -10,8 +10,11 @@ collectd (4.10.5-1) unstable; urgency=low
     - Use dpkg-buildflags to determine compiler/linker flags; this also
       enables hardening build flags; thanks to Moritz Muehlenhoff for
       providing the patch (Closes: #656271).
+  * debian/README.Debian:
+    - Added section 'Cleanup of old data' explaining how to get rid of
+      out-dated data files (e.g. RRD files).
 
- -- Sebastian Harl <tokkee@debian.org>  Tue, 14 Feb 2012 08:05:43 +0100
+ -- Sebastian Harl <tokkee@debian.org>  Thu, 17 May 2012 15:39:49 +0200
 
 collectd (4.10.4-1) unstable; urgency=low