charts.d/mysql.chart.sh

   1 #!/bin/sh
   2
   3 # http://dev.mysql.com/doc/refman/5.0/en/server-status-variables.html
   4 #
   5 # https://dev.mysql.com/doc/refman/5.1/en/show-status.html
   6 # SHOW STATUS provides server status information (see Section 5.1.6, “Server Status Variables”).
   7 # This statement does not require any privilege.
   8 # It requires only the ability to connect to the server.
   9
  10 mysql_update_every=5
  11
  12 declare -A mysql_cmds=() mysql_opts=() mysql_ids=()
  13
  14 mysql_exec() {
  15         local ret
  16
  17         "${@}" -s -e "show global status;"
  18         ret=$?
  19
  20         [ $ret -ne 0 ] && echo "plugin_command_failure $ret"
  21         return $ret
  22 }
  23
  24 mysql_get() {
  25         unset \
  26                 mysql_Bytes_received \
  27                 mysql_Bytes_sent \
  28                 mysql_Queries \
  29                 mysql_Questions \
  30                 mysql_Slow_queries \
  31                 mysql_Handler_commit \
  32                 mysql_Handler_delete \
  33                 mysql_Handler_prepare \
  34                 mysql_Handler_read_first \
  35                 mysql_Handler_read_key \
  36                 mysql_Handler_read_next \
  37                 mysql_Handler_read_prev \
  38                 mysql_Handler_read_rnd \
  39                 mysql_Handler_read_rnd_next \
  40                 mysql_Handler_rollback \
  41                 mysql_Handler_savepoint \
  42                 mysql_Handler_savepoint_rollback \
  43                 mysql_Handler_update \
  44                 mysql_Handler_write \
  45                 mysql_Table_locks_immediate \
  46                 mysql_Table_locks_waited \
  47                 mysql_Select_full_join \
  48                 mysql_Select_full_range_join \
  49                 mysql_Select_range \
  50                 mysql_Select_range_check \
  51                 mysql_Select_scan \
  52                 mysql_Sort_merge_passes \
  53                 mysql_Sort_range \
  54                 mysql_Sort_scan \
  55                 mysql_Created_tmp_disk_tables \
  56                 mysql_Created_tmp_files \
  57                 mysql_Created_tmp_tables \
  58                 mysql_Connection_errors_accept \
  59                 mysql_Connection_errors_internal \
  60                 mysql_Connection_errors_max_connections \
  61                 mysql_Connection_errors_peer_addr \
  62                 mysql_Connection_errors_select \
  63                 mysql_Connection_errors_tcpwrap \
  64                 mysql_Connections \
  65                 mysql_Aborted_connects \
  66                 mysql_Binlog_cache_disk_use \
  67                 mysql_Binlog_cache_use \
  68                 mysql_Binlog_stmt_cache_disk_use \
  69                 mysql_Binlog_stmt_cache_use \
  70                 mysql_Threads_connected \
  71                 mysql_Threads_created \
  72                 mysql_Threads_cached \
  73                 mysql_Threads_running \
  74                 mysql_Innodb_data_read \
  75                 mysql_Innodb_data_written \
  76                 mysql_Innodb_data_reads \
  77                 mysql_Innodb_data_writes \
  78                 mysql_Innodb_log_waits \
  79                 mysql_Innodb_log_write_requests \
  80                 mysql_Innodb_log_writes \
  81                 mysql_Innodb_os_log_fsyncs \
  82                 mysql_Innodb_os_log_pending_fsyncs \
  83                 mysql_Innodb_os_log_pending_writes \
  84                 mysql_Innodb_os_log_written \
  85                 mysql_Innodb_row_lock_current_waits \
  86                 mysql_Innodb_rows_inserted \
  87                 mysql_Innodb_rows_read \
  88                 mysql_Innodb_rows_updated \
  89                 mysql_Innodb_rows_deleted
  90
  91         mysql_plugin_command_failure=0
  92
  93         eval "$(mysql_exec "${@}" |\
  94                 sed \
  95                         -e "s/[[:space:]]\+/ /g" \
  96                         -e "s/\./_/g" \
  97                         -e "s/^\([a-zA-Z0-9_]\+\)[[:space:]]\+\([0-9]\+\)$/mysql_\1=\2/g" |\
  98                 egrep "^mysql_[a-zA-Z0-9_]+=[[:digit:]]+$")"
  99
 100         [ $mysql_plugin_command_failure -eq 1 ] && return 1
 101         [ -z "$mysql_Connections" ] && return 1
 102
 103         mysql_Thread_cache_misses=0
 104         [ $(( mysql_Connections + 1 - 1 )) -gt 0 ] && mysql_Thread_cache_misses=$(( mysql_Threads_created * 10000 / mysql_Connections ))
 105
 106         return 0
 107 }
 108
 109 mysql_check() {
 110         # this should return:
 111         #  - 0 to enable the chart
 112         #  - 1 to disable the chart
 113
 114         local x m mysql_cmd
 115
 116         [ -z "${mysql_cmd}" ] && mysql_cmd="$(which mysql)"
 117
 118         if [ ${#mysql_opts[@]} -eq 0 ]
 119                 then
 120                 mysql_cmds[local]="$mysql_cmd"
 121                 mysql_opts[local]=
 122         fi
 123
 124         # check once if the url works
 125         for m in "${!mysql_opts[@]}"
 126         do
 127                 [ -z "${mysql_cmds[$m]}" ] && mysql_cmds[$m]="$mysql_cmd"
 128                 if [ -z "${mysql_cmds[$m]}" ]
 129                         then
 130                         echo >&2 "$PROGRAM_NAME: mysql: cannot get mysql command for '$m'. Please set mysql_cmds[$m]='/path/to/mysql', in $confd/mysql.conf"
 131                 fi
 132
 133                 mysql_get "${mysql_cmds[$m]}" ${mysql_opts[$m]}
 134                 if [ ! $? -eq 0 ]
 135                 then
 136                         echo >&2 "$PROGRAM_NAME: mysql: cannot get global status for '$m'. Please set mysql_opts[$m]='options' to whatever needed to get connected to the mysql server, in $confd/mysql.conf"
 137                         unset mysql_cmds[$m]
 138                         unset mysql_opts[$m]
 139                         unset mysql_ids[$m]
 140                         continue
 141                 fi
 142
 143                 mysql_ids[$m]="$( fixid "$m" )"
 144         done
 145
 146         if [ ${#mysql_opts[@]} -eq 0 ]
 147                 then
 148                 echo >&2 "$PROGRAM_NAME: mysql: no mysql servers found. Please set mysql_opts[name]='options' to whatever needed to get connected to the mysql server, in $confd/mysql.conf"
 149                 return 1
 150         fi
 151
 152         return 0
 153 }
 154
 155 mysql_create() {
 156         local m
 157
 158         # create the charts
 159         for m in "${mysql_ids[@]}"
 160         do
 161                 cat <<EOF
 162 CHART mysql_$m.bandwidth '' "mysql Bandwidth" "kilobits/s" mysql_$m mysql area 20001 $mysql_update_every
 163 DIMENSION Bytes_received in incremental 8 $((1024 * mysql_update_every))
 164 DIMENSION Bytes_sent out incremental -8 $((1024 * mysql_update_every))
 165
 166 CHART mysql_$m.queries '' "mysql Queries" "queries/s" mysql_$m mysql line 20002 $mysql_update_every
 167 DIMENSION Queries queries incremental 1 $((1 * mysql_update_every))
 168 DIMENSION Questions questions incremental 1 $((1 * mysql_update_every))
 169 DIMENSION Slow_queries slow_queries incremental -1 $((1 * mysql_update_every))
 170
 171 CHART mysql_$m.handlers '' "mysql Handlers" "handlers/s" mysql_$m mysql line 20003 $mysql_update_every
 172 DIMENSION Handler_commit commit incremental 1 $((1 * mysql_update_every))
 173 DIMENSION Handler_delete delete incremental 1 $((1 * mysql_update_every))
 174 DIMENSION Handler_prepare prepare incremental 1 $((1 * mysql_update_every))
 175 DIMENSION Handler_read_first read_first incremental 1 $((1 * mysql_update_every))
 176 DIMENSION Handler_read_key read_key incremental 1 $((1 * mysql_update_every))
 177 DIMENSION Handler_read_next read_next incremental 1 $((1 * mysql_update_every))
 178 DIMENSION Handler_read_prev read_prev incremental 1 $((1 * mysql_update_every))
 179 DIMENSION Handler_read_rnd read_rnd incremental 1 $((1 * mysql_update_every))
 180 DIMENSION Handler_read_rnd_next read_rnd_next incremental 1 $((1 * mysql_update_every))
 181 DIMENSION Handler_rollback rollback incremental 1 $((1 * mysql_update_every))
 182 DIMENSION Handler_savepoint savepoint incremental 1 $((1 * mysql_update_every))
 183 DIMENSION Handler_savepoint_rollback savepoint_rollback incremental 1 $((1 * mysql_update_every))
 184 DIMENSION Handler_update update incremental 1 $((1 * mysql_update_every))
 185 DIMENSION Handler_write write incremental 1 $((1 * mysql_update_every))
 186
 187 CHART mysql_$m.table_locks '' "mysql Tables Locks" "locks/s" mysql_$m mysql line 20004 $mysql_update_every
 188 DIMENSION Table_locks_immediate immediate incremental 1 $((1 * mysql_update_every))
 189 DIMENSION Table_locks_waited waited incremental -1 $((1 * mysql_update_every))
 190
 191 CHART mysql_$m.join_issues '' "mysql Select Join Issues" "joins/s" mysql_$m mysql line 20005 $mysql_update_every
 192 DIMENSION Select_full_join full_join incremental 1 $((1 * mysql_update_every))
 193 DIMENSION Select_full_range_join full_range_join incremental 1 $((1 * mysql_update_every))
 194 DIMENSION Select_range range incremental 1 $((1 * mysql_update_every))
 195 DIMENSION Select_range_check range_check incremental 1 $((1 * mysql_update_every))
 196 DIMENSION Select_scan scan incremental 1 $((1 * mysql_update_every))
 197
 198 CHART mysql_$m.sort_issues '' "mysql Sort Issues" "issues/s" mysql_$m mysql line 20006 $mysql_update_every
 199 DIMENSION Sort_merge_passes merge_passes incremental 1 $((1 * mysql_update_every))
 200 DIMENSION Sort_range range incremental 1 $((1 * mysql_update_every))
 201 DIMENSION Sort_scan scan incremental 1 $((1 * mysql_update_every))
 202
 203 CHART mysql_$m.tmp '' "mysql Tmp Operations" "counter" mysql_$m mysql line 20007 $mysql_update_every
 204 DIMENSION Created_tmp_disk_tables disk_tables incremental 1 $((1 * mysql_update_every))
 205 DIMENSION Created_tmp_files files incremental 1 $((1 * mysql_update_every))
 206 DIMENSION Created_tmp_tables tables incremental 1 $((1 * mysql_update_every))
 207
 208 CHART mysql_$m.connections '' "mysql Connections" "connections/s" mysql_$m mysql line 20009 $mysql_update_every
 209 DIMENSION Connections all incremental 1 $((1 * mysql_update_every))
 210 DIMENSION Aborted_connects aborded incremental 1 $((1 * mysql_update_every))
 211
 212 CHART mysql_$m.binlog_cache '' "mysql Binlog Cache" "transactions/s" mysql_$m mysql line 20010 $mysql_update_every
 213 DIMENSION Binlog_cache_disk_use disk incremental 1 $((1 * mysql_update_every))
 214 DIMENSION Binlog_cache_use all incremental 1 $((1 * mysql_update_every))
 215
 216 CHART mysql_$m.threads '' "mysql Threads" "threads" mysql_$m mysql line 20012 $mysql_update_every
 217 DIMENSION Threads_connected connected absolute 1 1
 218 DIMENSION Threads_created created incremental 1 $((1 * mysql_update_every))
 219 DIMENSION Threads_cached cached absolute -1 1
 220 DIMENSION Threads_running running absolute 1 $((1 * mysql_update_every))
 221
 222 CHART mysql_$m.thread_cache_misses '' "mysql Threads Cache Misses" "misses" mysql_$m mysql area 20013 $mysql_update_every
 223 DIMENSION misses misses absolute 1 100
 224
 225 CHART mysql_$m.innodb_io '' "mysql InnoDB I/O Bandwidth" "kilobytes/s" mysql_$m mysql area 20014 $mysql_update_every
 226 DIMENSION Innodb_data_read read incremental 1 $((1000 * mysql_update_every))
 227 DIMENSION Innodb_data_written write incremental -1 $((1000 * mysql_update_every))
 228
 229 CHART mysql_$m.innodb_io_ops '' "mysql InnoDB I/O Operations" "operations/s" mysql_$m mysql line 20015 $mysql_update_every
 230 DIMENSION Innodb_data_reads reads incremental 1 $((1 * mysql_update_every))
 231 DIMENSION Innodb_data_writes writes incremental -1 $((1 * mysql_update_every))
 232
 233 CHART mysql_$m.innodb_log '' "mysql InnoDB Log Operations" "operations/s" mysql_$m mysql line 20016 $mysql_update_every
 234 DIMENSION Innodb_log_waits waits incremental 1 $((1 * mysql_update_every))
 235 DIMENSION Innodb_log_write_requests write_requests incremental -1 $((1 * mysql_update_every))
 236 DIMENSION Innodb_log_writes writes incremental -1 $((1 * mysql_update_every))
 237
 238 CHART mysql_$m.innodb_os_log '' "mysql InnoDB OS Log Operations" "operations/s" mysql_$m mysql line 20017 $mysql_update_every
 239 DIMENSION Innodb_os_log_fsyncs fsyncs incremental 1 $((1 * mysql_update_every))
 240 DIMENSION Innodb_os_log_pending_fsyncs pending_fsyncs incremental 1 $((1 * mysql_update_every))
 241 DIMENSION Innodb_os_log_pending_writes pending_writes incremental -1 $((1 * mysql_update_every))
 242
 243 CHART mysql_$m.innodb_os_log_io '' "mysql InnoDB OS Log Bandwidth" "kilobytes/s" mysql_$m mysql area 20018 $mysql_update_every
 244 DIMENSION Innodb_os_log_written write incremental -1 $((1000 * mysql_update_every))
 245
 246 CHART mysql_$m.innodb_cur_row_lock '' "mysql InnoDB Current Row Locks" "operations" mysql_$m mysql area 20019 $mysql_update_every
 247 DIMENSION Innodb_row_lock_current_waits current_waits absolute 1 1
 248
 249 CHART mysql_$m.innodb_rows '' "mysql InnoDB Row Operations" "operations/s" mysql_$m mysql area 20020 $mysql_update_every
 250 DIMENSION Innodb_rows_read read incremental 1 $((1 * mysql_update_every))
 251 DIMENSION Innodb_rows_deleted deleted incremental -1 $((1 * mysql_update_every))
 252 DIMENSION Innodb_rows_inserted inserted incremental 1 $((1 * mysql_update_every))
 253 DIMENSION Innodb_rows_updated updated incremental -1 $((1 * mysql_update_every))
 254
 255 EOF
 256
 257         if [ ! -z "$mysql_Binlog_stmt_cache_disk_use" ]
 258                 then
 259                 cat <<EOF
 260 CHART mysql_$m.binlog_stmt_cache '' "mysql Binlog Statement Cache" "statements/s" mysql_$m mysql line 20011 $mysql_update_every
 261 DIMENSION Binlog_stmt_cache_disk_use disk incremental 1 $((1 * mysql_update_every))
 262 DIMENSION Binlog_stmt_cache_use all incremental 1 $((1 * mysql_update_every))
 263 EOF
 264         fi
 265
 266         if [ ! -z "$mysql_Connection_errors_accept" ]
 267                 then
 268                 cat <<EOF
 269 CHART mysql_$m.connection_errors '' "mysql Connection Errors" "connections/s" mysql_$m mysql line 20008 $mysql_update_every
 270 DIMENSION Connection_errors_accept accept incremental 1 $((1 * mysql_update_every))
 271 DIMENSION Connection_errors_internal internal incremental 1 $((1 * mysql_update_every))
 272 DIMENSION Connection_errors_max_connections max incremental 1 $((1 * mysql_update_every))
 273 DIMENSION Connection_errors_peer_addr peer_addr incremental 1 $((1 * mysql_update_every))
 274 DIMENSION Connection_errors_select select incremental 1 $((1 * mysql_update_every))
 275 DIMENSION Connection_errors_tcpwrap tcpwrap incremental 1 $((1 * mysql_update_every))
 276 EOF
 277         fi
 278
 279         done
 280         return 0
 281 }
 282
 283
 284 mysql_update() {
 285         # the first argument to this function is the microseconds since last update
 286         # pass this parameter to the BEGIN statement (see bellow).
 287
 288         # do all the work to collect / calculate the values
 289         # for each dimension
 290         # remember: KEEP IT SIMPLE AND SHORT
 291
 292         # 1. get the counters page from mysql
 293         # 2. sed to remove spaces; replace . with _; remove spaces around =; prepend each line with: local mysql_
 294         # 3. egrep lines starting with:
 295         #    local mysql_client_http_ then one or more of these a-z 0-9 _ then = and one of more of 0-9
 296         #    local mysql_server_all_ then one or more of these a-z 0-9 _ then = and one of more of 0-9
 297         # 4. then execute this as a script with the eval
 298         #
 299         # be very carefull with eval:
 300         # prepare the script and always grep at the end the lines that are usefull, so that
 301         # even if something goes wrong, no other code can be executed
 302
 303         local m x
 304         for m in "${!mysql_ids[@]}"
 305         do
 306                 x="${mysql_ids[$m]}"
 307
 308                 mysql_get "${mysql_cmds[$m]}" ${mysql_opts[$m]}
 309                 if [ $? -ne 0 ]
 310                         then
 311                         unset mysql_ids[$m]
 312                         unset mysql_opts[$m]
 313                         unset mysql_cmds[$m]
 314                         echo >&2 "$PROGRAM_NAME: mysql: failed to get values for '$m', disabling it."
 315                         continue
 316                 fi
 317
 318                 # write the result of the work.
 319                 cat <<VALUESEOF
 320 BEGIN mysql_$x.bandwidth $1
 321 SET Bytes_received = $mysql_Bytes_received
 322 SET Bytes_sent = $mysql_Bytes_sent
 323 END
 324 BEGIN mysql_$x.queries $1
 325 SET Queries = $mysql_Queries
 326 SET Questions = $mysql_Questions
 327 SET Slow_queries = $mysql_Slow_queries
 328 END
 329 BEGIN mysql_$x.handlers $1
 330 SET Handler_commit = $mysql_Handler_commit
 331 SET Handler_delete = $mysql_Handler_delete
 332 SET Handler_prepare = $mysql_Handler_prepare
 333 SET Handler_read_first = $mysql_Handler_read_first
 334 SET Handler_read_key = $mysql_Handler_read_key
 335 SET Handler_read_next = $mysql_Handler_read_next
 336 SET Handler_read_prev = $mysql_Handler_read_prev
 337 SET Handler_read_rnd = $mysql_Handler_read_rnd
 338 SET Handler_read_rnd_next = $mysql_Handler_read_rnd_next
 339 SET Handler_rollback = $mysql_Handler_rollback
 340 SET Handler_savepoint = $mysql_Handler_savepoint
 341 SET Handler_savepoint_rollback = $mysql_Handler_savepoint_rollback
 342 SET Handler_update = $mysql_Handler_update
 343 SET Handler_write = $mysql_Handler_write
 344 END
 345 BEGIN mysql_$x.table_locks $1
 346 SET Table_locks_immediate = $mysql_Table_locks_immediate
 347 SET Table_locks_waited = $mysql_Table_locks_waited
 348 END
 349 BEGIN mysql_$x.join_issues $1
 350 SET Select_full_join = $mysql_Select_full_join
 351 SET Select_full_range_join = $mysql_Select_full_range_join
 352 SET Select_range = $mysql_Select_range
 353 SET Select_range_check = $mysql_Select_range_check
 354 SET Select_scan = $mysql_Select_scan
 355 END
 356 BEGIN mysql_$x.sort_issues $1
 357 SET Sort_merge_passes = $mysql_Sort_merge_passes
 358 SET Sort_range = $mysql_Sort_range
 359 SET Sort_scan = $mysql_Sort_scan
 360 END
 361 BEGIN mysql_$m.tmp $1
 362 SET Created_tmp_disk_tables = $mysql_Created_tmp_disk_tables
 363 SET Created_tmp_files = $mysql_Created_tmp_files
 364 SET Created_tmp_tables = $mysql_Created_tmp_tables
 365 END
 366 BEGIN mysql_$m.connections $1
 367 SET Connections = $mysql_Connections
 368 SET Aborted_connects = $mysql_Aborted_connects
 369 END
 370 BEGIN mysql_$m.binlog_cache $1
 371 SET Binlog_cache_disk_use = $mysql_Binlog_cache_disk_use
 372 SET Binlog_cache_use = $mysql_Binlog_cache_use
 373 END
 374 BEGIN mysql_$m.threads $1
 375 SET Threads_connected = $mysql_Threads_connected
 376 SET Threads_created = $mysql_Threads_created
 377 SET Threads_cached = $mysql_Threads_cached
 378 SET Threads_running = $mysql_Threads_running
 379 END
 380 BEGIN mysql_$m.thread_cache_misses $1
 381 SET misses = $mysql_Thread_cache_misses
 382 END
 383 BEGIN mysql_$m.innodb_io $1
 384 SET Innodb_data_read = $mysql_Innodb_data_read
 385 SET Innodb_data_written = $mysql_Innodb_data_written
 386 END
 387 BEGIN mysql_$m.innodb_io_ops $1
 388 SET Innodb_data_reads = $mysql_Innodb_data_reads
 389 SET Innodb_data_writes = $mysql_Innodb_data_writes
 390 END
 391 BEGIN mysql_$m.innodb_log $1
 392 SET Innodb_log_waits = $mysql_Innodb_log_waits
 393 SET Innodb_log_write_requests = $mysql_Innodb_log_write_requests
 394 SET Innodb_log_writes = $mysql_Innodb_log_writes
 395 END
 396 BEGIN mysql_$m.innodb_os_log $1
 397 SET Innodb_os_log_fsyncs = $mysql_Innodb_os_log_fsyncs
 398 SET Innodb_os_log_pending_fsyncs = $mysql_Innodb_os_log_pending_fsyncs
 399 SET Innodb_os_log_pending_writes = $mysql_Innodb_os_log_pending_writes
 400 END
 401 BEGIN mysql_$m.innodb_os_log_io $1
 402 SET Innodb_os_log_written = $mysql_Innodb_os_log_written
 403 END
 404 BEGIN mysql_$m.innodb_cur_row_lock $1
 405 SET Innodb_row_lock_current_waits = $mysql_Innodb_row_lock_current_waits
 406 END
 407 BEGIN mysql_$m.innodb_rows $1
 408 SET Innodb_rows_inserted = $mysql_Innodb_rows_inserted
 409 SET Innodb_rows_read = $mysql_Innodb_rows_read
 410 SET Innodb_rows_updated = $mysql_Innodb_rows_updated
 411 SET Innodb_rows_deleted = $mysql_Innodb_rows_deleted
 412 END
 413 VALUESEOF
 414
 415                 if [ ! -z "$mysql_Binlog_stmt_cache_disk_use" ]
 416                         then
 417                         cat <<VALUESEOF
 418 BEGIN mysql_$m.binlog_stmt_cache $1
 419 SET Binlog_stmt_cache_disk_use = $mysql_Binlog_stmt_cache_disk_use
 420 SET Binlog_stmt_cache_use = $mysql_Binlog_stmt_cache_use
 421 END
 422 VALUESEOF
 423                 fi
 424
 425                 if [ ! -z "$mysql_Connection_errors_accept" ]
 426                         then
 427                         cat <<VALUESEOF
 428 BEGIN mysql_$m.connection_errors $1
 429 SET Connection_errors_accept = $mysql_Connection_errors_accept
 430 SET Connection_errors_internal = $mysql_Connection_errors_internal
 431 SET Connection_errors_max_connections = $mysql_Connection_errors_max_connections
 432 SET Connection_errors_peer_addr = $mysql_Connection_errors_peer_addr
 433 SET Connection_errors_select = $mysql_Connection_errors_select
 434 SET Connection_errors_tcpwrap = $mysql_Connection_errors_tcpwrap
 435 END
 436 VALUESEOF
 437                 fi
 438         done
 439
 440         [ ${#mysql_ids[@]} -eq 0 ] && echo >&2 "$PROGRAM_NAME: mysql: no mysql servers left active." && return 1
 441         return 0
 442 }
 443