| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Résumé
Cette page décrit le contenu du pack MySQL livré permettant de superviser une base MySQL. Les checks du packs supervisent différents indicateurs, comme par exemple :
- Le temps de réponse
- Le nombre de connexions
- Le ratio de cache
- etc...
Plusieurs étapes de configuration sont nécessaires afin de superviser une base de données MySQL :
- Analyser ce qui est disponible dans le pack MySQL livré avec Shinken Entreprise
- Mettre en place un compte MySQL utilisé par les scripts de supervision
- Tester la connexion à la base de données
- Configurer l'hôte Shinken pour démarrer la supervision de la base
Contenu du pack MySQL
Pour faciliter la supervision de bases de données MySQL, certaines étapes de configuration sont déjà effectuées par l'installation de Shinken :
Abstract
This document describes how you can monitor an MySQL database server such as:
- Connection time
- The number of connections
- Cache hit
- etc
There are some steps you’ll need to follow in order to monitor a new database machine:
- Understand what is already available (in the Shinken Entreprise installation)
- Setup the MySQL user account
- Test the connection to the database
- Setup your server host definition
| Panel | ||||
|---|---|---|---|---|
| ||||
|
What is already available in the Shinken Installation
To make your life a bit easier, a few configuration tasks have already been done for you:
Installation of check_mysql_health plugin :- Le script check_mysql_health utilisé par la supervision est installé dans
- /var/lib/shinken/libexec/check_mysql_health
- Des modèles préconfigurés utilisables sont installés dans Shinken Entreprise (ils seront décrits en détail dans la suite de cette documentation)
| Tip | ||
|---|---|---|
| ||
| We suppose here that the MySQL server you want to monitor is named On suppose dans la suite de cette documentation que le serveur MySQL à superviser est un serveur Linux appelé "srv-lin-1 and is a Linux. Please change the configuration and commands according with the real name of your server.". Il faudra donc adapter les commandes qui utilisent ce nom d'hôte à votre infrastructure. |
Mise en place d'un compte de supervision MySQL
Pour pouvoir superviser la base de données, il faut d'abord créer un compte sur la base MySQL qui va être utilisé par Shinken pour récupérer les informations nécessaires à la supervision.
Pour commencer, on se connecte avec l'utilisateur root sur la base de données (changer "password" par le mot de passe root de la base de données)
Setup the MySQL user account
Connect with a root account on your MySQL database. change ‘password’ with your mysql root password :
| Code Block | |||||
|---|---|---|---|---|---|
| |||||
lin lin-srv-1:# mysql -u root -ppasswordp password |
On crée ensuite un utilisateur "shinken" (remplacer "shinkenpassword" par un mot de passe fort au choix à utiliser pour l'utilisateur shinken) And create a shinken user :
| Code Block | ||||
|---|---|---|---|---|
| ||||
GRANT usage ON *.* TO 'shinken'@'%' IDENTIFIED BY 'shinkenpassword'; |
It’s a good thing to change the shinkenpassword to another password. Then you need to update the On change ensuite dans Shinken les données globales utilisées par le pack MySQL qui définissent l'utilisateur et le mot de passe à utiliser pour la connexion à la base de données. Dans /etc/shinken/resource.d/mysql.cfg :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$MYSQLUSER$=shinken $MYSQLPASSWORD$=shinkenpassword |
Vérification de la connexion à la base de données
Une fois l'utilisateur défini dans la base de données MySQL, on peut vérifier que la connexion est opérationnelle avec la commande suivante :
| Code Block | ||||
|---|---|---|---|---|
|
Test the connection
To see if the connection to the MySQL server is ok, just launch :
/var/lib/shinken/libexec/check_mysql_health --hostname "srv-lin-1" --username "shinken" --password "shinkenpassword" --mode connection-time |
What is checked with the templates
Public templatesmysql
This is the very basic MySQL template allowing to know if your MySQL database server is running and usable.
Every MySQL templates (except Mysql-connection-method) use it as a parent template.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| connection | Time to connect to the server | 0 to n | 1 | 5 |
| restart | Time the server is running | 0 to n | 10: | 5: |
| slow_queries | slow_queries | 0 to n | 0.1 | 1 |
| tmp_disk_tables | Percent of temp tables created on disk | 0 to n | 25 | 50 |
mysql-full
Contains all MySQL host templates listed in the Shinken Adminstrators templates.
| Warning | ||
|---|---|---|
| ||
Using the mysql-full template will require a lot of resources on your poller daemon. We advise to use only the needed templates. |
Shinken Administrator templates (can't be seen by other users)
mysql-connection-method
This template describes the method to connect to MySQL server. Every MySQL templates use it as a parent template.
mysql-cluster
This template gives informations about the MySQL cluster.
mysql-innoDB
This template gives informations about innoDB buffers and logwaits.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| bufferpool_hitrate | InnoDB buffer pool hitrate | 0 to n | 99: | 95: |
| bufferpool_wait_free | InnoDB buffer pool waits for clean page available | 0 to n | 1 | 10 |
| log_waits | InnoDB log waits because of a too small log buffer | 0 to n | 1 | 10 |
Modèles d'hôtes disponibles dans le pack MySQL
Le pack MySQL livre des modèles d'hôtes préconfigurés qui peuvent être utilisés avec très peu de configuration manuelle. Parmi ces modèles d'hôtes, certains sont visibles par les administrateurs de SI (modèles publics) tandis que d'autres plus précis ne sont visibles que pour les administrateurs Shinken.
Modèles d'hôtes publics
mysql
Le modèle "mysql" est le modèle d'hôte de base du pack qui permet de vérifier certains indicateurs essentiels de la base :
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-connection | Temps de connexion au serveur | 0 à n (en secondes) | 1 | CONNECTIONTIME_WARN | 5 | CONNECTIONTIME_CRIT |
| Mysql-restart | Temps écoulé depuis le dernier redémarrage de MySQL | 0:0 à n:m (minutes:secondes) | 10: (10mn) | MYSQL_UPTIME_WARN | 5: (5mn) | MYSQL_UPTIME_CRIT |
| Mysql-slow_queries | Ratio de requêtes par seconde détectées comme "lentes" | 0 à n/seconde | 0.1 | SLOWQUERIES_WARN | 1 | SLOWQUERIES_CRIT |
| Mysql-tmp_disk_tables | Pourcentage de tables temporaires créées sur le disque au lieu de directement en mémoire | 0 à 100 | 25 | TMPDISKTABLES_WARN | 50 | TMPDISKTABLES_CRIT |
Ce modèle est également utilisé par les autres modèles d'hôtes du pack (sauf mysql-connection-method) en tant de modèle parent. Tous les autres modèles d'hôtes présentés ci-dessous auront donc également les mêmes checks décrits dans le tableau précédent.
mysql-full
Ce modèle regroupe l'ensemble des modèles du pack MySQL listés dans la partie "Modèles réservés aux administrateurs Shinken".
| Warning | ||
|---|---|---|
| ||
L'utilisation du modèle d'hôte mysql-full ajoute un nombre importants de checks sur l'hôte. Consommé sans modération, il peut surcharger les Pollers et Schedulers. On lui préférera les modèles d'hôtes plus ciblés présentés par la suite qui sont moins consommateurs de ressources. |
Modèles d'hôtes réservés aux administrateurs Shinken (ne peuvent pas être vus par les autres utilisateurs)
mysql-connection-method
Ce modèle contient les paramètres permettant de se connecter à la base de données MySQL. Par conséquence, tous les modèles du pack MySQL héritent de ce modèle.
mysql-cluster
Ce modèle permet de superviser un cluster MySQL :
| Check | Détails | |
|---|---|---|
| Mysql-cluster-ndbd-running | Vérifie que tous les noeuds du cluster répondent |
mysql-innoDB
Ce modèle permet de récupérer des informations sur les buffers InnoDB et les attentes :
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-bufferpool-hitrate | Ratio d'utilisation du cache dans les pools de buffers InnoDB | 0 à 100% | 99: | BUFFERPOOLHITRATE_WARN | 95: | BUFFERPOOLHITRATE_CRIT |
| Mysql-bufferpool-wait-free | Ratio d'attente des pools de buffer InnoDB | 0 à n/sec | 1 | BUFFERPOOLWAITFREE_WARN | 10 | BUFFERPOOLWAITFREE_CRIT |
| Mysql-log-waits | Attentes de logs InnoDB à cause d'un buffer de logs trop petit | 0 à n/sec | 1 | LOGWAITS_WARN | 10 | LOGWAITS_CRIT |
mysql-MyISAM
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-keycache-hitrate | Ratio d'utilisation du cache de clés MyISAM | 0 à 100% | 99: | KEYCACHEHITRATE_WARN | 95: | KEYCACHEHITRATE_CRIT |
mysql-performance
Ce modèle permet de récupérer des informations sur les performances globales :
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-index-usage | Utilisation des indexes : L'index est l'endroit où la base de données conserves des pointeurs vers les enregistrement depuis une sélection restreinte de champs. Son utilisation accélère les opérations de recherche quand on utilise ces champs restreints, il faut donc que cette utilisation soit au maximum. La valeur retournée par le check index-usage représente la proportion de requêtes qui sont effectuées via ces raccourcis au lieu de parcourir la table en entière (souvent lue depuis le disque si la base est grande). Elle correspond à l'indicateur classique en base de données : le cache hit. Cette valeur devrait normalement être supérieur à 99 % pour une efficacité optimale.
| 0 à 100% | 90: | INDEXUSAGE_WARN | 80: | INDEXUSAGE_CRIT |
| Mysql-long-running-procs | Nombre de processus en exécution depuis plus d'une minute | 0 à n | 10 | LONGRUNNINGPROCS_WARN | 20 | LONGRUNNINGPROCS_CRIT |
| Mysql-table-lock-contention | Ratio d’échec d'obtention de locks sur des tables MySQL | 0 à 100% | 1 | TABLELOCKCONTENTION_WARN | 2 | TABLELOCKCONTENTION_CRIT |
| Mysql-tablecache-hitrate | Ratio d'utilisation du cache des tables | 0 à n | 99: | TABLECACHEHITRATE_WARN | 95: | TABLECACHEHITRATE_CRIT |
| Mysql-threadcache-hitrate | Ratio d'utilisation du cache des threads | 0 à n | 10 | THREADCACHE_WARN | 20 | THREADCACHE_CRIT |
mysql-query-cache
Ce modèle permet de récupérer des informations sur les caches de requêtes :
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-qcache-hitrate | Ratio d'utilisation du cache des requêtes | 0 à 100% | 80: | QCACHEHITRATE_WARN | 90: | QCACHEHITRATE_CRIT |
| Mysql-qcache-lowmem-prunes | Nombre de déplacements hors du cache des requêtes à cause d'un manque de mémoire | 0 à n/sec | 1 | QCACHELOWMEMPRUNES_WARN | 10 | QCACHELOWMEMPRUNES_CRIT |
mysql-usage
Ce modèle permet de récupérer des informations à propos de l'utilisation du serveur MySQL :
| Check | Détails | Seuil avertissement | Donnée du seuil d'avertissement | Seuil critique | Donnée du seuil critique | |
|---|---|---|---|---|---|---|
| Mysql-open-files | Nombre de fichiers ouverts (ratio par rapport à la limite maximum) | 0 à 100% | 80 | OPENFILES_WARN | 95 | OPENFILES_CRIT |
| Mysql-threads-connected | Nombre de connexion actuellement ouvertes | 0 à n | 10 | THREADSCONNECTED_WARN | 20 | THREADSCONNECTED_CRIT |
Comment utiliser les modèles du pack MySQL
Utiliser le modèle d'hôtes voulu sur l'hôte et configurer
Sur l'hôte à configurer, ajouter le modèle MySQL voulu dans la liste des modèles à utiliser.
| Panel |
|---|
|
Dans l'onglet Données, modifier les données pour configurer les seuils et identifiants de connexion à utiliser.
Les différentes données et leur signification sont décrites plus haut dans le récapitulatif de chaque modèle et des checks qu'il contient.
| Panel |
|---|
|
Version des scripts livrés
check_mysql_health : 2.1.8.2
mysql-MyISAM
This template gives informations about MyISAM key cache hitrate.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| keycache-hitrate | MyISAM key cache hitrate | 0 to n | 99: | 95: |
mysql-performance
This template gives informations about the global server performance.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| index_usage | Usage of indexes | 0 to n | 90: | 80: |
| long_running_procs | long running processes | 0 to n | 10 | 20 |
| table_lock_contention | Table lock contention | 0 to n | 1 | 2 |
| tablecache_hitrate | Table cache hitrate | 0 to n | 99: | 95: |
| threadcache_hitrate | Hit rate of the thread-cache | 0 to n | 10 | 20 |
mysql-query-cache
This template gives informations about query cache.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| qcache_hitrate | Query cache hitrate | 0 to n | 90: | 80: |
| qcache_lowmem_prunes | Query cache entries pruned because of low memory | 0 to n | 1 | 10 |
mysql-usage
This template gives informations about MySQL server usage.
| Check | Detail | Check range | Default Warning | Default Critical |
|---|---|---|---|---|
| open_files | Percent of opened files | 0 to n | 80 | 95 |
| threads_connected | Number of currently open connections | 0 to n | 10 | 20 |
How to
Configuration of Mysql-connection-method host template
Click on Hosts then on Hosts Templates in the Elements menu
In the Name field, type mysql-connection.
Then clic on mysql-connection-method
You can setup the following DATA :
You can also set the user and password directly in /etc/shinken/resource.d/myslq.cfg
| Code Block |
|---|
$MYSQLUSER$=shinken
$MYSQLPASSWORD$=shinkenpassword |
Attach a MySQL template to you host
| Clic on Hosts in the Elements menu | |
Add the chosen MySQL host template to the Host Templates to inherit field. For example the MySQL host template. |  |
Click on the Data tab |  |
| Check if the Following data are ok. |  |