conf.d/python.d/mysql.conf

   1 # netdata python.d.plugin configuration for mysql
   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, mysql also supports the following:
  58 #
  59 #     socket: 'path/to/mysql.sock'
  60 #
  61 #  or
  62 #     host: 'IP or HOSTNAME' # the host to connect to
  63 #     port: PORT             # the port to connect to
  64 #
  65 #  in all cases, the following can also be set:
  66 #
  67 #     user: 'username'       # the mysql username to use
  68 #     pass: 'password'       # the mysql password to use
  69 #
  70
  71 # ----------------------------------------------------------------------
  72 # mySQL CONFIGURATION
  73 #
  74 # netdata does not need any privilege - only the ability to connect
  75 # to the mysql server (netdata will not be able to see any data).
  76 #
  77 # Execute these commands to give the local user 'netdata' the ability
  78 # to connect to the mysql server on localhost, without a password:
  79 #
  80 # > create user 'netdata'@'localhost';
  81 # > grant usage on *.* to 'netdata'@'localhost' with grant option;
  82 # > flush privileges;
  83 #
  84 # with the above statements, netdata will be able to gather mysql
  85 # statistics, without the ability to see or alter any data or affect
  86 # mysql operation in any way. No change is required below.
  87
  88 # ----------------------------------------------------------------------
  89 # AUTO-DETECTION JOBS
  90 # only one of them will run (they have the same name)
  91
  92 mycnf1:
  93   name     : 'local'
  94   'my.cnf' : '/etc/my.cnf'
  95
  96 mycnf2:
  97   name     : 'local'
  98   'my.cnf' : '/etc/mysql/my.cnf'
  99
 100 debiancnf:
 101   name     : 'local'
 102   'my.cnf' : '/etc/mysql/debian.cnf'
 103
 104 socket1:
 105   name     : 'local'
 106   # user     : ''
 107   # pass     : ''
 108   socket   : '/var/run/mysqld/mysqld.sock'
 109
 110 socket2:
 111   name     : 'local'
 112   # user     : ''
 113   # pass     : ''
 114   socket   : '/var/run/mysqld/mysql.sock'
 115
 116 socket3:
 117   name     : 'local'
 118   # user     : ''
 119   # pass     : ''
 120   socket   : '/var/lib/mysql/mysql.sock'
 121
 122 socket4:
 123   name     : 'local'
 124   # user     : ''
 125   # pass     : ''
 126   socket   : '/tmp/mysql.sock'
 127
 128 tcp:
 129   name     : 'local'
 130   # user     : ''
 131   # pass     : ''
 132   host     : 'localhost'
 133   port     : '3306'
 134   # keep in mind port might be ignored by mysql, if host = 'localhost'
 135   # http://serverfault.com/questions/337818/how-to-force-mysql-to-connect-by-tcp-instead-of-a-unix-socket/337844#337844
 136
 137 tcpipv4:
 138   name     : 'local'
 139   # user     : ''
 140   # pass     : ''
 141   host     : '127.0.0.1'
 142   port     : '3306'
 143
 144 tcpipv6:
 145   name     : 'local'
 146   # user     : ''
 147   # pass     : ''
 148   host     : '::1'
 149   port     : '3306'
 150
 151
 152 # Now we try the same as above with user: root
 153 # A few systems configure mysql to accept passwordless
 154 # root access.
 155
 156 mycnf1_root:
 157   name     : 'local'
 158   user     : 'root'
 159   'my.cnf' : '/etc/my.cnf'
 160
 161 mycnf2_root:
 162   name     : 'local'
 163   user     : 'root'
 164   'my.cnf' : '/etc/mysql/my.cnf'
 165
 166 socket1_root:
 167   name     : 'local'
 168   user     : 'root'
 169   # pass     : ''
 170   socket   : '/var/run/mysqld/mysqld.sock'
 171
 172 socket2_root:
 173   name     : 'local'
 174   user     : 'root'
 175   # pass     : ''
 176   socket   : '/var/run/mysqld/mysql.sock'
 177
 178 socket3_root:
 179   name     : 'local'
 180   user     : 'root'
 181   # pass     : ''
 182   socket   : '/var/lib/mysql/mysql.sock'
 183
 184 socket4_root:
 185   name     : 'local'
 186   user     : 'root'
 187   # pass     : ''
 188   socket   : '/tmp/mysql.sock'
 189
 190 tcp_root:
 191   name     : 'local'
 192   user     : 'root'
 193   # pass     : ''
 194   host     : 'localhost'
 195   port     : '3306'
 196   # keep in mind port might be ignored by mysql, if host = 'localhost'
 197   # http://serverfault.com/questions/337818/how-to-force-mysql-to-connect-by-tcp-instead-of-a-unix-socket/337844#337844
 198
 199 tcpipv4_root:
 200   name     : 'local'
 201   user     : 'root'
 202   # pass     : ''
 203   host     : '127.0.0.1'
 204   port     : '3306'
 205
 206 tcpipv6_root:
 207   name     : 'local'
 208   user     : 'root'
 209   # pass     : ''
 210   host     : '::1'
 211   port     : '3306'
 212
 213
 214 # Now we try the same as above with user: netdata
 215
 216 mycnf1_netdata:
 217   name     : 'local'
 218   user     : 'netdata'
 219   'my.cnf' : '/etc/my.cnf'
 220
 221 mycnf2_netdata:
 222   name     : 'local'
 223   user     : 'netdata'
 224   'my.cnf' : '/etc/mysql/my.cnf'
 225
 226 socket1_netdata:
 227   name     : 'local'
 228   user     : 'netdata'
 229   # pass     : ''
 230   socket   : '/var/run/mysqld/mysqld.sock'
 231
 232 socket2_netdata:
 233   name     : 'local'
 234   user     : 'netdata'
 235   # pass     : ''
 236   socket   : '/var/run/mysqld/mysql.sock'
 237
 238 socket3_netdata:
 239   name     : 'local'
 240   user     : 'netdata'
 241   # pass     : ''
 242   socket   : '/var/lib/mysql/mysql.sock'
 243
 244 socket4_netdata:
 245   name     : 'local'
 246   user     : 'netdata'
 247   # pass     : ''
 248   socket   : '/tmp/mysql.sock'
 249
 250 tcp_netdata:
 251   name     : 'local'
 252   user     : 'netdata'
 253   # pass     : ''
 254   host     : 'localhost'
 255   port     : '3306'
 256   # keep in mind port might be ignored by mysql, if host = 'localhost'
 257   # http://serverfault.com/questions/337818/how-to-force-mysql-to-connect-by-tcp-instead-of-a-unix-socket/337844#337844
 258
 259 tcpipv4_netdata:
 260   name     : 'local'
 261   user     : 'netdata'
 262   # pass     : ''
 263   host     : '127.0.0.1'
 264   port     : '3306'
 265
 266 tcpipv6_netdata:
 267   name     : 'local'
 268   user     : 'netdata'
 269   # pass     : ''
 270   host     : '::1'
 271   port     : '3306'
 272