conf.d/python.d/smartd_log.conf

   1 # netdata python.d.plugin configuration for smartd log
   2 #
   3 # This file is in YaML format. Generally the format is:
   4 #
   5 # name: value
   6 #
   7 # There are 2 sections:
   8 #  - global variables
   9 #  - one or more JOBS
  10 #
  11 # JOBS allow you to collect values from multiple sources.
  12 # Each source will have its own set of charts.
  13 #
  14 # JOB parameters have to be indented (using spaces only, example below).
  15
  16 # ----------------------------------------------------------------------
  17 # Global Variables
  18 # These variables set the defaults for all JOBs, however each JOB
  19 # may define its own, overriding the defaults.
  20
  21 # update_every sets the default data collection frequency.
  22 # If unset, the python.d.plugin default is used.
  23 # update_every: 1
  24
  25 # priority controls the order of charts at the netdata dashboard.
  26 # Lower numbers move the charts towards the top of the page.
  27 # If unset, the default for python.d.plugin is used.
  28 # priority: 60000
  29
  30 # retries sets the number of retries to be made in case of failures.
  31 # If unset, the default for python.d.plugin is used.
  32 # Attempts to restore the service are made once every update_every
  33 # and only if the module has collected values in the past.
  34 # retries: 5
  35
  36 # ----------------------------------------------------------------------
  37 # JOBS (data collection sources)
  38 #
  39 # The default JOBS share the same *name*. JOBS with the same name
  40 # are mutually exclusive. Only one of them will be allowed running at
  41 # any time. This allows autodetection to try several alternatives and
  42 # pick the one that works.
  43 #
  44 # Any number of jobs is supported.
  45 #
  46 # All python.d.plugin JOBS (for all its modules) support a set of
  47 # predefined parameters. These are:
  48 #
  49 # job_name:
  50 #     name: myname     # the JOB's name as it will appear at the
  51 #                      # dashboard (by default is the job_name)
  52 #                      # JOBs sharing a name are mutually exclusive
  53 #     update_every: 1  # the JOB's data collection frequency
  54 #     priority: 60000  # the JOB's order on the dashboard
  55 #     retries: 5       # the JOB's number of restoration attempts
  56 #
  57 # Additionally to the above, smartd_log also supports the following:
  58 #
  59 #    log_path: '/path/to/smartdlogs'   # path to smartd log files. Default is /var/log/smartd
  60 #    raw_values: no                    # raw or normalized values on charts. Default is normalized.
  61 #    smart_attributes: '1 2 3 4 44'    # add additional smart attributes charts. Default are ['1', '4', '5', '7', '9', '12', '193', '194', '197', '198', '200'].
  62 #
  63 # ----------------------------------------------------------------------
  64 # Additional information
  65 #  Plugin reads smartd log files (-A option).
  66 #  You need to add (man smartd) to /etc/default/smartmontools '-i 600 -A /var/log/smartd/' to pass additional options to smartd on startup
  67 #  Then restart smartd service and check /path/log/smartdlogs
  68 #  ls /var/log/smartd/
  69 #  CDC_WD10EZEX_00BN5A0-WD_WCC3F7FLVZS9.ata.csv  WDC_WD10EZEX_00BN5A0-WD_WCC3F7FLVZS9.ata.csv  ZDC_WD10EZEX_00BN5A0-WD_WCC3F7FLVZS9.ata.csv
  70 #
  71 # Smartd APPEND logs at every run. Its NOT RECOMMENDED to set '-i' option below 60 sec.
  72 # STRONGLY RECOMMENDED to create smartd conf file for logrotate
  73 #
  74 # RAW vs NORMALIZED values
  75 # "Normalized value", commonly referred to as just "value". This is a most universal measurement, on the scale from 0 (bad) to some maximum (good) value.
  76 # Maximum values are typically 100, 200 or 253. Rule of thumb is: high values are good, low values are bad.
  77 #
  78 # "Raw value" - the value of the attribute as it is tracked by the device, before any normalization takes place.
  79 # Some raw numbers provide valuable insight when properly interpreted. These cases will be discussed later on.
  80 # Raw values are typically listed in hexadecimal numbers. The raw value has different structure for different vendors and is often not meaningful as a decimal number.
  81 #
  82 #
  83 # JOB configuration
  84 #
  85 log_path: '/var/log/smartd'