Мониторинг параметров MySQL в Zabbix

dev-db/mysql-5.1.67
net-analyzer/zabbix-2.2.2-r1

Статья рассказывает о том как настроить мониторинг многочисленных параметров MySQL сервера с помощью Zabbix.

Как ни странно в сети оказалось весьма мало действенных и эффективных рецептов по мониторингу производительности MySQL в заббиксе, поэтому я предлагаю свой вариант. Он отличается большой гибкостью и эффективностью, т.к. он не использует ни perl ни php скриптов, а только bash и в нем предусмотрен кэш.

Установка скрипта

Создание папки для скриптов:

mkdir /etc/zabbix/scripts/
chown root:zabbix -R /etc/zabbix/scripts/
chmod 750 /etc/zabbix/scripts/

Создадим сам скрипт:

Листинг

#!/bin/bash
##### OPTIONS VERIFICATION #####
if [[ -z "$1" || -z "$2" ]]; then
  exit 1
fi
##### PARAMETERS #####
RESERVED="$1"
METRIC="$2"
USER="${3:-user}"
PASS="${4:-pass}"
#
MYSQLADMIN="/usr/bin/mysqladmin"
MYSQL="/usr/bin/mysql"
CACHE_TTL="55"
CACHE_FILE="/tmp/zabbix.mysql-stats.cache"
EXEC_TIMEOUT="1"
NOW_TIME=`date '+%s'`
##### RUN #####
if [ "${METRIC}" = "alive" ]; then
  ${MYSQLADMIN} -u${USER} -p${PASS} ping | grep alive | wc -l | head -n1
  exit 0
fi
if [ "${METRIC}" = "version" ]; then
  ${MYSQL} -V | sed -e 's/^.*\(ver.*\)$/\1/gI' | head -n1
  exit 0
fi
#
if [ -s "${CACHE_FILE}" ]; then
  CACHE_TIME=`stat -c"%Y" "${CACHE_FILE}"`
else
  CACHE_TIME=0
fi
DELTA_TIME=$((${NOW_TIME} - ${CACHE_TIME}))
#
if [ ${DELTA_TIME} -lt ${EXEC_TIMEOUT} ]; then
  sleep $((${EXEC_TIMEOUT} - ${DELTA_TIME}))
elif [ ${DELTA_TIME} -gt ${CACHE_TTL} ]; then
  echo "" >> "${CACHE_FILE}" # !!!
  DATACACHE=`${MYSQLADMIN} -u${USER} -p${PASS} extended-status 2>&1`
  echo "${DATACACHE}" > "${CACHE_FILE}" # !!!
  chmod 640 "${CACHE_FILE}"
fi
#
cat "${CACHE_FILE}" | grep -iw "$METRIC" | cut -d'|' -f3 | head -n1
#
exit 0

Кеш необходим ввиду особенности работы zabbix когда на каждый элемент собираемых данных выполняется по отдельному запросу. Т.е. если вы мониторинге 20 параметров MySQL, то за один период обновления будет инициировано 20 обращений к БД.
Время действия кэша в секундах должно устанавливается чуть меньше чем период опроса элементов.

Установка прав

chown root:zabbix /etc/zabbix/scripts/mysql-stats.sh
chmod 550 /etc/zabbix/scripts/mysql-stats.sh

Проверка

sudo -u zabbix /etc/zabbix/scripts/mysql-stats.sh none questions USER PASSWORD

Вы должны получить статистические данные, если этого не произошло, то конфигурация выполнена не правильно.

Если для проверки скрипт запускался с правами root, то он будет владельцем кэш файла - удалите кэш файл после проверок.

Чтобы посмотреть список доступных метрик выполните

mysqladmin -uroot -p extended-status

Настройка MySQL

Создать пользователя zabbix@localhost в MySQL.

mysql [(NONE)]> SHOW grants FOR zabbix@localhost;
+---------------------------------------------------------------------------------------------------------------+
| Grants FOR zabbix@localhost                                                                                   |
+---------------------------------------------------------------------------------------------------------------+
| GRANT USAGE ON *.* TO 'zabbix'@'localhost' IDENTIFIED BY PASSWORD '*F5C5B411175D3849C095FBCBD20C8F084E7AC49E' |
+---------------------------------------------------------------------------------------------------------------+

Настройка Zabbix сервера

Вызов скрипта через zabbix-agent

Настройка

...
 
UserParameter=mysql-stats[*],/etc/zabbix/scripts/mysql-stats.sh "none" "$1" [USER] [PASSWORD]

