.werks/8353

   1 Title: Support for new RRD format with more efficient Disk IO
   2 Level: 2
   3 Edition: cee
   4 Component: metrics
   5 Compatible: compat
   6 Version: 1.2.7i4
   7 Date: 1447331088
   8 Class: feature
   9
  10 The Check_MK Micro Core now supports a new format when creating
  11 RRD files. Here:
  12
  13 LI:RRD files are kept below the new directory <tt>~/var/check_mk/rrd</tt>.
  14 LI:All metrics of one service are kept in one RRD
  15
  16 Because now all metrics of a service are stored together in one RRD less
  17 disk blocks need to be updated when a new value is entered. This saves
  18 Disk IO. This is possible because the RRDTool version 1.5 now supports
  19 changing existing RRDs. That way if a check outputs new metrics these can
  20 be added to an existing RRD.
  21
  22 H2:Switch to the new format
  23
  24 The new CMC format is not used automatically - neither for existing nor
  25 for new sites. The default for new sites might be changed in future, though.
  26 Switching your site to the new CMC format is done in the following steps:
  27
  28 1. Make a backup of your current RRDs (<tt>~/var/pnp4nagios/perfdata</tt>). You might
  29 be tended to skip this step as the amount of data can be large. But you have
  30 been warned.
  31
  32 2. Go to the ruleset <i>Configuration of RRD databases of services</i> (and
  33 <i>hosts</i> resp.)
  34
  35 3. Create a rule for some (or all) hosts with the setting
  36 <i> RRD storage format: One RRD per host/service (saves disk IO, only with CMC)</i>
  37
  38 4. Activate Changes -  And now your system is in a state where <b>new</b>
  39 RRDs will automatically be created
  40 in the new format in <tt>~/var/check_mk/rrd</tt>.
  41
  42 5. In order to migrate the existing RRDs use the following command:
  43
  44 C+:
  45 OM:cmk --convert-rrds -v
  46 C-:
  47
  48 It is also possible to specify a list of hosts and limit the conversion
  49 to these:
  50
  51 C+:
  52 OM:cmk --convert-rrds -v server01 server02
  53 C-:
  54
  55 Note: This keeps the existing RRDs present in <tt>~/var/pnp4nagios/perfdata</tt>
  56 and needs lots of diskspace. If you low in diskspace and are bold or if you
  57 have a backup (even better) you can directly delete the PNP format RRDs:
  58
  59 C+:
  60 OM:cmk --convert-rrds --delete-rrds -v
  61 C-:
  62
  63 If you decided not to delete the old RRDs in the first place you can run
  64 the command with the option <tt>--delete-rrds</tt> at any time later.
  65
  66 Since all of you zigs of gigabytes of RRDs needs to be transformed this
  67 can take a long time. The good news: you do not need a downtime on your
  68 monitoring during this period. New RRDs are being used for storing current
  69 data as soon as they exist so with a bit luck and good disk performance you
  70 will not loose data points.
  71
  72 H2:Old PNP SINGLE format
  73
  74 Note: The new RRD format is almost identical with the format <tt>SINGLE</tt> that
  75 was default in PNP4Nagios a long time ago. PNP was not able to alter the
  76 list of metrics that a service did output - however. So whenever the list of
  77 performance data of a check changed the graphs ended at that point of time.
  78 There is currently no direct migration from PNP's <tt>SINGLE</tt> format
  79 to the new CMC format. But you can go the intermediate step with
  80 <tt>cmk --convert-rrds --split</tt>.
  81