- Repository
- Munin (contrib)
- Last change
- 2020-11-26
- Graph Categories
- Family
- contrib
- Capabilities
- Keywords
- Language
- Python (3.x)
- License
- GPL-3.0-only
percona_
Sadly there is no documentation for this plugin.
#!/usr/bin/env python3
#
# Munin plugin for Percona XtraDB Cluster. Monitors values of these cluster replication variables:
# percona_queues: wsrep_local_recv_queue, wsrep_local_send_queue
# percona_flow: wsrep_flow_control_sent, wsrep_flow_control_recv
# percona_transactions: wsrep_replicated, wsrep_received
# percona_transactions_bytes: wsrep_replicated_bytes, wsrep_received_bytes
# percona_replication: wsrep_local_cert_failures, wsrep_local_bf_aborts
#
# created by Sven Schliesing
# borrowed code from mysql_aggregate_ by Igor Borodikhin
#
# License : GPLv3
#
# parsed environment variables:
# host: hostname or ip-address of Mysql server (default - localhost)
# port: port number of Mysql server (default - 3306)
# user: username to access Mysql server (default - empty)
# password: password of Mysql user (default - empty)
#
# ## Requirements
# This plugin requires pythons MySQLdb module which can be installed via easy_install.
#
# ## Installation
# Copy file to directory /usr/share/munin/plugins/ and create symbolic links for each type you wish
# to monitor:
# percona_flow
# percona_queues
# percona_replication
# percona_transactions
# percona_transactions_bytes
#
# Minimal config for monitoring local Percona XtraDB Cluster-Server:
#
# [percona]
# env.user root
# env.password vErYsEcReT
#
# #%# capabilities=autoconf
# #%# family=contrib
import os
import sys
from warnings import filterwarnings
import MySQLdb
import MySQLdb.cursors
filterwarnings('ignore', category=MySQLdb.Warning)
program_name = os.path.basename(__file__)
variables = {
'percona_queues': {
'label': 'Queue sizes',
'vlabel': 'size',
'fields': ['wsrep_local_recv_queue', 'wsrep_local_send_queue']
},
'percona_flow': {
'label': 'Flow control',
'vlabel': '',
'fields': ['wsrep_flow_control_sent', 'wsrep_flow_control_recv']
},
'percona_transactions': {
'label': 'Transactions in and out',
'vlabel': 'transactions',
'fields': ['wsrep_replicated', 'wsrep_received']
},
'percona_transactions_bytes': {
'label': 'Transactions in and out in bytes',
'vlabel': 'bytes',
'fields': ['wsrep_replicated_bytes', 'wsrep_received_bytes']
},
'percona_replication': {
'label': 'Replication conflicts',
'vlabel': 'conflicts',
'fields': ['wsrep_local_cert_failures', 'wsrep_local_bf_aborts'],
}
}
# Parse environment variables
# Mysql host
if "host" in os.environ and os.environ["host"] is not None:
server = os.environ["host"]
else:
server = "localhost"
# Mysql port
if "port" in os.environ and os.environ["port"] is not None:
try:
port = int(os.environ["port"])
except ValueError:
port = 3306
else:
port = 3306
# Mysql username
if "user" in os.environ and os.environ["user"] is not None:
login = os.environ["user"]
else:
login = ""
# Mysql password
if "password" in os.environ and os.environ["password"] is not None:
passw = os.environ["password"]
else:
passw = ""
# Mysql connection handler
conn = None
label = variables[program_name]['label']
vlabel = variables[program_name]['vlabel']
fields = ["'{0}'".format(x) for x in variables[program_name]['fields']]
query = "show status where Variable_name in (%s)" % ', '.join(fields)
# Connect to mysql
try:
conn = MySQLdb.connect(host=server, user=login, passwd=passw)
cursor = conn.cursor()
except MySQLdb.Error as e:
print("Error %d: %s" % (e.args[0], e.args[1]))
sys.exit(1)
values = {}
if len(sys.argv) == 2 and sys.argv[1] == "autoconf":
print("yes")
elif len(sys.argv) == 2 and sys.argv[1] == "config":
print("graph_title %s" % label)
print("graph_vlabel %s" % vlabel)
print("graph_category db")
print()
try:
cursor.execute(query)
results = cursor.fetchall()
for result in results:
print("%s_size.label %s" % (result[0], result[0]))
except MySQLdb.Error as e:
print("Error %d: %s" % (e.args[0], e.args[1]))
else:
try:
cursor.execute(query)
results = cursor.fetchall()
for result in results:
print("%s_size.value %s" % (result[0], result[1]))
except MySQLdb.Error as e:
print("Error %d: %s" % (e.args[0], e.args[1]))
if conn:
conn.close()