Для работы скрипта нужно передать имя пользователя и пароль для подключения к MySQL. Их можно указать в конфиге zabbix-agent или в самом скрипте.

Перезапустить

/etc/init.d/zabbix-agentd restart

Проверка

zabbix_get -s HOST -k 'mysql-stats[questions]'

Для контролируемых данных нужно создать соответствующее элементы с типом «Zabbix агент» и ключом вида:

mysql-stats[key]

где key - контролируемая метрика

Готовый Шаблон для мониторинга MySQL Stats (agent) с уже настроенными элементами и графиками.

Результат

Пример графиков:

http://dev.mysql.com/doc/refman/5.1/en/server-status-variables.html

Обсуждение

Сергей Усов, 2010/11/02 14:46

Спасибо!

7x7, 2011/02/11 14:49, 2011/06/06 16:41

у меня заработало после исправления

TIMECACHE=`stat -c"%Z" "$CACHE"`

на

TIMECACHE=`stat -f "%c" "$CACHE"`

Sergey Budnikov, 2011/05/04 11:01

может быть проблема с правами на файлик /tmp/mysqlstat.cache, если вы в первый раз запустили скрип не забикс агентом, будьте внимательней. А так все работает, спасибо!

Александр, 2011/08/03 10:33

Спасибо! Установка прошла без проблем.

nik, 2011/11/23 20:47

а как можно приспособить данный скриgт для получения данных с других серверов mysql(под win)? или может есть что иное для мониторига множества баз

DRek, 2012/01/09 20:46

Не подскажете в чем может быть проблема? не снимается статистика через скрипт,в логах пишет:

sh: /etc/zabbix/scripts/mysql_stat.sh: Permission denied

при этом например

/etc/zabbix/scripts/mysql_stat.sh qcache_hits username pass

из консоли срабатывает без проблем

Алексей, 2012/02/15 18:02

Прописал логин и пароль на агенте.

UserParameter=mysql[*],/etc/zabbix/externalscripts/mysql_stat.sh $1 root my_password

Запускаю с сервера:

zabbix_get -s server_ip  -k "mysql[qcache_hits]"
ZBX_NOTSUPPORTED

В логе агента появляется

/etc/zabbix/externalscripts/mysql_stat.sh: not found

хотя он именно там и есть. Подскажите куда копать.

Konstantin, 2012/05/14 11:48

Супер. Спасибо

Кадышев Денис, 2012/11/27 09:09, 2013/12/15 20:31

у команды stat на Linux и FreeBSD синтаксис разный! в Linux используется GNU stat

Владислав, 2014/07/02 08:13

Чтобы графики из приложенного шаблона заработали, нужно

Вместо UserParameter=mysql-stats[*],/etc/zabbix/scripts/mysql-stats.sh "none" "$1" [USER] [PASSWORD] и zabbix_get -s HOST -k 'mysql-stats[questions]'

Указать UserParameter=mysql[*],/etc/zabbix/scripts/mysql-stats.sh "none" "$1" [USER] [PASSWORD] и тогда проверка по zabbix_get -s HOST -k 'mysql[questions]'

В шаблоне все item через mysql[*] прописаны

Максис, 2014/07/18 10:48, 2014/07/18 11:05

Все сделал по статье вроде, но ни один параметр не работает. В логах zabbix-сервера:

error reason for "mysql:mysql-stats[aborted_connects]" changed: "Not supported by Zabbix Agent"
error reason for "mysql:mysql-stats[alive]" changed: "Not supported by Zabbix Agent"
error reason for "mysql:mysql-stats[bytes_received]" changed: "Not supported by Zabbix Agent"

и т.д.

В чем может быть дело? Куда копать?

Lev, 2017/11/03 00:06

Ребят кто шарит подскажите! Этот шаблон, Template App MySQL, он мониторит полностью всю субд mysql? А могу ли я как-то настроить мониторинг одной отдельной базы???

Tudor, 2018/02/21 17:52

to run this script you don't need any mysql privileges "SHOW STATUS provides server status information (see Section 5.1.7, “Server Status Variables”). This statement does not require any privilege. It requires only the ability to connect to the server." So, just create a user to monitor: Create user ‘zabbix’@’localhost’ identified by ‘password’; Thanks a lot for your article. Is the best under the whole Gogole results

Полное имя:

Эл. адрес:

Ваш комментарий. Вики-синтаксис разрешён:

Пожалуйста, решите задачу, чтобы доказать, что вы человек: 31 -4 = Пожалуйста, оставьте это поле пустым:

Подписаться на комментарии